Ашық API
Бағамдар, хабарландырулар және кепілгер резервтері JSON форматында — бағам агрегаторлары, мониторингтер және серіктес сайттар үшін. Кілт пен тіркелу қажет емес, тек оқу.
🔌 Қалай қосылуға болады
Төмендегі мекенжайға қарапайым GET сұраулары; жауап — UTF-8 кодындағы JSON. Кілт пен тіркелу қажет емес.
https://garantp2p.com/public/v1/⏱ Шектеулер
Жауаптар 30 секундқа кэштеледі, сондықтан жиірек сұраудың мағынасы жоқ. Бір IP-ден минутына 60 сұрауға дейін; одан асса жауап 429. Браузерден кез келген сайттан сұрауға рұқсат (CORS).
🔢 Деректер форматы
Бағалар мен лимиттер — нарық валютасындағы бір бүтін монетаның бағасы, жол түрінде, мысалы "12700" немесе "85.5". Уақыт — Unix секундтары. Мән жоқ болса — null.
GET /public/v1/markets
Ашық нарықтар: валюта, монеталар, төлем тәсілдері, бір мәміленің лимиттері және кепілгер жаңа мәмілелерді уақытша тоқтатса — үзіліс.
Сұрау
GET https://garantp2p.com/public/v1/marketsЖауап үлгісі
{
"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
Нарықтың әр монетасы бойынша жиынтық: ең жақсы сатып алу бағасы (buy — ең арзан сатушы) және сату бағасы (sell — ең көп төлейтін сатып алушы), медианалар, хабарландырулар саны және ресми бағам.
Параметрлер
country— нарық коды: uz, kz, kg, tj, tm, az, am, by, md, ru. Әдепкі мәні uz.
Сұрау
GET https://garantp2p.com/public/v1/prices?country=uzЖауап үлгісі
{
"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
Дәл қазір алуға болатын 50 хабарландыруға дейін, ең жақсы бағалар алдымен: баға, лимиттер, төлем тәсілдері, банк, трейдердің беделі және хабарландыруды ботта ашатын сілтеме.
Параметрлер
country— нарық коды: uz, kz, kg, tj, tm, az, am, by, md, ru. Әдепкі мәні uz.side— sell — сатушылар (олардан сатып аласыз), buy — сатып алушылар (оларға сатасыз). Әдепкі мәні sell.coin— монета, мысалы usdt_trc20; параметрсіз — нарықтың барлық монеталары. Монета кодтары /markets ішінде.
Сұрау
GET https://garantp2p.com/public/v1/offers?country=uz&side=sell&coin=usdt_trc20Жауап үлгісі
{
"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
Кепілгердің әмияндары мен балансы, соңғы аяқталған мәмілелер, даулардың нәтижелері және трейдерлердің кепілі — «Ашықтық» бетіндегімен бірдей.
Сұрау
GET https://garantp2p.com/public/v1/transparencyЖауап үлгісі
{
"wallets": [
"…"
],
"feed": [
"…"
],
"disputes": {
"…": "…"
},
"collateral": {
"traders": 12,
"total": "6000",
"paid_count": 0,
"paid": "0"
},
"fund": null
}GET /public/v1/rates.xml
Әр монета, төлем жүйесі және бағыт бойынша үздік хабарландырулар айырбастау мониторингтеріне арналған экспорт пішімінде (BestChange XML): from — клиент не береді, to — не алады, amount — резерв, minamount пен maxamount — from валютасындағы мәміле лимиттері. Гарант комиссиясы бағамға енгізілген, желі комиссиясы tofee ішінде көрсетілген. Файл әр сұраныста қайта жиналады, лимит — бір IP-ден минутына 600 сұраныс.
Валюта кодтары BestChange тізімінен: монеталар USDTTRC20, USDTBEP20, USDTTON, BTC, USDCSOL; карталар UZCUZS (Uzcard), HUMOUZS (Humo), KSPBKZT (Kaspi), CARDUZS (Visa/Mastercard). Бұл тізімде жоқ төлем тәсілдері файлға кірмейді.
Сұрау
GET https://garantp2p.com/public/v1/rates.xmlЖауап үлгісі
<?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>⚠️ Қателер
400 bad_country — мұндай нарық жоқ немесе жабық; 400 bad_request — side немесе coin қате; 429 slow_down — сұраулар тым көп.
📄 Пайдалану шарттары
Деректер анықтамалық және әр минут сайын өзгереді; мәміле тек ботта хабарландырудағы баға бойынша жасалады. Деректерді өз сайтыңызда көрсетсеңіз, дереккөзді garantp2p.com сілтемесімен көрсетіңіз. Карта нөмірлері, әмияндар және трейдерлердің байланыстары API-де жоқ және болмайды.
Айырбасты бір минутта бастаңыз
Ботты ашып, тіл мен елді таңдаңыз да, бірден хабарландыруларға өтіңіз.
✈️ Telegram-да ашу