Price statistics for one spot pair (or up to 100 with symbols): last price and quantity, open, high, low, previous close, price change and percent, weighted average price, best bid/ask with sizes (24h only), base and quote volume, trade count, window open/close times and first/last trade ids. window switches from the 24 h statistics to a rolling window of 1-59 minutes, 1-23 hours or 1-7 days. With market=usdm or market=coinm, the same statistics for futures contracts.
Every response includes credits_used: the credits this call cost.
Parameters
name
type
description
symbol
string
Trading pair, e.g. BTCUSDT. Required unless symbols is given. Example: BTCUSDT
symbols
string
Up to 100 comma-separated pairs, e.g. BTCUSDT,ETHUSDT,SOLUSDT; the answer is items.
window
string
24h (default) or a rolling window: 1m-59m, 1h-23h, 1d-7d, e.g. 4h. Example: 24h
market
spot | usdm | futures | coinm
spot (default), usdm (USDⓈ-M perpetual and delivery futures; futures also works) or coinm (COIN-M futures, e.g. BTCUSD or BTCUSD_PERP). Futures answers have 24h statistics only (no rolling window, no best bid/ask) and add market, pair and base_volume.
import os, requests
res = requests.get(
"https://api.api.sh/binance/v1/ticker",
params={"symbol": "BTCUSDT"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json()
const url = new URL("https://api.api.sh/binance/v1/ticker");
url.searchParams.set("symbol", "BTCUSDT");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();
Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.