Insight Logo
Insight
HomePrice Query
Documentation
Insight LogoInsight

Comprehensive analysis and comparison of mainstream oracle protocols, empowering Web3 developers and analysts to make informed decisions.

Platform

  • Home
  • Price Query
  • Cross-Oracle Comparison
  • Cross-Chain Comparison
  • Oracle Reputation
  • Price Snapshots
  • Price Alerts

Resources

  • Documentation
  • GitHub

© 2026 Insight. All rights reserved.

Privacy PolicyTerms of ServiceContact
○

Documentation Center

Learn how to use the Insight oracle data platform for real-time price monitoring, cross-oracle comparison, and deep data analysis.

Quick Links:Quick StartFeatures GuideAPI Reference

Quick Start Guide

Get started with Insight in just a few steps

Platform Overview

Insight aggregates price data from 10 oracle providers across 54+ blockchains to provide comprehensive market insights, consensus pricing, and oracle reliability analysis.

10 oracle providers
54+ blockchains
6 consensus algorithms

Getting Started

1

Query Prices

Select an oracle provider, blockchain, and token to get real-time prices with on-chain data

2

Compare & Analyze

Cross-oracle comparison with consensus price, cross-chain analysis with heatmap, and reputation scores

3

Monitor & Alert

Set price alerts, save snapshots for comparison, and track oracle reputation over time

Start SearchingCompare OraclesView Reputation

Features Guide

Explore all the features Insight has to offer

Price Query

Query real-time prices from any oracle provider with on-chain data, confidence intervals, and auto-refresh

10 oracle providers with cascade filtering
On-chain data and confidence intervals
Auto-refresh and keyboard shortcuts
Learn More

Cross-Oracle Comparison

Compare prices across oracle providers with consensus price, divergence signals, and risk analysis

6 consensus algorithms (median, trimmed mean, etc.)
Divergence signals and anomaly detection
Feed health, risk metrics, and stability scores
Learn More

Cross-Chain Comparison

Analyze price differences across blockchains with heatmap visualization and chain ranking

Price spread heatmap across chains
Risk analysis with 10 dimensions
Chain reliability ranking and divergence signals
Learn More

Oracle Reputation

Persistent 7-day rolling reputation scores with accuracy, uptime, reliability, latency, and freshness metrics

7-day rolling aggregated scores
5-metric evaluation (accuracy, uptime, reliability, latency, freshness)
Provider detail pages with trend charts
Learn More

Price Alerts

Set up custom price alerts with real-time event push and preset templates

Threshold-based alerts with templates
Real-time event push notifications
Alert history and batch operations
Learn More

Price Snapshots

Save price snapshots and compare them across time with detailed analytics

Save and share price snapshots
Snapshot comparison with change analytics
Public/private visibility control
Learn More

Real-time Updates

Live data with auto-refresh

10 Oracle Providers

Chainlink, Pyth, API3, RedStone, DIA, and more

Multi-format Export

CSV, JSON, Excel, PDF, PNG

Technical Documentation

Deep dive into our technical implementation and architecture

Methodology

Learn about our data collection, validation methodology, and consensus algorithms

Data QualityValidationConsensus
Read More

API Documentation

Integrate with our V1 REST API for real-time and historical price data with API Key authentication

REST APIAPI KeyOpenAPI 3.1
Read More

Architecture

Next.js App Router with Supabase, React Query, Zustand, and 10 oracle client implementations

Next.jsSupabaseTypeScript
Read More

Data Sources

10 oracle providers including Chainlink, Pyth, API3, RedStone, DIA, WINkLink, Supra, TWAP, Reflector, and Flare

10 Oracles54+ ChainsOn-chain Data
Read More

API Preview

Requires API Key
GET/api/v1/price/BTC%2FUSD
Get aggregated price across all oracles
# Symbol with "/" must be URL-encoded: BTC/USD → BTC%2FUSD
{
  "success": true,
  "data": {
    "symbol": "BTC/USD",
    "aggregatedPrice": 81345.37,
    "priceRange": {
      "min": 80749.27, "max": 81424.37,
      "average": 81234.50, "median": 81340.50,
      "spread": 675.10, "spreadPercent": 0.83
    },
    "providerCount": 10,
    "providers": [
      {
        "provider": "chainlink",
        "price": 81345.37,
        "timestamp": 1700000000000,
        "confidence": 0.97
      }
    ]
  }
}
GET/api/v1/consensus/BTC%2FUSD?method=median
Get consensus price with configurable aggregation method
{
  "success": true,
  "data": {
    "symbol": "BTC/USD",
    "consensus": {
      "price": 81340.50,
      "method": "median",
      "methodLabel": "Median",
      "confidence": 0.95,
      "confidenceLevel": "high",
      "agreement": 0.97,
      "participantCount": 10,
      "excludedCount": 0,
      "recommendedMethod": "iqr_filtered"
    }
  }
}
GET/api/v1/oracles/chainlink?symbol=BTC
Query price from a specific oracle (symbol is required)
{
  "success": true,
  "data": {
    "provider": "chainlink",
    "price": 81345.37,
    "timestamp": 1700000000000,
    "confidence": 0.97,
    "confidenceInterval": { "lower": 81300, "upper": 81390 },
    "source": "BTC / USD"
  },
  "meta": {
    "provider": "chainlink",
    "symbol": "BTC",
    "chain": null
  }
}
GET/api/v1/price/BTC%2FUSD/history?provider=chainlink
Historical data requires the provider parameter
{
  "success": true,
  "data": [...],
  "meta": { "provider": "chainlink", "symbol": "BTC/USD" }
}

Developer Resources

Integration guides and technical support for developers.

Integration Guide

Learn how to integrate Insight API into your application

Learn More

Code Examples

View API call examples in JavaScript and TypeScript

Learn More

FAQ

View common developer questions and solutions

Learn More

Code Examples

// Aggregated price query
// Query BTC aggregated price (API Key required)
const response = await fetch(
  '/api/v1/price/BTC%2FUSD',
  {
    headers: {
      'x-api-key': 'ik_your_api_key'
    }
  }
);
const data = await response.json();

console.log(data.data.aggregatedPrice); // 81345.37
console.log(data.data.providerCount);   // 10
// Single oracle, consensus & historical query
// Query price from a specific oracle
const response = await fetch(
  '/api/v1/oracles/chainlink?symbol=BTC',
  {
    headers: {
      'x-api-key': 'ik_your_api_key'
    }
  }
);
const data = await response.json();

// Consensus price with specific method
const consensus = await fetch(
  '/api/v1/consensus/BTC%2FUSD?method=median',
  {
    headers: {
      'x-api-key': 'ik_your_api_key'
    }
  }
);

// Historical data requires provider parameter
const history = await fetch(
  '/api/v1/price/BTC%2FUSD/history?provider=chainlink&period=24',
  {
    headers: {
      'x-api-key': 'ik_your_api_key'
    }
  }
);

FAQ

How do I authenticate API requests?

All data endpoints require an API key. Pass it via the x-api-key header (x-api-key: ik_xxx) or the Authorization header (Authorization: Bearer ik_xxx). Create API keys at /api/v1/api-keys after signing in.

What are the API rate limits?

Free plan: 60 requests/minute. Pro plan: 600 requests/minute. Enterprise plan: 6,000 requests/minute. Rate limits are per API key.

How should I format the symbol in the URL?

Symbols containing "/" must be URL-encoded. For example, BTC/USD should be sent as BTC%2FUSD in the URL path. Example: /api/v1/price/BTC%2FUSD.

What consensus algorithms are available?

The /api/v1/consensus endpoint supports 4 methods: median, trimmed_mean, weighted_median, and iqr_filtered. If not specified, the best method is auto-selected based on data characteristics.

Why does the history endpoint require a provider?

Historical data is provider-specific and cannot be aggregated across oracles. You must specify which oracle provider to query, e.g., ?provider=chainlink.

How do I get an API key?

After registering and signing in, you can generate API keys via the /api/v1/api-keys endpoint. Each user can have up to 5 active keys. The full key is only shown once at creation.

What oracle providers are supported?

We support 10 oracle providers: chainlink, pyth, api3, redstone, dia, winklink, supra, twap, reflector, and flare. Each provider may support different blockchains and trading pairs.