Skip to main content
GET
/
api
/
trading
/
ticker
/
{symbol}
Get Aggregated Ticker Data
curl --request GET \
  --url https://api.tide.ag/api/trading/ticker/{symbol} \
  --header 'X-API-KEY: <api-key>'
{
  "success": true,
  "data": {
    "symbol": "BTC",
    "exchanges": {
      "hyperliquid": {
        "success": true,
        "symbol": "BTC",
        "markPrice": "<string>",
        "lastPrice": "<string>",
        "prevDayPrice": "<string>",
        "change24h": "<string>",
        "change24hAbs": "<string>",
        "volume24h": "<string>",
        "openInterest": "<string>",
        "high24h": "<string>",
        "low24h": "<string>",
        "indexPrice": "<string>",
        "openPrice": "<string>",
        "fundingRate": "<string>",
        "nextFundingTime": 123,
        "volumeBase": "<string>",
        "marketId": 123,
        "note": "<string>",
        "asterSymbol": "<string>",
        "error": "<string>",
        "timestamp": 123
      },
      "lighter": {
        "success": true,
        "symbol": "BTC",
        "markPrice": "<string>",
        "lastPrice": "<string>",
        "prevDayPrice": "<string>",
        "change24h": "<string>",
        "change24hAbs": "<string>",
        "volume24h": "<string>",
        "openInterest": "<string>",
        "high24h": "<string>",
        "low24h": "<string>",
        "indexPrice": "<string>",
        "openPrice": "<string>",
        "fundingRate": "<string>",
        "nextFundingTime": 123,
        "volumeBase": "<string>",
        "marketId": 123,
        "note": "<string>",
        "asterSymbol": "<string>",
        "error": "<string>",
        "timestamp": 123
      },
      "aster": {
        "success": true,
        "symbol": "BTC",
        "markPrice": "<string>",
        "lastPrice": "<string>",
        "prevDayPrice": "<string>",
        "change24h": "<string>",
        "change24hAbs": "<string>",
        "volume24h": "<string>",
        "openInterest": "<string>",
        "high24h": "<string>",
        "low24h": "<string>",
        "indexPrice": "<string>",
        "openPrice": "<string>",
        "fundingRate": "<string>",
        "nextFundingTime": 123,
        "volumeBase": "<string>",
        "marketId": 123,
        "note": "<string>",
        "asterSymbol": "<string>",
        "error": "<string>",
        "timestamp": 123
      }
    }
  },
  "timestamp": 123
}
Retrieve consolidated ticker information for Hyperliquid, Lighter, and Aster perpetual markets. The response includes the best available mark price (or proxy), 24-hour statistics, and funding data provided by each exchange.

​
Features

  • Multi-exchange aggregation: Combines ticker data from Hyperliquid, Lighter, and Aster
  • Real-time pricing: Mark price, last price, and 24-hour statistics
  • Funding rates: Current funding rates and next funding times
  • Exchange-specific endpoints: Query individual exchanges for debugging

​
Request

  • Method: GET
  • Endpoint: /api/trading/ticker/{symbol}
  • Path Parameters: symbol (required - e.g., BTC, ETH, SOL)
curl -X GET "https://api.tide.ag/api/trading/ticker/BTC" \
  -H "Content-Type: application/json"

​
Response Example

{
  "success": true,
  "data": {
    "symbol": "BTC",
    "exchanges": {
      "hyperliquid": {
        "success": true,
        "exchange": "hyperliquid",
        "symbol": "BTC",
        "markPrice": "106372.0",
        "lastPrice": "106370.5",
        "prevDayPrice": "102326.0",
        "change24h": "3.95",
        "change24hAbs": "4046.00",
        "volume24h": "3322746739.22",
        "fundingRate": "0.0000125",
        "openInterest": "29434.34754",
        "timestamp": 1762780625878
      },
      "lighter": {
        "success": true,
        "exchange": "lighter",
        "symbol": "BTC",
        "marketId": 1,
        "markPrice": "106547.1",
        "lastPrice": "106547.1",
        "indexPrice": "0",
        "prevDayPrice": "106544.04",
        "change24h": "0.00",
        "change24hAbs": "3.06",
        "volume24h": "5655214564.52",
        "high24h": "106666",
        "low24h": "102735",
        "openInterest": "3126.73",
        "note": "Mark price uses last_trade_price as Lighter's calculated mark price is not exposed via API",
        "timestamp": 1762780962864
      },
      "aster": {
        "success": true,
        "exchange": "aster",
        "symbol": "BTC",
        "asterSymbol": "BTCUSDT",
        "markPrice": "106372.50",
        "indexPrice": "106365.00",
        "lastPrice": "106372.50",
        "prevDayPrice": "102448.10",
        "openPrice": "102448.1",
        "change24h": "3.73",
        "change24hAbs": "3816.90",
        "volume24h": "7012103458.28",
        "volumeBase": "67021.693",
        "high24h": "106623.8",
        "low24h": "102425.0",
        "fundingRate": "0.000125",
        "nextFundingTime": 1762783200000,
        "timestamp": 1762781323662
      }
    }
  },
  "timestamp": 1762781600000
}

​
Use Cases

  • Cross-check mark prices across multiple exchanges
  • Monitor funding rate discrepancies for arbitrage opportunities
  • Display consolidated market data in trading dashboards
  • Track 24-hour price changes and volume across venues
Use the aggregated route to cross-check mark prices across venues or surface discrepancies in monitoring dashboards.

​
Exchange-Specific Endpoints

For debugging or latency testing, you can query each exchange directly:
  • Hyperliquid: GET /api/trading/hyperliquid/ticker/{symbol}
  • Lighter: GET /api/trading/lighter/ticker/{symbol}
  • Aster: GET /api/trading/aster/ticker/{symbol}
All endpoints return the same success wrapper and per-exchange payload shape as shown in the aggregated example.

​
Authentication

  • Aster requires HMAC-SHA256 credentials supplied via server environment variables (ASTER_API_KEY, ASTER_API_SECRET). The API layer signs requests automatically.
  • Hyperliquid and Lighter routes do not require authentication for ticker data.

​
Response Fields

Common fields across all exchanges:
  • markPrice — Most recent mark price
  • lastPrice — Most recent trade price
  • prevDayPrice — Price 24 hours ago
  • change24h — 24-hour percentage change
  • change24hAbs — 24-hour absolute change
  • volume24h — Quote currency volume
  • timestamp — Unix epoch in milliseconds
Exchange-specific fields:
  • Hyperliquid: fundingRate, openInterest
  • Lighter: marketId, indexPrice, high24h, low24h, note
  • Aster: asterSymbol, indexPrice, openPrice, high24h, low24h, fundingRate, nextFundingTime, volumeBase
Lighter’s mark price uses last_trade_price as the calculated mark price is not exposed via API.

​
Error Handling

  • Unknown symbols return success: false with an exchange-specific error message that includes a preview of available tickers
  • Missing Aster credentials trigger an authentication error; verify environment variables on the API server
  • Individual exchange failures are isolated; other exchanges will still return data

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
symbol
string
required

Asset symbol using uppercase format (e.g., BTC, ETH, SOL).

Example:

"BTC"

Response

Aggregated ticker data

Standard API response envelope for aggregated ticker requests.

​
success
boolean
required

Indicates if the aggregated request succeeded across exchanges.

​
data
object
required

Aggregated ticker data or an exchange-specific error payload.

​
timestamp
integer
required

Unix timestamp in milliseconds when the response was generated.