Loading page
REST API v1 · Oracle transparency and risk intelligence
Query prices, consensus, reputation, depeg risk, protocol exposure, and pre-trade risk through one typed interface with explicit freshness and verification metadata.
01 — First request
Copy a snippet, plug in your API key, and start querying oracle data with source metadata.
Create an API key below. It is shown only once, so store it securely.
Choose a provider, symbol and chain. URL-encode symbols like BTC%2FUSD.
Check the success flag and read price plus verification metadata.
Source provenance
Observation time
Verification context
curl -H "X-API-Key: ins_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
"https://www.oracleinsight.xyz/api/v1/prices?provider=chainlink&symbol=BTC%2FUSD&chain=ethereum"02 — Capability surface
A single API for oracle prices, risk tracking and protocol analytics.
On-demand prices from Chainlink, API3, RedStone, DIA, Supra, Band Protocol and more across 40+ chains.
Reliability snapshots polled every 15 minutes — consensus price, per-provider deviation and latency, with a 90-day history window.
Fetch multiple assets in a single request. Perfect for dashboards, indexers and bots.
Analyze stablecoins, wrapped assets and LSTs through one risk surface, with oracle-market divergence, underlying references and protocol impact.
Run 1%, 3%, 5% adverse deviation scenarios on Aave, Compound, Morpho and more.
Hourly reputation scores, 15-minute feed health, deviation events and shared-source dependency analysis.
Aggregate anomaly summaries over the last 30 days with severity and provider breakdowns.
03 — Select capacity
Start with 100 trial credits after email verification. Add a monthly allowance or top up when your workload grows; every paid path uses the same C1–C4 meter.
Compare all plans04 — Access control
Create and manage keys, view usage, and revoke access when needed.
Create an account to generate your API key and start building.
05 — Operational questions
Include your API key in the X-API-Key header. The /api/v1/health endpoint is public and does not require authentication.
Insight collects price snapshots every 15 minutes and recalculates reputation scores hourly. Prices are also fetched on demand (5-minute cache). Daily reports aggregate the day’s deviation events and liquidation stress tests. Polling faster than 15 minutes yields no fresher snapshot data, so clients should cache accordingly.
Every API key is credit-metered: each call costs credits by metering class (C1–C4). Credits come from your wallet — a monthly allowance with a Developer, Team, or Scale subscription, or prepaid top-up packs from Settings → Billing. When the wallet balance (or a key’s monthly credit budget) can’t cover the next call, requests return HTTP 402 with CREDIT_EXHAUSTED and the response includes your balance and a top-up link.
Payments are made in crypto via NOWPayments and are irreversible on-chain. If you experience a significant service issue within the first 14 days, contact us with your invoice ID for a case-by-case review — approved refunds are issued manually from our merchant balance. See our Refund Policy for full details.
Yes. Every paid plan (Developer, Team, Scale, Enterprise) includes commercial use rights. You can use the API in production applications, SaaS products, and internal tools. Attribution is appreciated but not required.
Developer: 60 req/min, Team: 300 req/min, Scale: 1,200 req/min, Enterprise: custom. These are sized to the 15-minute data cadence while allowing production traffic bursts. Rate limit headers (X-RateLimit-*) are included in every response so you can implement client-side backoff.
New users get 100 free trial credits after email verification — enough for five complete Guard workflows. There is no recurring free tier; once the trial is used, you can start with a $99 prepaid Starter Pack (pay-as-you-go) or a Developer subscription from $229/mo, which includes 60,000 credits. The website itself stays free to browse.
Every response includes a verification object that tells you whether the data came from an on-chain feed or an API source, with an explorer link when applicable.
Explore the full API reference for endpoint details, authentication, rate limits, error codes and code examples.
View API Reference