R-Ticker

The Ticker system collects real-time price data from crypto exchanges and delivers it to users.

Data Format

Key Format: {exchange}-{pair}-{metric}
Example: binance-BTCUSDT-price

Exchanges:

ascendex azbit biconomy binance binance-futures binance-us bingx bingx-futures bitexen bitfinex bitget bitget-futures bitmart bitmart-futures bitstamp btcturk bybit bybit-futures coinbase coinex coinstore coin-tr coinw cryptocom deepcoin digifinex fameex gate-tr gateio gemini gemini-futures hibt htx icrypex kraken kraken-futures kucoin kucoin-futures lbank mexc okx okx-futures okx-tr orangex pionex probit toobit uzx whitebit xtcom

Metrics:

• price: Last price
• change: Price change (absolute value)
• changePercent: Price change percentage (%)
• volume: 24-hour trading volume (in quote asset)

For each exchange, a separate ticker service runs every 5 seconds:

Authentication

To use the Ticker API, you must first obtain a JWT token.

Endpoint: POST /api/v1/ticker/login
Use the token in subsequent requests via the Authorization: Bearer {token} header.

Parameters:

• email: User email address
• password: User password

response:

{
  "access_token": "string",
  "expires_in": 0,
  "id_token": "string",
  "not-before-policy": 0,
  "refresh_expires_in": 0,
  "refresh_token": "string",
  "scope": "string",
  "session_state": "string",
  "token_type": "string"
}

WebSocket Stream

You can establish a WebSocket connection for real-time data streaming.

Endpoint: POST /api/v1/ticker/ws/login

Parameters:

• exchange: Exchange names (lowercase, e.g. binance, bybit)
• pair: Trading pairs (uppercase, e.g. BTCUSDT, ETHUSDT)
• value: Metric types (price, change, changepercent, volume)

response:

{
  "exchanges": ["binance", "bybit"],
  "pairs": ["BTCUSDT", "ETHUSDT"],
  "values": ["price", "changepercent", "volume"]
}

Single Data Query (REST)

To retrieve real-time data for a specific exchange and trading pair:

Endpoint: GET /api/v1/ticker/{exchange}/{pair}/{value}

Parameters:

• exchange: Exchange name (lowercase, e.g. binance, bybit)
• pair: Trading pair (uppercase, e.g. BTCUSDT, ETHUSDT)
• value: Metric type (price, change, changepercent, volume)

Response:

{
  "exchange": "binance",
  "pair": "BTCUSDT",
  "value": "price",
  "data": "90671.89"
}

Error Codes:

• 400: Invalid parameters
• 401: Authentication error
• 404: Data not found
• 500: Server error

Special Cases

• Hyphens are removed: BTC-USDT → BTCUSDT
• All pairs are converted to uppercase.
• The symbol BTT is returned as BTTC in responses.

Kraken

Since Kraken uses different naming for some coins, the system performs automatic conversion: