قائمة العملات
عملات مرتّبة مع الأسعار وعوامل الترشيح والمحدِّدات، مقسّمة إلى صفحات بغلاف Laravel
links + meta. السعر وcirculating_supply قيم عشرية نصّية؛
أما marketcap وvolume_24h والتغيّرات والترتيب فهي أرقام.
المفاتيح من نوع Bearer فقط وتحمل صلاحية data-api - احتفظ بها على الخادم.
معاملات الاستعلام
page
رقم الصفحة (يبدأ من 1). يجب ألا يقل عن 1.
per_page
عدد الصفوف في الصفحة. الحد الأقصى يعتمد على الباقة (Free 100، Starter/Pro 250)؛ وتجاوزه يُعيد 422 بدلاً من التقليص إلى الحد. يجب ألا يقل عن 1. يجب ألا يزيد عن 100.
type
التقييد بنوع أصل واحد: عملة أو توكن.
أحد الخيارات:
coin
token
status
حالة الإدراج: active أو delisted أو untracked أو progressing أو awaiting أو preparing. القيمة الافتراضية هي جميع الحالات العامة.
أحد الخيارات:
active
delisted
untracked
progressing
awaiting
preparing
search
مطابقة نص حر على الاسم أو الرمز. يجب ألا يتجاوز 100 حرف.
min_price
يقتصر على العملات التي يساوي سعرها هذه القيمة بالدولار الأمريكي أو يتجاوزها. يجب ألا تقل عن 0.
max_price
يقتصر على العملات التي يساوي سعرها هذه القيمة بالدولار الأمريكي أو يقل عنها. يجب ألا تقل عن 0.
min_marketcap
يقتصر على العملات التي تساوي قيمتها السوقية بالدولار الأمريكي هذه القيمة أو تتجاوزها. يجب ألا تقل عن 0.
max_marketcap
يقتصر على العملات التي تساوي قيمتها السوقية بالدولار الأمريكي هذه القيمة أو تقل عنها. يجب ألا تقل عن 0.
min_volume
يقتصر على العملات التي يساوي حجم تداولها 24 ساعة بالدولار الأمريكي هذه القيمة أو يتجاوزها. يجب ألا تقل عن 0.
max_volume
يقتصر على العملات التي يساوي حجم تداولها 24 ساعة بالدولار الأمريكي هذه القيمة أو يقل عنها. يجب ألا تقل عن 0.
ids
الاقتصار على معرّفات عملات محددة (CSV، حتى 100 محدِّد مجتمعة مع الـ slugs والرموز). يجب ألا يتجاوز 1000 حرف.
slugs
الاقتصار على slugs عملات محددة (CSV، حتى 100 محدِّد مجتمعة). يجب ألا يتجاوز 2000 حرف.
symbols
الاقتصار على رموز عملات محددة (CSV، غير حساس لحالة الأحرف، حتى 100 محدِّد مجتمعة). يجب ألا يتجاوز 1000 حرف.
sort
حقول ترتيب مفصولة بفواصل؛ استخدم البادئة - للترتيب التنازلي. الحقول القابلة للترتيب: marketcap، rank، price، volume_24h، change_24h، change_7d. يجب ألا يتجاوز 100 حرف.
interval
نافذة الأكثر حركة لنقطتي /coins/gainers و/coins/losers فقط: 24h أو 7d.
أحد الخيارات:
24h
7d
الطلب
curl --request GET \ --get "https://bitculator.com/api/v1/coins?page=1&per_page=50&type=coin&status=active&search=bitcoin&min_price=0.5&max_price=100000&min_marketcap=1000000&max_marketcap=5000000000000&min_volume=1000000&max_volume=100000000000&ids=38%2C39&slugs=bitcoin%2Cethereum&symbols=BTC%2CETH&sort=-marketcap&interval=24h" \ --header "Authorization: Bearer {YOUR_API_KEY}" \ --header "Content-Type: application/json" \ --header "Accept: application/json"
const url = new URL( "https://bitculator.com/api/v1/coins" ); const params = { "page": "1", "per_page": "50", "type": "coin", "status": "active", "search": "bitcoin", "min_price": "0.5", "max_price": "100000", "min_marketcap": "1000000", "max_marketcap": "5000000000000", "min_volume": "1000000", "max_volume": "100000000000", "ids": "38,39", "slugs": "bitcoin,ethereum", "symbols": "BTC,ETH", "sort": "-marketcap", "interval": "24h", }; Object.keys(params) .forEach(key => url.searchParams.append(key, params[key])); const headers = { "Authorization": "Bearer {YOUR_API_KEY}", "Content-Type": "application/json", "Accept": "application/json", }; fetch(url, { method: "GET", headers, }).then(response => response.json());
$client = new \GuzzleHttp\Client(); $url = 'https://bitculator.com/api/v1/coins'; $response = $client->get( $url, [ 'headers' => [ 'Authorization' => 'Bearer {YOUR_API_KEY}', 'Content-Type' => 'application/json', 'Accept' => 'application/json', ], 'query' => [ 'page' => '1', 'per_page' => '50', 'type' => 'coin', 'status' => 'active', 'search' => 'bitcoin', 'min_price' => '0.5', 'max_price' => '100000', 'min_marketcap' => '1000000', 'max_marketcap' => '5000000000000', 'min_volume' => '1000000', 'max_volume' => '100000000000', 'ids' => '38,39', 'slugs' => 'bitcoin,ethereum', 'symbols' => 'BTC,ETH', 'sort' => '-marketcap', 'interval' => '24h', ], ] ); $body = $response->getBody(); print_r(json_decode((string) $body));
import requests import json url = 'https://bitculator.com/api/v1/coins' params = { 'page': '1', 'per_page': '50', 'type': 'coin', 'status': 'active', 'search': 'bitcoin', 'min_price': '0.5', 'max_price': '100000', 'min_marketcap': '1000000', 'max_marketcap': '5000000000000', 'min_volume': '1000000', 'max_volume': '100000000000', 'ids': '38,39', 'slugs': 'bitcoin,ethereum', 'symbols': 'BTC,ETH', 'sort': '-marketcap', 'interval': '24h', } headers = { 'Authorization': 'Bearer {YOUR_API_KEY}', 'Content-Type': 'application/json', 'Accept': 'application/json' } response = requests.request('GET', url, headers=headers, params=params) response.json()