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=tg" 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