Açıq API
Məzənnələr, elanlar və qarantın ehtiyatları JSON formatında — məzənnə aqreqatorları, monitorinqlər və tərəfdaş saytlar üçün. Açar və qeydiyyat lazım deyil, yalnız oxumaq.
🔌 Necə qoşulmaq olar
Aşağıdakı ünvana adi GET sorğuları; cavab — UTF-8 kodlu JSON. Açar və qeydiyyat lazım deyil.
https://garantp2p.com/public/v1/⏱ Limitlər
Cavablar 30 saniyə keşlənir, ona görə də tez-tez soruşmağın mənası yoxdur. Bir IP-dən dəqiqədə 60 sorğuya qədər; artıq olduqda cavab 429. Brauzerdən istənilən saytdan sorğuya icazə var (CORS).
🔢 Məlumat formatı
Qiymətlər və limitlər — bazarın valyutasında bir tam koin üçün sətir, məsələn "12700" və ya "85.5". Vaxt — Unix saniyələri. Dəyər yoxdursa — null.
GET /public/v1/markets
Açıq bazarlar: valyuta, koinlər, ödəniş üsulları, bir əqdin limitləri və qarant yeni əqdləri müvəqqəti dayandırıbsa — fasilə.
Sorğu
GET https://garantp2p.com/public/v1/marketsCavab nümunəsi
{
"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
Bazarın hər koini üzrə xülasə: ən yaxşı alış qiyməti (buy — ən ucuz satıcı) və satış qiyməti (sell — ən çox ödəyən alıcı), medianlar, elanların sayı və rəsmi məzənnə.
Parametrlər
country— bazar kodu: uz, kz, kg, tj, tm, az, am, by, md, ru. Standart uz.
Sorğu
GET https://garantp2p.com/public/v1/prices?country=uzCavab nümunəsi
{
"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
Hazırda götürülə bilən 50 elana qədər, ən yaxşı qiymətlər birinci: qiymət, limitlər, ödəniş üsulları, bank, treyderin reputasiyası və elanı botda açan link.
Parametrlər
country— bazar kodu: uz, kz, kg, tj, tm, az, am, by, md, ru. Standart uz.side— sell — satıcılar (onlardan alırsınız), buy — alıcılar (onlara satırsınız). Standart sell.coin— koin, məsələn usdt_trc20; parametrsiz — bazarın bütün koinləri. Koin kodları /markets-dədir.
Sorğu
GET https://garantp2p.com/public/v1/offers?country=uz&side=sell&coin=usdt_trc20Cavab nümunəsi
{
"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
Qarantın pul kisələri və balansları, son tamamlanmış əqdlər, mübahisələrin nəticələri və treyderlərin girovu — «Şəffaflıq» səhifəsindəki kimi.
Sorğu
GET https://garantp2p.com/public/v1/transparencyCavab nümunəsi
{
"wallets": [
"…"
],
"feed": [
"…"
],
"disputes": {
"…": "…"
},
"collateral": {
"traders": 12,
"total": "6000",
"paid_count": 0,
"paid": "0"
},
"fund": null
}GET /public/v1/rates.xml
Hər koin, ödəniş sistemi və istiqamət üzrə ən yaxşı elanlar mübadilə monitorinqləri üçün ixrac formatında (BestChange XML): from — müştərinin verdiyi, to — aldığı, amount — ehtiyat, minamount və maxamount — from valyutasında sövdələşmə limitləri. Qarantın komissiyası artıq kursa daxildir, şəbəkə haqqı tofee-də göstərilir. Fayl hər sorğuda yenidən yığılır, limit — bir IP-dən dəqiqədə 600 sorğu.
Valyuta kodları BestChange siyahısındandır: koinlər USDTTRC20, USDTBEP20, USDTTON, BTC, USDCSOL; kartlar UZCUZS (Uzcard), HUMOUZS (Humo), KSPBKZT (Kaspi), CARDUZS (Visa/Mastercard). Bu siyahıda olmayan ödəniş üsulları fayla düşmür.
Sorğu
GET https://garantp2p.com/public/v1/rates.xmlCavab nümunəsi
<?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>⚠️ Xətalar
400 bad_country — belə bazar yoxdur və ya bağlıdır; 400 bad_request — side və ya coin səhvdir; 429 slow_down — sorğular həddindən artıq çoxdur.
📄 İstifadə şərtləri
Məlumatlar arayış xarakterlidir və hər dəqiqə dəyişir; əqd yalnız botda elandakı qiymətlə bağlanır. Məlumatları öz saytınızda göstərsəniz, mənbəni garantp2p.com linki ilə göstərin. Kart nömrələri, pul kisələri və treyderlərin əlaqələri API-də yoxdur və olmayacaq.
Mübadiləyə bir dəqiqədə başlayın
Botu açın, dili və ölkəni seçin və dərhal elanlara keçin.
✈️ Telegram-da aç