Historical Price Ticks

Historical 1-second crypto price ticks for short-form chart backfill.

GET /v1/crypto/ticks

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.polynode.dev/v1/crypto/ticks?symbol=BTC&from=1780458961000&to=1780459082000&limit=5"

{
  "symbol": "BTC",
  "feed": "BTC/USD",
  "from": 1780458961000,
  "to": 1780459082000,
  "limit": 5,
  "count": 5,
  "truncated": true,
  "ticks": [
    {
      "id": "1780458962000-0",
      "type": "price_feed",
      "feed": "BTC/USD",
      "timestamp": 1780458962,
      "timestamp_ms": 1780458962000,
      "data": {
        "feed": "BTC/USD",
        "price": 65869.02124677686,
        "bid": 65865.65936734258,
        "ask": 65870.4120597498,
        "timestamp": 1780458962
      }
    }
  ]
}

Returns historical 1-second price ticks for the same crypto feeds available on the price_feed WebSocket stream. Use this endpoint to backfill a 5-minute, 15-minute, or 1-hour chart when a user opens it part way through the market window, then keep the chart current with live price_feed events.

symbol · string · required

Asset symbol. One of BTC, ETH, SOL, BNB, XRP, DOGE, HYPE.

from · number · required

Start of the range as a Unix timestamp in milliseconds.

to · number · required

End of the range as a Unix timestamp in milliseconds.

limit · number · default: "10000"

Maximum ticks to return. Max 100000.

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.polynode.dev/v1/crypto/ticks?symbol=BTC&from=1780458961000&to=1780459082000&limit=5"

{
  "symbol": "BTC",
  "feed": "BTC/USD",
  "from": 1780458961000,
  "to": 1780459082000,
  "limit": 5,
  "count": 5,
  "truncated": true,
  "ticks": [
    {
      "id": "1780458962000-0",
      "type": "price_feed",
      "feed": "BTC/USD",
      "timestamp": 1780458962,
      "timestamp_ms": 1780458962000,
      "data": {
        "feed": "BTC/USD",
        "price": 65869.02124677686,
        "bid": 65865.65936734258,
        "ask": 65870.4120597498,
        "timestamp": 1780458962
      }
    }
  ]
}

Range limits

Each request can cover up to 24 hours. If truncated is true, the response hit the requested limit; request a narrower time range or increase limit to retrieve more ticks.

Historical availability starts when tick collection was enabled. Ranges before available history return an empty ticks array.

Chart backfill

For a 15-minute market, request ticks from the market window start to now, render those points, then append live WebSocket price_feed events as they arrive.

const apiKey = "YOUR_API_KEY";
const symbol = "BTC";
const now = Date.now();
const windowStart = Math.floor(now / 1000 / 900) * 900 * 1000;

const url = new URL("https://api.polynode.dev/v1/crypto/ticks");
url.searchParams.set("symbol", symbol);
url.searchParams.set("from", String(windowStart));
url.searchParams.set("to", String(now));
url.searchParams.set("limit", "2000");

const response = await fetch(url, {
  headers: { "x-api-key": apiKey }
});
const history = await response.json();

const points = history.ticks.map((tick) => ({
  t: tick.timestamp_ms,
  price: tick.data.price
}));

console.log(points.at(0), points.at(-1));

Pair with the live stream

The response uses the same Chainlink price event shape as the WebSocket price_feed stream. Historical responses also include an id and timestamp_ms for replay and deduplication.

const ws = new WebSocket("wss://ws.polynode.dev/ws?key=YOUR_API_KEY");

ws.addEventListener("open", () => {
  ws.send(JSON.stringify({
    action: "subscribe",
    type: "chainlink",
    filters: { feeds: ["BTC/USD"] }
  }));
});

ws.addEventListener("message", (event) => {
  const msg = JSON.parse(event.data);
  if (msg.type !== "price_feed") return;

  const point = {
    t: msg.data.timestamp * 1000,
    price: msg.data.price
  };
  console.log(point);
});

Authorizations

x-api-key · string · header · required

Query Parameters

symbol · enum<string> · required

Asset symbol

Available options: BTC, ETH, SOL, BNB, XRP, DOGE, HYPE

from · number · required

Start of the range as a Unix timestamp in milliseconds

to · number · required

End of the range as a Unix timestamp in milliseconds

limit · integer · default: 10000

Maximum ticks to return

Required range: 1 <= x <= 100000

Response

200

application/json

Historical price ticks

The response is of type object.