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=ky" 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'да ачуу