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

Whale flows

Query high-impact whale transfers across supported chains with filters for chain, value thresholds, and entity types.

GET

/v1/flows/whales

List high-impact whale transfers across supported chains.

chain

string

Filter by chain (eth, sol, btc).

min_value

number

Minimum USD value threshold.

entity_type

string

exchange, fund, otc, or wallet.

ReturnsFlowEvent[]

GET

/v1/flows/{flow_id}

Retrieve a single flow event with full entity context.

flow_id

string

Unique flow identifier.

include_graph

boolean

Include counterparties.

format

string

json or csv export.

ReturnsFlowEvent

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"
    }
  ]
}

Flow detail

GET /v1/flows/flow_8b1d?include_graph=true

Request

curl -X GET \
  "https://api.onchainflows.io/v1/flows/flow_8b1d?include_graph=true" \
  -H "x-ocf-key: ocf_live_xxxx" \
  -H "x-ocf-ts: 1731029871" \
  -H "x-ocf-signature: d41f2c..."

Response

{
  "id": "flow_8b1d",
  "chain": "ethereum",
  "from": "Kraken",
  "to": "Unknown wallet",
  "graph": ["Kraken", "Unknown wallet", "Cold storage"]
}

Need help?

Schedule a 15-minute integration session with our team.