API ارزدیجیتال
Englishورودثبت‌نام
API ارزدیجیتال

جفت‌ارزها

فهرست پرمعامله‌ترین جفت‌ارز هر صرافی

GEThttps://api.arzdigital.com/v1/pairs/top
X-API-Key در هدراعتبار چطور کار می‌کند

برای دارایی پایه یا مظنه‌ای که مشخص می‌کنید، پرمعامله‌ترین جفت‌ارز هر صرافی را برمی‌گرداند. دست‌کم یکی از base، quote، base_symbol یا quote_symbol را بفرستید؛ در غیر این صورت خطای ۱۰۰۱ برمی‌گردد. با provider_kind=gold_platform برای هر پلتفرم طلا یک جفت‌ارز برمی‌گردد، به ترتیب امتیاز اعتماد از بیشترین، و نام پلتفرم در source.exchange می‌آید.

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

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

پارامترها

  • limitintegerکوئری
    تعداد ردیف در هر صفحه.
    پیش‌فرض: 100محدوده: 1 – 1000
  • offsetintegerکوئری
    تعداد ردیف‌هایی که از ابتدا رد می‌شوند.
    پیش‌فرض: 0محدوده: 0 – …
  • 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
    یکی از پارامترها جا افتاده، قالبش درست نیست یا خارج از محدوده است.

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