Garant Exchange

Ашық 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>

🧩 Сайтқа арналған бағам виджеті

Сайтыңызға, блогыңызға немесе арнаңызға ең жақсы бағамдар мен айырбас батырмасы бар дайын блок. Кодты беттің HTML-іне қойыңыз — бағамдар өздігінен жаңарады, кілт қажет емес.

Параметрлер

  • country — нарық коды: uz, kz, kg, tj, tm, az, am, by, md, ru. Әдепкі мәні uz.
  • lang — виджет тілі: ru, en, uz және сайттың басқа тілдері. Әдепкі — келушінің браузер тілі.
  • coin — монета, мысалы usdt_trc20; параметрсіз — нарықтың барлық монеталары. Монета кодтары /markets ішінде.
  • ref — серіктестік бағдарламадағы Telegram ID-іңіз: батырма ботты сіздің сілтемеңізбен ашады, ал сіз шақырғандарыңыздан комиссия үлесін аласыз. ID-іңіз бар дайын код — Mini App-та: Профиль → Серіктестік бағдарлама.
  • theme — light — ашық тақырып. Әдепкі бойынша қараңғы.
<iframe src="https://garantp2p.com/widget?country=uz&lang=kk" width="360" height="260" loading="lazy" title="Garant Exchange" style="border:0;max-width:100%"></iframe>

⚠️ Қателер

400 bad_country — мұндай нарық жоқ немесе жабық; 400 bad_request — side немесе coin қате; 429 slow_down — сұраулар тым көп.

📄 Пайдалану шарттары

Деректер анықтамалық және әр минут сайын өзгереді; мәміле тек ботта хабарландырудағы баға бойынша жасалады. Деректерді өз сайтыңызда көрсетсеңіз, дереккөзді garantp2p.com сілтемесімен көрсетіңіз. Карта нөмірлері, әмияндар және трейдерлердің байланыстары API-де жоқ және болмайды.

Айырбасты бір минутта бастаңыз

Ботты ашып, тіл мен елді таңдаңыз да, бірден хабарландыруларға өтіңіз.

✈️ Telegram-да ашу