코인 목록
가격, 필터, 셀렉터를 지원하는 코인 순위 목록이며 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.
다음 중 하나:
coin
token
status
상장 상태: active, delisted, untracked, progressing, awaiting 또는 preparing. 기본값은 모든 공개 상태입니다.
다음 중 하나:
active
delisted
untracked
progressing
awaiting
preparing
search
이름 또는 심볼을 자유 검색어로 찾습니다. 100자를 초과할 수 없습니다.
min_price
가격이 이 USD 값 이상인 코인만 반환합니다. 0 이상이어야 합니다.
max_price
가격이 이 USD 값 이하인 코인만 반환합니다. 0 이상이어야 합니다.
min_marketcap
USD 시가총액이 이 값 이상인 코인만 반환합니다. 0 이상이어야 합니다.
max_marketcap
USD 시가총액이 이 값 이하인 코인만 반환합니다. 0 이상이어야 합니다.
min_volume
24시간 USD 거래량이 이 값 이상인 코인만 반환합니다. 0 이상이어야 합니다.
max_volume
24시간 USD 거래량이 이 값 이하인 코인만 반환합니다. 0 이상이어야 합니다.
ids
특정 코인 id만 필터링합니다(CSV, slugs/symbols와 합쳐 선택자 최대 100개). 1000자를 초과할 수 없습니다.
slugs
특정 코인 slug만 필터링합니다(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()