جفت‌ارزها

فهرست جفت‌ارزها

GEThttps://api.arzdigital.com/v1/pairs

X-API-Key در هدراعتبار چطور کار می‌کند

مصرف اعتبار: هر درخواست موفق به ازای هر ۱۰۰ ردیف که برمی‌گرداند ۱ اعتبار مصرف می‌کند و عدد به بالا گرد می‌شود. مثلاً ۲۵۰ ردیف برابر ۳ اعتبار است.

پاسخ خالی و هر نوع خطا هزینه‌ای ندارد.

GET/v1/pairs

curl -sS "https://api.arzdigital.com/v1/pairs?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

نمونه پاسخ200

{
  "status": "success",
  "meta": {
    "count": 1
  },
  "data": [
    {
      "contract_type": "spot",
      "name": "BTC/USDT",
      "deprecated": false,
      "base": {
        "slug": "bitcoin",
        "symbol": "BTC",
        "name": "Bitcoin",
        "type": "coin",
        "verified": true,
        "color": "#f9a641",
        "deprecated": false,
        "logo_url": "https://cdn.arz.digital/cr-odin/img/assets/bitcoin/64x64.png",
        "exchange_symbol": "BTC"
      },
      "quote": {
        "slug": "tether",
        "symbol": "USDT",
        "name": "Tether USDt",
        "type": "coin",
        "verified": true,
        "color": "#33a8a8",
        "deprecated": false,
        "logo_url": "https://cdn.arz.digital/cr-odin/img/assets/tether/64x64.png",
        "exchange_symbol": "USDT"
      }
    }
  ]
}

این کدها را از سرور خود اجرا کنید. API هدر CORS نمی‌فرستد، پس مرورگر جلوی درخواست را می‌گیرد.

پارامترها

limitintegerکوئری
تعداد ردیف در هر صفحه.
پیش‌فرض: 100محدوده: 1 – 1000
offsetintegerکوئری
تعداد ردیف‌هایی که از ابتدا رد می‌شوند.
پیش‌فرض: 0محدوده: 0 – …
sortstringکوئری
id_ascid_desccreated_at_asccreated_at_descupdated_at_ascupdated_at_desc
contract_typestringکوئری
spototcfuturesperpetualoptionsindexdex
searchstringکوئری
namestringکوئری
exchangestringکوئری
اسلاگ صرافی.
exchange_countrystringکوئری
basestringکوئری
اسلاگ دارایی پایه.
quotestringکوئری
اسلاگ دارایی مظنه.
base_symbolstringکوئری
quote_symbolstringکوئری
base_exchange_symbolstringکوئری
quote_exchange_symbolstringکوئری
financial_providerstringکوئری
provider_kindstringکوئری
currency_exchangegold_platform
deprecatedbooleanکوئری

هدرهای درخواست

X-API-Keystringالزامی
کلید API شما. آن را در هر درخواست در این هدر بفرستید. کلید در نشانی درخواست پذیرفته نمی‌شود.

پاسخ

یک صفحه از جفت‌ارزها.

فیلدهای پاسخ (59)

statusstring
metaobject
اگر count نیامده باشد، سرویس داده تعداد ردیف‌های برگشتی را گزارش نکرده است.
meta.countinteger
تعداد ردیف‌هایی که هزینه این درخواست بر اساس آن حساب شده، یعنی طول data.
dataarray
data[].contract_typestring
data[].namestring
data[].deprecatedboolean
data[].trading_urlstring
data[].baseobject
data[].base.slugstring
data[].base.symbolstring
data[].base.namestring
data[].base.typestring
data[].base.verifiedboolean
data[].base.colorstring | null
data[].base.deprecatedboolean
data[].base.logo_urlstring | null
data[].base.exchange_symbolstring
نمادی که در خود صرافی به کار می‌رود.
data[].quoteobject
data[].quote.slugstring
data[].quote.symbolstring
data[].quote.namestring
data[].quote.typestring
data[].quote.verifiedboolean
data[].quote.colorstring | null
data[].quote.deprecatedboolean
data[].quote.logo_urlstring | null
data[].quote.exchange_symbolstring
نمادی که در خود صرافی به کار می‌رود.
data[].pricenumber
data[].price_irtnumber
data[].price_in_quotenumber
data[].buy_fee_percentnumber | null
data[].sell_fee_percentnumber | null
data[].sourceobject
محل معامله جفت‌ارز. فقط در جفت‌ارزهای برتر پلتفرم‌های طلا می‌آید و پلتفرم در exchange است.
data[].source.slugstring
data[].source.namestring
data[].source.deprecatedboolean
data[].source.exchangeobject
data[].source.exchange.slugstring
data[].source.exchange.namestring
data[].source.exchange.fa_namestring | null
data[].source.exchange.colorstring | null
data[].source.exchange.deprecatedboolean
data[].source.exchange.logo_urlstring | null
data[].source.exchange.trust_scorenumber | null
data[].source.exchange.metaobject
data[].source.exchange.meta.descriptionstring | null
data[].source.exchange.meta.statusstring | null
data[].source.exchange.meta.countrystring | null
data[].source.exchange.meta.citystring | null
data[].source.exchange.meta.rankinteger | null
data[].source.exchange.meta.trust_scorenumber | null
data[].source.exchange.meta.license_statusstring | null
data[].source.exchange.meta.custody_modelstring | null
data[].source.exchange.meta.physical_redemption_statusstring | null
data[].source.exchange.meta.requires_kycboolean | null
data[].source.exchange.meta.buy_fee_percentnumber | null
data[].source.exchange.meta.sell_fee_percentnumber | null
data[].source.exchange.meta.linksobject

هدرهای پاسخ

X-Credits-Charged
اعتباری که این درخواست مصرف کرد. برای هر پاسخی غیر از ۲۰۰، مقدارش 0 است.
X-Credits-Remaining
موجودی حساب پس از این درخواست، بدون احتساب اعتباری که درخواست‌های هنوز در حال اجرا کنار گذاشته‌اند. فقط وقتی منفی است که حساب پس از یک اصلاح دستی بدهکار باشد.
X-RateLimit-Limit
تعداد درخواست مجاز این کلید در هر دقیقه.
X-RateLimit-Remaining
تعداد درخواستی که در بازه فعلی باقی مانده است.
X-RateLimit-Reset
زمانی که دوباره جا برای درخواست باز می‌شود، به ثانیه یونیکس.

خطاها

bad_requesterror_code 1001
یکی از پارامترها جا افتاده، قالبش درست نیست یا خارج از محدوده است.

خطاها هیچ‌وقت هزینه ندارند. خطاها