Публічны API
Курсы, аб'явы і рэзервы гаранта ў JSON — для агрэгатараў курсаў, маніторынгаў і сайтаў партнёраў. Без ключа і рэгістрацыі, толькі чытанне.
🔌 Як падключыцца
Звычайныя GET-запыты да адраса ніжэй, адказ — JSON у UTF-8. Ключ і рэгістрацыя не патрэбныя.
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. Файл збіраецца нанава пры кожным запыце, ліміт — 600 запытаў у хвіліну з аднаго IP.
Коды валют — са спісу 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