Chainlink | Kwery

Overview

Chainlink provides decentralized oracle price feeds used by DeFi protocols for pricing, settlement, and liquidation. Kwery reads price data directly from Chainlink aggregator contracts on Polygon Mainnet and normalizes it into time-series format. These are the same feeds that Polymarket and other on-chain protocols use as their reference prices.

What we ingest

Aggregator round prices from Chainlink contracts on Polygon
8-decimal precision price data

Currently tracked feeds: BTC/USD, ETH/USD, SOL/USD, XRP/USD (queried as BTC, ETH, SOL, XRP).

Data semantics

Concept	Detail
Chain	Polygon Mainnet
Precision	8 decimal places (e.g. `78234.12345678`)
Update trigger	Heartbeat interval or deviation threshold (whichever fires first)
Data format	Timestamp + price pairs

ℹ️Info

Chainlink feeds do not update on a fixed clock. They update when the price deviates beyond a threshold (typically 0.5–1%) or when the heartbeat timer fires (typically every 27 seconds for major feeds on Polygon). Kwery buckets these updates into fixed intervals.

Available endpoints

List available feeds

GET /v1/chainlink

Returns all tracked Chainlink price feeds and their metadata.

curl "https://kwery-api.com/v1/chainlink?api-key=YOUR_KEY"

{
  "source": "chainlink",
  "chain": "polygon",
  "feeds": [
    { "symbol": "BTC", "pair": "BTC/USD", "decimals": 8, "status": "active" },
    { "symbol": "ETH", "pair": "ETH/USD", "decimals": 8, "status": "active" },
    { "symbol": "SOL", "pair": "SOL/USD", "decimals": 8, "status": "active" },
    { "symbol": "XRP", "pair": "XRP/USD", "decimals": 8, "status": "active" }
  ]
}

Get price data

GET /v1/chainlink/{symbol}

Returns time-series price data from the Chainlink aggregator.

Parameter	Type	Required	Default	Description
`symbol`	string	Yes	—	Asset symbol (e.g. BTC, ETH, SOL, XRP)
`interval`	string	Yes	—	Data interval: 5m, 15m
`start`	string	No	—	ISO 8601 start time
`end`	string	No	—	ISO 8601 end time
`limit`	integer	No	100	Maximum records to return
`offset`	integer	No	0	Number of records to skip

curl "https://kwery-api.com/v1/chainlink/BTC?api-key=YOUR_KEY&interval=5m&limit=5"

{
  "symbol": "BTC",
  "source": "chainlink",
  "chain": "polygon",
  "interval": "5m",
  "prices": [
    {
      "timestamp": "2026-03-09T12:00:00Z",
      "price": 78234.12345678
    },
    {
      "timestamp": "2026-03-09T11:55:00Z",
      "price": 78210.98765432
    },
    {
      "timestamp": "2026-03-09T11:50:00Z",
      "price": 78195.45678901
    },
    {
      "timestamp": "2026-03-09T11:45:00Z",
      "price": 78180.23456789
    },
    {
      "timestamp": "2026-03-09T11:40:00Z",
      "price": 78162.67890123
    }
  ],
  "total": 288,
  "limit": 5,
  "offset": 0
}

Source-specific fields

Field	Type	Description
`price`	`float`	Oracle price in USD with 8 decimal places
`timestamp`	`string`	ISO 8601 interval time
`interval`	`string`	`5m` or `15m`

Available intervals

Interval	Description	Minimum plan
`5m`	5-minute price points	Free
`15m`	15-minute price points	Free

⚠️Warning

Chainlink data is only available at 5-minute and 15-minute intervals. Hourly, 4-hour, and daily aggregations are not currently supported for this source.

Limitations & notes

Only 5m and 15m intervals. Chainlink's on-chain update cadence doesn't map cleanly to broader intervals. We provide the two finest granularities where aggregation is meaningful.
8-decimal precision. Chainlink feeds natively use 8 decimals. All prices are returned at full precision — do not truncate if you're using these for settlement or arbitrage calculations.
Polygon Mainnet only. Kwery currently reads from Polygon, not Ethereum Mainnet or other chains. This is the same chain Polymarket settles on, making it the natural reference source for cross-correlating prediction market prices with oracle prices.
Non-uniform raw updates. The underlying oracle updates on deviation or heartbeat, not on a fixed schedule. Kwery buckets these into fixed intervals, using the most recent round price at each boundary. During low-volatility periods, consecutive intervals may show the same price.
Useful for settlement reference. Chainlink feeds are widely used as settlement sources in DeFi. Comparing Chainlink prices against CEX prices (Binance) lets you measure oracle latency and detect stale feed conditions.
No OHLCV. Unlike exchange sources, Chainlink returns a single price per interval — there is no open/high/low/close or volume concept.