Skip to main content
Welcome to the Chaos oracle API documentation. This API delivers real-time and historical price feeds for assets across blockchain networks, including Solana Virtual Machine (SVM) and Ethereum Virtual Machine (EVM).
Build decentralized applications, trading platforms, or analytics tools with reliable, secure price data.
All API endpoints require authentication using an API key, passed in the Authorization header. authentication

​
Environments

The Chaos oracle API is available in two environments:
  • Staging for testing and development
  • Production for live applications.

API Endpoints

  • Staging: https://oracle-staging.chaoslabs.co
  • Production: https://oracle.chaoslabs.co

​
Key Features

​
Using the API Playground

You can test endpoints directly in this documentation. To get valid results:
  • Navigate to an endpoint page (for example, Get Latest Prices for a Batch of Feeds).
  • Enter the requried parameter(s), in this case feedIds (for example, btcusd,ethusd).
  • Add your API key to the Authorization header.
  • Click Try It to run the request.

​
Response Schema

The Chaos oracle API typically returns data in JSON format, but response structures may vary slightly between endpoints. Understanding the schema for each endpoint is important for integrating oracle data into your decentralized application (DApp).
Below is the schema for the price data returned from the available endpoints: 
{
  "feedId": "ETHUSD",
  "price": 200000000000,
  "ts": 1653509453000,
  "expo": -8,
  "signature": "0x1234...5678",
  "recoveryId": 1
}

​
Field Descriptions

FieldTypeDescription
feedIdstringThe identifier for the price feed (for example, “ETHUSD”)
priceintegerThe price value, represented as an integer
tsintegerTimestamp of the price update in Unix milliseconds
expointegerExponent for the price value. Actual price = price * (10 ^ expo)
signaturestringCryptographic signature for verifying the authenticity of the data
recoveryIdintegerAdditional component of the signature used for verification
⌘I