API ReferenceData Feeds
Recent Chainlink rounds, walked back from latest (newest first).
const url = 'https://data.predictefy.com/api/feeds/binance/fetchOracleHistory?limit=10';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://data.predictefy.com/api/feeds/binance/fetchOracleHistory?limit=10' \ --header 'Authorization: Bearer <token>'Chainlink only. Bounded fan-out: limit (max 50) rounds ride ONE batched RPC request; unrecorded/reverted rounds are skipped honestly, so fewer rounds than asked is a truthful answer. The walk never crosses below round 1 of the current aggregator phase. Dark by default — 503 FEEDS_UNAVAILABLE until READS_ENABLE_DATA_FEEDS is set. Pass the oracle pair as symbol; the old feed query name remains a deprecated alias.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”One of the R4 reference data feeds (unknown feeds answer 404 FEED_NOT_FOUND).
Query Parameters
Section titled “Query Parameters”Oracle pair, e.g. BTC/USD. Required unless the deprecated feed alias is supplied.
Deprecated alias for symbol; retained for backward compatibility.
Responses
Section titled “Responses”Decoded rounds, newest first.
object
A decoded Chainlink AggregatorV3 round (startedAt/updatedAt are epoch SECONDS as returned on-chain).
object
The oracle pair, e.g. BTC/USD.
Proxy round id as a decimal string (phase-encoded uint80).
The price
UpdatedAt as ISO — honest on-chain freshness.
object
Binance-rest — served from Binance's public REST market-data mirror. binance-ws — streamed from Binance's public market-data WebSocket. chainlink-onchain — read from Chainlink's on-chain oracle through public RPC.
object
The freshest UPSTREAM event time in the list; null when empty (never a server Date.now()).
object
Binance-rest — served from Binance's public REST market-data mirror. binance-ws — streamed from Binance's public market-data WebSocket. chainlink-onchain — read from Chainlink's on-chain oracle through public RPC.
Served from the short-TTL feeds cache.
Example
{ "data": [ { "provenance": { "source": "binance-rest" } } ], "meta": { "provenance": { "source": "binance-rest" } }}Headers
Section titled “Headers”Net credits charged for this metered response after any error refund.
Post-charge account balance. Present only when the existing debit/refund operation made it available; the service never adds a database read solely for this header.
The metered request was invalid or could not be served as requested.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Headers
Section titled “Headers”Net credits charged for this metered response after any error refund.
Post-charge account balance. Present only when the existing debit/refund operation made it available; the service never adds a database read solely for this header.
The API key is missing, unknown, or revoked. A venue-authenticated read also answers 401 when the venue itself rejects the credential. Not retryable.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}The account cannot cover this endpoint's weight.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Headers
Section titled “Headers”Net credits charged for this metered response after any error refund.
Post-charge account balance. Present only when the existing debit/refund operation made it available; the service never adds a database read solely for this header.
SCOPE_MISSING — API key lacks the route's required scope (RBAC v1)
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}FEED_NOT_FOUND
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Headers
Section titled “Headers”Net credits charged for this metered response after any error refund.
Post-charge account balance. Present only when the existing debit/refund operation made it available; the service never adds a database read solely for this header.
Rate limit exceeded. The response carries Retry-After in whole seconds, always rounded up so a sub-second remainder never points back inside the live window.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Unexpected internal error after pricing. Retryable.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Headers
Section titled “Headers”Net credits charged for this metered response after any error refund.
Post-charge account balance. Present only when the existing debit/refund operation made it available; the service never adds a database read solely for this header.
NOT_SUPPORTED — feed capability gap
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Headers
Section titled “Headers”Net credits charged for this metered response after any error refund.
Post-charge account balance. Present only when the existing debit/refund operation made it available; the service never adds a database read solely for this header.
FEED_UPSTREAM
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Headers
Section titled “Headers”Net credits charged for this metered response after any error refund.
Post-charge account balance. Present only when the existing debit/refund operation made it available; the service never adds a database read solely for this header.
FEEDS_UNAVAILABLE
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Headers
Section titled “Headers”Net credits charged for this metered response after any error refund.
Post-charge account balance. Present only when the existing debit/refund operation made it available; the service never adds a database read solely for this header.