API Reference

Get Price At Timestamp

Get historical crypto price at a specific timestamp.

PRIMARY: Chainlink timeline sorted set (populated by RTDS WebSocket). This gives us the exact Chainlink price that Polymarket uses for Up/Down market resolution — accurate to the second for the last 30 min.

FALLBACK: CryptoCompare API (hourly candles) for older timestamps.

This is used for Up/Down markets to show the “price to beat” - the crypto price at the start of the market interval.

GET

prices

{symbol}

Get Price At Timestamp

curl --request GET \
  --url https://staging-api.polysimulator.com/prices/at/{symbol}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Path Parameters

symbol

string

required

Query Parameters

timestamp

string

required

ISO timestamp to get price at (e.g. 2025-04-01T00:09:00Z)

Response

Successful Response

Receive Price PushReceive price update(s) from the external price relay server. Accepts either: - Single price: {"symbol": "BTC", "price": 42000.0, "source": "rtds", ...} - Batch: {"prices": [{...}, {...}], "flush_ts_ms": 1234567890} Authentication: Bearer token must match RELAY_AUTH_TOKEN env var. NOTE: Uses async Redis (r_async) to avoid blocking the event loop.

⌘I

Get Price At Timestamp

curl --request GET \
  --url https://staging-api.polysimulator.com/prices/at/{symbol}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Health

Market Data

Trading

Account

API Keys

API Reference

admin

Get Price At Timestamp

Path Parameters

Query Parameters

Response