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=hy" 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-ում