Coins auflisten
Gerankte Coins mit Preisen, Filtern und Selektoren, paginiert mit Laravels links + meta-Hülle. Preise, marketcap und circulating_supply sind Dezimal-Strings; Änderungen und Ränge sind Zahlen.
Keys sind ausschließlich Bearer-basiert und tragen die data-api-Berechtigung — bewahre sie serverseitig auf.
Query-Parameter
page
Seitennummer (1-basiert). Muss mindestens 1 sein.
per_page
Zeilen pro Seite. Das Limit ist tarifabhängig (Free 100, Starter/Pro 250); ein Überschreiten liefert 422, statt zu begrenzen. Muss mindestens 1 sein. Darf nicht größer als 100 sein.
type
Auf einen einzelnen Asset-Typ beschränken: coin oder token.
Eines von:
coin
token
status
Listing-Status: active, delisted, untracked, progressing, awaiting oder preparing. Standard sind alle öffentlichen Status.
Eines von:
active
delisted
untracked
progressing
awaiting
preparing
search
Freitext-Treffer auf Name oder Symbol. Darf nicht länger als 100 Zeichen sein.
min_price
Nur Coins mit einem Preis auf oder über diesem USD-Wert. Muss mindestens 0 sein.
max_price
Nur Coins mit einem Preis auf oder unter diesem USD-Wert. Muss mindestens 0 sein.
min_marketcap
Nur Coins mit einer USD-Marktkapitalisierung auf oder über diesem Wert. Muss mindestens 0 sein.
max_marketcap
Nur Coins mit einer USD-Marktkapitalisierung auf oder unter diesem Wert. Muss mindestens 0 sein.
min_volume
Nur Coins mit einem 24h-USD-Volumen auf oder über diesem Wert. Muss mindestens 0 sein.
max_volume
Nur Coins mit einem 24h-USD-Volumen auf oder unter diesem Wert. Muss mindestens 0 sein.
ids
Auf bestimmte Coin-IDs filtern (CSV, bis zu 100 Selektoren kombiniert mit slugs/symbols). Darf nicht länger als 1000 Zeichen sein.
slugs
Auf bestimmte Coin-Slugs filtern (CSV, bis zu 100 Selektoren kombiniert). Darf nicht länger als 2000 Zeichen sein.
symbols
Auf bestimmte Coin-Symbole filtern (CSV, Groß-/Kleinschreibung wird ignoriert, bis zu 100 Selektoren kombiniert). Darf nicht länger als 1000 Zeichen sein.
sort
Kommagetrennte Sortierfelder; Präfix - für absteigend. Sortierbar: marketcap, rank, price, volume_24h, change_24h, change_7d. Darf nicht länger als 100 Zeichen sein.
interval
Mover-Fenster nur für /coins/gainers und /coins/losers: 24h oder 7d.
Eines von:
24h
7d
Anfrage
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()