Danh sách coin
Các coin đã xếp hạng cùng giá, bộ lọc và bộ chọn, phân trang với envelope
links + meta của Laravel. Giá, marketcap và circulating_supply là chuỗi
thập phân; thay đổi và xếp hạng là số.
Key chỉ dùng Bearer và mang quyền data-api — hãy giữ chúng ở phía máy chủ.
Tham số truy vấn
page
Số trang (bắt đầu từ 1). Phải ít nhất là 1.
per_page
Số dòng mỗi trang. Giới hạn tùy theo gói (Free 100, Starter/Pro 250); vượt quá sẽ trả về 422 thay vì cắt bớt. Phải ít nhất là 1. Không được vượt quá 100.
type
Giới hạn ở một loại tài sản duy nhất: coin hoặc token.
Một trong:
coin
token
status
Trạng thái niêm yết: active, delisted, untracked, progressing, awaiting hoặc preparing. Mặc định là tất cả trạng thái công khai.
Một trong:
active
delisted
untracked
progressing
awaiting
preparing
search
Khớp văn bản tự do theo tên hoặc ký hiệu. Không được vượt quá 100 ký tự.
min_price
Chỉ những coin có giá bằng hoặc cao hơn giá trị USD này. Phải ít nhất là 0.
max_price
Chỉ những coin có giá bằng hoặc thấp hơn giá trị USD này. Phải ít nhất là 0.
min_marketcap
Chỉ những coin có vốn hóa USD bằng hoặc cao hơn giá trị này. Phải ít nhất là 0.
max_marketcap
Chỉ những coin có vốn hóa USD bằng hoặc thấp hơn giá trị này. Phải ít nhất là 0.
min_volume
Chỉ những coin có khối lượng USD 24h bằng hoặc cao hơn giá trị này. Phải ít nhất là 0.
max_volume
Chỉ những coin có khối lượng USD 24h bằng hoặc thấp hơn giá trị này. Phải ít nhất là 0.
ids
Lọc đến các ID coin cụ thể (CSV, tối đa 100 bộ chọn kết hợp với slugs/symbols). Không được vượt quá 1000 ký tự.
slugs
Lọc đến các slug coin cụ thể (CSV, tối đa 100 bộ chọn kết hợp). Không được vượt quá 2000 ký tự.
symbols
Lọc đến các ký hiệu coin cụ thể (CSV, không phân biệt hoa thường, tối đa 100 bộ chọn kết hợp). Không được vượt quá 1000 ký tự.
sort
Các trường sắp xếp phân tách bằng dấu phẩy; thêm tiền tố - để giảm dần. Có thể sắp xếp: marketcap, rank, price, volume_24h, change_24h, change_7d. Không được vượt quá 100 ký tự.
interval
Khoảng biến động chỉ dành cho /coins/gainers và /coins/losers: 24h hoặc 7d.
Một trong:
24h
7d
Request
curl --request GET \ --get "http://localhost/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( "http://localhost/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 = 'http://localhost/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 = 'http://localhost/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()