Listar moedas
Moedas ordenadas com preços, filtros e seletores, paginadas com o envelope links + meta
do Laravel. Preços, marketcap e circulating_supply são strings decimais; as variações e ranks
são números.
As chaves são exclusivamente Bearer e possuem a capacidade data-api — mantenha-as no lado do servidor.
Parâmetros de query
page
Número da página (começa em 1). Deve ser no mínimo 1.
per_page
Linhas por página. O limite depende do plano (Free 100, Starter/Pro 250); excedê-lo devolve 422 em vez de o restringir. Deve ser no mínimo 1. Não pode ser superior a 100.
type
Restringir a um único tipo de ativo: coin ou token.
Um de:
coin
token
status
Estado de listagem: active, delisted, untracked, progressing, awaiting ou preparing. Predefinição: todos os estados públicos.
Um de:
active
delisted
untracked
progressing
awaiting
preparing
search
Correspondência de texto livre no nome ou símbolo. Não pode ter mais de 100 caracteres.
min_price
Apenas moedas com preço igual ou superior a este valor em USD. Deve ser no mínimo 0.
max_price
Apenas moedas com preço igual ou inferior a este valor em USD. Deve ser no mínimo 0.
min_marketcap
Apenas moedas com marketcap em USD igual ou superior a este valor. Deve ser no mínimo 0.
max_marketcap
Apenas moedas com marketcap em USD igual ou inferior a este valor. Deve ser no mínimo 0.
min_volume
Apenas moedas com volume de 24h em USD igual ou superior a este valor. Deve ser no mínimo 0.
max_volume
Apenas moedas com volume de 24h em USD igual ou inferior a este valor. Deve ser no mínimo 0.
ids
Filtre para ids de moeda específicos (CSV, até 100 seletores combinados com slugs/symbols). Não pode ter mais de 1000 caracteres.
slugs
Filtre para slugs de moeda específicos (CSV, até 100 seletores combinados). Não pode ter mais de 2000 caracteres.
symbols
Filtre para símbolos de moeda específicos (CSV, sem distinção de maiúsculas, até 100 seletores combinados). Não pode ter mais de 1000 caracteres.
sort
Campos de ordenação separados por vírgula; prefixe com - para descendente. Ordenável por: marketcap, rank, price, volume_24h, change_24h, change_7d. Não pode ter mais de 100 caracteres.
interval
Janela de variação apenas para /coins/gainers e /coins/losers: 24h ou 7d.
Um de:
24h
7d
Pedido
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()