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/marketsExemplu 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=uzExemplu 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_trc20Exemplu 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/transparencyExemplu 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.xmlExemplu 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>⚠️ 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