Garant Exchange

Публічны 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>

🧩 Віджэт курсаў для сайта

Гатовы блок з лепшымі курсамі і кнопкай абмену для вашага сайта, блога або канала. Устаўце код у 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=be" 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