Garant Exchange

Açıq API

Məzənnələr, elanlar və qarantın ehtiyatları JSON formatında — məzənnə aqreqatorları, monitorinqlər və tərəfdaş saytlar üçün. Açar və qeydiyyat lazım deyil, yalnız oxumaq.

🔌 Necə qoşulmaq olar

Aşağıdakı ünvana adi GET sorğuları; cavab — UTF-8 kodlu JSON. Açar və qeydiyyat lazım deyil.

https://garantp2p.com/public/v1/

⏱ Limitlər

Cavablar 30 saniyə keşlənir, ona görə də tez-tez soruşmağın mənası yoxdur. Bir IP-dən dəqiqədə 60 sorğuya qədər; artıq olduqda cavab 429. Brauzerdən istənilən saytdan sorğuya icazə var (CORS).

🔢 Məlumat formatı

Qiymətlər və limitlər — bazarın valyutasında bir tam koin üçün sətir, məsələn "12700" və ya "85.5". Vaxt — Unix saniyələri. Dəyər yoxdursa — null.

GET /public/v1/markets

Açıq bazarlar: valyuta, koinlər, ödəniş üsulları, bir əqdin limitləri və qarant yeni əqdləri müvəqqəti dayandırıbsa — fasilə.

Sorğu

GET https://garantp2p.com/public/v1/markets

Cavab nümunəsi

{
  "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

Bazarın hər koini üzrə xülasə: ən yaxşı alış qiyməti (buy — ən ucuz satıcı) və satış qiyməti (sell — ən çox ödəyən alıcı), medianlar, elanların sayı və rəsmi məzənnə.

Parametrlər

  • country — bazar kodu: uz, kz, kg, tj, tm, az, am, by, md, ru. Standart uz.

Sorğu

GET https://garantp2p.com/public/v1/prices?country=uz

Cavab nümunəsi

{
  "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

Hazırda götürülə bilən 50 elana qədər, ən yaxşı qiymətlər birinci: qiymət, limitlər, ödəniş üsulları, bank, treyderin reputasiyası və elanı botda açan link.

Parametrlər

  • country — bazar kodu: uz, kz, kg, tj, tm, az, am, by, md, ru. Standart uz.
  • side — sell — satıcılar (onlardan alırsınız), buy — alıcılar (onlara satırsınız). Standart sell.
  • coin — koin, məsələn usdt_trc20; parametrsiz — bazarın bütün koinləri. Koin kodları /markets-dədir.

Sorğu

GET https://garantp2p.com/public/v1/offers?country=uz&side=sell&coin=usdt_trc20

Cavab nümunəsi

{
  "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

Qarantın pul kisələri və balansları, son tamamlanmış əqdlər, mübahisələrin nəticələri və treyderlərin girovu — «Şəffaflıq» səhifəsindəki kimi.

Sorğu

GET https://garantp2p.com/public/v1/transparency

Cavab nümunəsi

{
  "wallets": [
    "…"
  ],
  "feed": [
    "…"
  ],
  "disputes": {
    "…": "…"
  },
  "collateral": {
    "traders": 12,
    "total": "6000",
    "paid_count": 0,
    "paid": "0"
  },
  "fund": null
}

GET /public/v1/rates.xml

Hər koin, ödəniş sistemi və istiqamət üzrə ən yaxşı elanlar mübadilə monitorinqləri üçün ixrac formatında (BestChange XML): from — müştərinin verdiyi, to — aldığı, amount — ehtiyat, minamount və maxamount — from valyutasında sövdələşmə limitləri. Qarantın komissiyası artıq kursa daxildir, şəbəkə haqqı tofee-də göstərilir. Fayl hər sorğuda yenidən yığılır, limit — bir IP-dən dəqiqədə 600 sorğu.

Valyuta kodları BestChange siyahısındandır: koinlər USDTTRC20, USDTBEP20, USDTTON, BTC, USDCSOL; kartlar UZCUZS (Uzcard), HUMOUZS (Humo), KSPBKZT (Kaspi), CARDUZS (Visa/Mastercard). Bu siyahıda olmayan ödəniş üsulları fayla düşmür.

Sorğu

GET https://garantp2p.com/public/v1/rates.xml

Cavab nümunəsi

<?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>

🧩 Sayt üçün məzənnə vidjeti

Saytınız, bloqunuz və ya kanalınız üçün ən yaxşı məzənnələr və mübadilə düyməsi olan hazır blok. Kodu səhifənin HTML-inə yerləşdirin — məzənnələr özü yenilənir, açar lazım deyil.

Parametrlər

  • country — bazar kodu: uz, kz, kg, tj, tm, az, am, by, md, ru. Standart uz.
  • lang — vidjetin dili: ru, en, uz və saytın digər dilləri. Standart — ziyarətçinin brauzer dili.
  • coin — koin, məsələn usdt_trc20; parametrsiz — bazarın bütün koinləri. Koin kodları /markets-dədir.
  • ref — tərəfdaşlıq proqramındakı Telegram ID-niz: düymə botu sizin linkinizlə açır və siz dəvət etdiklərinizdən komissiya payı alırsınız. ID-nizlə hazır kod — Mini App-da: Profil → Tərəfdaşlıq proqramı.
  • theme — light — açıq mövzu. Standart olaraq tünd.
<iframe src="https://garantp2p.com/widget?country=uz&lang=az" width="360" height="260" loading="lazy" title="Garant Exchange" style="border:0;max-width:100%"></iframe>

⚠️ Xətalar

400 bad_country — belə bazar yoxdur və ya bağlıdır; 400 bad_request — side və ya coin səhvdir; 429 slow_down — sorğular həddindən artıq çoxdur.

📄 İstifadə şərtləri

Məlumatlar arayış xarakterlidir və hər dəqiqə dəyişir; əqd yalnız botda elandakı qiymətlə bağlanır. Məlumatları öz saytınızda göstərsəniz, mənbəni garantp2p.com linki ilə göstərin. Kart nömrələri, pul kisələri və treyderlərin əlaqələri API-də yoxdur və olmayacaq.

Mübadiləyə bir dəqiqədə başlayın

Botu açın, dili və ölkəni seçin və dərhal elanlara keçin.

✈️ Telegram-da aç