Garant Exchange

API public

Cursuri, anunțuri și rezervele garantului în JSON — pentru agregatoare de cursuri, monitorizări și site-uri partenere. Fără cheie și fără înregistrare, doar citire.

🔌 Cum vă conectați

Cereri GET simple la adresa de mai jos; răspunsul este JSON în UTF-8. Nu e nevoie de cheie sau înregistrare.

https://garantp2p.com/public/v1/

⏱ Limite

Răspunsurile sunt păstrate în cache 30 s, așa că nu are rost să cereți mai des. De pe un IP — până la 60 cereri pe minut; peste atât răspunsul este 429. Cererile din browser sunt permise de pe orice site (CORS).

🔢 Formatul datelor

Prețurile și limitele sunt șiruri în moneda pieței pentru o monedă întreagă, de exemplu "12700" sau "85.5". Timpul — secunde Unix. O valoare lipsă este null.

GET /public/v1/markets

Piețele deschise: moneda, criptomonedele, metodele de plată, limitele unei tranzacții și pauza, dacă garantul a oprit temporar tranzacțiile noi.

Cerere

GET https://garantp2p.com/public/v1/markets

Exemplu de răspuns

{
  "coins": [
    {
      "key": "usdt_trc20",
      "symbol": "USDT",
      "network": "TRC20"
    },
    {
      "key": "usdt_bep20",
      "symbol": "USDT",
      "network": "BEP20"
    }
  ],
  "markets": [
    {
      "country": "uz",
      "currency": "UZS",
      "coins": [
        "usdt_trc20",
        "usdt_bep20"
      ],
      "methods": [
        {
          "key": "uzcard",
          "name": "Uzcard"
        },
        {
          "key": "humo",
          "name": "Humo"
        }
      ],
      "min_deal": "50000",
      "max_deal": "50000000",
      "paused": false,
      "paused_coins": []
    }
  ]
}

GET /public/v1/prices

Un rezumat pe fiecare criptomonedă a pieței: cel mai bun preț de cumpărare (buy — cel mai ieftin vânzător) și de vânzare (sell — cumpărătorul care plătește cel mai mult), mediane, numărul de anunțuri și cursul oficial.

Parametri

  • country — codul pieței: uz, kz, kg, tj, tm, az, am, by, md, ru. Implicit uz.

Cerere

GET https://garantp2p.com/public/v1/prices?country=uz

Exemplu de răspuns

{
  "country": "uz",
  "currency": "UZS",
  "updated": 1790000000,
  "coins": {
    "usdt_trc20": {
      "buy": "12700",
      "sell": "12550",
      "buy_median": "12750",
      "sell_median": "12500",
      "sellers": 14,
      "buyers": 6,
      "official": "12620"
    }
  }
}

GET /public/v1/offers

Până la 50 anunțuri care pot fi luate chiar acum, cele mai bune prețuri primele: preț, limite, metode de plată, bancă, reputația traderului și un link care deschide anunțul în bot.

Parametri

  • country — codul pieței: uz, kz, kg, tj, tm, az, am, by, md, ru. Implicit uz.
  • side — sell — vânzători (cumpărați de la ei), buy — cumpărători (le vindeți). Implicit sell.
  • coin — criptomoneda, de exemplu usdt_trc20; fără parametru — toate criptomonedele pieței. Codurile sunt în /markets.

Cerere

GET https://garantp2p.com/public/v1/offers?country=uz&side=sell&coin=usdt_trc20

Exemplu de răspuns

{
  "country": "uz",
  "side": "sell",
  "coin": "usdt_trc20",
  "updated": 1790000000,
  "offers": [
    {
      "id": 128,
      "side": "sell",
      "coin": "usdt_trc20",
      "country": "uz",
      "currency": "UZS",
      "price": "12700",
      "min": "200000",
      "max": "5000000",
      "methods": [
        {
          "key": "uzcard",
          "name": "Uzcard"
        }
      ],
      "bank": null,
      "trader": {
        "name": "Aziz",
        "level": "pro",
        "deals": 57,
        "rating": 4.9,
        "completion": 98,
        "verified": true,
        "kyc": true,
        "collateral_usd": 500
      },
      "url": "https://t.me/garant_p2p_exchange_bot?start=offer_128"
    }
  ]
}

GET /public/v1/transparency

Portofelele garantului cu solduri, ultimele tranzacții finalizate, rezultatele disputelor și garanțiile traderilor — la fel ca pe pagina «Transparență».

Cerere

GET https://garantp2p.com/public/v1/transparency

Exemplu de răspuns

{
  "wallets": [
    "…"
  ],
  "feed": [
    "…"
  ],
  "disputes": {
    "…": "…"
  },
  "collateral": {
    "traders": 12,
    "total": "6000",
    "paid_count": 0,
    "paid": "0"
  },
  "fund": null
}

GET /public/v1/rates.xml

Cele mai bune anunțuri pentru fiecare monedă, sistem de plată și direcție, în formatul de export al monitoarelor de schimb (BestChange XML): from — ce dă clientul, to — ce primește, amount — rezerva, minamount și maxamount — limitele tranzacției în moneda from. Comisionul garantului este deja inclus în curs, taxa de rețea este dată în tofee. Fișierul se generează din nou la fiecare cerere; limita este de 600 de cereri pe minut de pe un IP.

Codurile valutelor urmează lista BestChange: monede USDTTRC20, USDTBEP20, USDTTON, BTC, USDCSOL; carduri UZCUZS (Uzcard), HUMOUZS (Humo), KSPBKZT (Kaspi), CARDUZS (Visa/Mastercard). Metodele de plată care lipsesc din listă nu intră în fișier.

Cerere

GET https://garantp2p.com/public/v1/rates.xml

Exemplu de răspuns

<?xml version="1.0" encoding="UTF-8"?>
<rates>
<item><from>HUMOUZS</from><to>USDTTRC20</to><in>12828.282829</in><out>1</out><amount>8450.5</amount><minamount>200000</minamount><maxamount>5000000</maxamount><tofee>2.5</tofee><param>manual, reg</param></item>
<item><from>USDTTRC20</from><to>HUMOUZS</to><in>1</in><out>12550</out><amount>36000000</amount><minamount>15.936255</minamount><maxamount>398.406374</maxamount><param>manual, reg</param></item>
</rates>

🧩 Widget de cursuri pentru site

Un bloc gata făcut cu cele mai bune cursuri și un buton de schimb pentru site-ul, blogul sau canalul dvs. Inserați codul în HTML-ul paginii — cursurile se actualizează singure, nu e nevoie de cheie.

Parametri

  • country — codul pieței: uz, kz, kg, tj, tm, az, am, by, md, ru. Implicit uz.
  • lang — limba widgetului: ru, en, uz și celelalte limbi ale site-ului. Implicit — limba browserului vizitatorului.
  • coin — criptomoneda, de exemplu usdt_trc20; fără parametru — toate criptomonedele pieței. Codurile sunt în /markets.
  • ref — ID-ul dvs. Telegram din programul de parteneriat: butonul deschide botul cu linkul dvs., iar dvs. primiți o parte din comision de la cei invitați. Codul gata făcut cu ID-ul dvs. este în Mini App: Profil → Program de parteneriat.
  • theme — light — temă deschisă. Implicit întunecată.
<iframe src="https://garantp2p.com/widget?country=uz&lang=ro" width="360" height="260" loading="lazy" title="Garant Exchange" style="border:0;max-width:100%"></iframe>

⚠️ Erori

400 bad_country — nu există o astfel de piață sau este închisă; 400 bad_request — side sau coin greșit; 429 slow_down — prea multe cereri.

📄 Condiții de utilizare

Datele sunt orientative și se schimbă în fiecare minut; tranzacția se încheie doar în bot, la prețul din anunț. Când afișați datele pe site-ul dvs., indicați sursa cu un link către garantp2p.com. Numerele de card, portofelele și contactele traderilor nu sunt în API și nu vor fi.

Începeți schimbul într-un minut

Deschideți botul, alegeți limba și țara și treceți direct la anunțuri.

✈️ Deschideți în Telegram