OnChainFlows API

Build custom alerts, dashboards, and research pipelines with raw on-chain flow intelligence. Every endpoint returns normalized flow data with entity labels, confidence scores, and chain context.

12chains supported

350msmedian response time

99.98%uptime SLA

Quickstart

Create an API key in your workspace.
Whitelist your origin or server IP.
Send a signed request to /v1/flows/whales.

Base URLhttps://api.onchainflows.io

Overview

The OnChainFlows API exposes real-time and historical flow data across major chains, normalized into a single schema. Every event includes entity labeling, confidence scoring, and multi-chain context for quick integrations.

Streaming endpoints

Consume whale flows in under 5 seconds via server-sent events.

/v1/stream/whales

Historical archive

Query 4+ years of indexed entity flows and labeling.

/v1/archive

Entity graph

Map wallets, desks, and custodians into a unified view.

/v1/entities

Quickstart health check

GET /v1/status

Request

curl -X GET \
  "https://api.onchainflows.io/v1/status" \
  -H "x-ocf-key: ocf_live_xxxx" \
  -H "x-ocf-ts: 1731029871" \
  -H "x-ocf-signature: 3a19f1..."

Response

{
  "status": "ok",
  "region": "us-east-1",
  "timestamp": "2024-11-07T18:06:00Z",
  "ingestion_delay": "2.8s"
}

Whale transfer feed

GET /v1/flows/whales?chain=eth&min_value=50000000

Request

curl -X GET \
  "https://api.onchainflows.io/v1/flows/whales?chain=eth&min_value=50000000" \
  -H "x-ocf-key: ocf_live_xxxx" \
  -H "x-ocf-ts: 1731029871" \
  -H "x-ocf-signature: 5ea0d2..."

Response

{
  "count": 2,
  "data": [
    {
      "id": "flow_8b1d",
      "chain": "ethereum",
      "from": "Kraken",
      "to": "Unknown wallet",
      "asset": "ETH",
      "amount": 74210.44,
      "value_usd": 184200000,
      "confidence": 0.91,
      "tags": ["whale", "exchange_outflow"],
      "timestamp": "2024-11-07T18:04:21Z"
    }
  ]
}

Need help?

Schedule a 15-minute integration session with our team.