Ticker

Latest price and rolling 24-hour statistics for one or more symbols.

Endpoint

GET /v1/market/ticker

Weight: 2 for a single symbol, 40 when neither symbol nor symbols is provided (returns all symbols).

Authentication: Public (optional signing).

Query parameters

Name	Type	Mandatory	Description
symbol	string	No	Single symbol, e.g. BTCUSDT. Returns one object.
symbols	string	No	JSON-encoded array of symbols, e.g. ["BTCUSDT","ETHUSDT"]. Returns an array. URL-encode the value.

symbol and symbols are mutually exclusive. If both are omitted, the endpoint returns the ticker for every actively trading symbol.

Response

Single symbol (symbol=BTCUSDT):

{
  "symbol": "BTCUSDT",
  "price": "67432.15",
  "bid": "67431.90",
  "ask": "67432.40",
  "volume_24h": "18234.4521",
  "quote_volume_24h": "1229874512.33",
  "change_24h_pct": "2.34",
  "high_24h": "68120.00",
  "low_24h": "65890.10",
  "count_24h": 482913,
  "close_time": 1745923200000
}

Multiple symbols (symbols=["BTCUSDT","ETHUSDT"]) or no parameter — returns an array:

[
  {
    "symbol": "BTCUSDT",
    "price": "67432.15",
    "bid": "67431.90",
    "ask": "67432.40",
    "volume_24h": "18234.4521",
    "quote_volume_24h": "1229874512.33",
    "change_24h_pct": "2.34",
    "high_24h": "68120.00",
    "low_24h": "65890.10",
    "count_24h": 482913,
    "close_time": 1745923200000
  },
  {
    "symbol": "ETHUSDT",
    "price": "3421.88",
    "bid": "3421.80",
    "ask": "3421.95",
    "volume_24h": "215431.221",
    "quote_volume_24h": "738912334.10",
    "change_24h_pct": "-0.91",
    "high_24h": "3489.50",
    "low_24h": "3380.00",
    "count_24h": 318204,
    "close_time": 1745923200000
  }
]

Response fields

Field	Type	Description
symbol	string	Trading pair, uppercase.
price	string (decimal)	Last traded price.
bid	string (decimal)	Best bid price on the book.
ask	string (decimal)	Best ask price on the book.
volume_24h	string (decimal)	Rolling 24-hour traded volume in base asset.
quote_volume_24h	string (decimal)	Rolling 24-hour traded volume in quote asset.
change_24h_pct	string (decimal)	24h price change in percent. "2.34" means +2.34%; "-0.91" means -0.91%.
high_24h	string (decimal)	Highest traded price in the rolling 24h window.
low_24h	string (decimal)	Lowest traded price in the rolling 24h window.
count_24h	integer	Number of trades in the rolling 24h window.
close_time	integer	Window close time, Unix milliseconds.

Errors

HTTP	Code	Meaning
400	INVALID_PARAMETER	symbol and symbols were both supplied, or symbols was not valid JSON.
400	UNKNOWN_SYMBOL	One or more requested symbols do not exist.
429	RATE_LIMITED	Per-key request weight exceeded.

Example

curl -s "https://api.pipai.io/v1/market/ticker?symbol=BTCUSDT"

curl -s --get "https://api.pipai.io/v1/market/ticker" \
  --data-urlencode 'symbols=["BTCUSDT","ETHUSDT"]'