Get Ticks

Raw tick-level orderbook events.

GET /v1/ticks

Get Ticks

cURL

curl --request GET \
  --url https://api.polydata.live/v1/ticks

200

{
  "data": [
    {}
  ]
}

Returns the raw event stream for an asset within a time range. Each tick is a single orderbook event (price change, snapshot, etc.) at millisecond precision.

Query Parameters

asset_id · string · required

Outcome token ID

start · number · required

Start time (Unix ms)

end · number · required

End time (Unix ms)

event_type · string

Filter: price_change, book, last_trade_price

limit · number · default: "10000"

Max ticks (1-100000)

Response

data · array

Array of tick events. Each has t, event, side, best_bid, best_ask, price, size.

Example

curl "https://api.polydata.live/v1/ticks?asset_id=xxx&start=1776240000000&end=1776240010000&limit=100" \
  -H "Authorization: Bearer pd_live_xxxxx"

{
  "success": true,
  "data": [
    {
      "t": 1776240000035,
      "event": "price_change",
      "side": "YES",
      "best_bid": 0.46,
      "best_ask": 0.47,
      "price": 0.01,
      "size": 10974.76
    },
    {
      "t": 1776240000037,
      "event": "price_change",
      "side": "YES",
      "best_bid": 0.46,
      "best_ask": 0.47,
      "price": 0.45,
      "size": 35.0
    }
  ],
  "meta": { "count": 100 }
}

For larger datasets (millions of ticks), use Get Ticks Export for streaming download instead.