Ачык 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'да ачуу