# Wormhole Cross-Chain API
> Cross-chain messaging and bridging activity across the Wormhole network — one of crypto's largest interoperability protocols, carrying messages and bridged value between 30+ blockchains (Ethereum, Solana, the major L2s, BNB Chain, Sui, Aptos and more) — live from the public Wormholescan API, no key. Over its life Wormhole has relayed well over a billion messages; cross-chain volume is a core health metric of the multi-chain economy: how much value is actually moving between ecosystems, which chains are the busiest source of that flow, and which assets are being bridged. The stats endpoint is the global scorecard: total messages ever relayed, total bridged volume and the value locked, plus message counts and volume over the last 24 hours, 7, 30, 90 days and a year. The chains endpoint ranks the blockchains by their cross-chain transfer activity over the last day — the number of transfers leaving each chain and the dollar volume — so you can see which ecosystems are the busiest exporters of value. The assets endpoint ranks the tokens being bridged the most by dollar volume. This is the cross-chain messaging / bridge-flow cut — distinct from single-bridge feeds (Across, THORChain), the DeFi-TVL and DEX feeds, and the on-chain and price feeds. Volumes and value locked are in US dollars; everything is live. Built for crypto cross-chain analytics, bridge monitoring and multi-chain dashboards.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/wormhole-api/..."
```

## Pricing
- **Free** (Free) — 1,010 calls/Mo, 2 req/s
- **Starter** ($13/Mo) — 21,200 calls/Mo, 6 req/s
- **Pro** ($36/Mo) — 115,000 calls/Mo, 16 req/s
- **Mega** ($81/Mo) — 634,000 calls/Mo, 40 req/s

## Endpoints

### Stats

#### `GET /v1/stats` — Global Wormhole scorecard

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wormhole-api/v1/stats"
```

**Response:**
```json
{
    "data": {
        "note": "The global Wormhole cross-chain scorecard: total messages ever relayed and total bridged volume over the network's life, the current value locked, and message counts and bridged volume (USD) over the last 24 hours, 7, 30, 90 days and a year. A read on how much value is moving between blockchains. Live, cached ~60s.",
        "source": "Wormholescan public API (api.wormholescan.io), keyless",
        "tvl_usd": 2159954176,
        "messages": {
            "1y": 77439987,
            "7d": 1348030,
            "24h": 186555,
            "30d": 5887518,
            "90d": 18131059
        },
        "volume_usd": {
            "1y": 25093587528,
            "7d": 176653652,
            "24h": 21431221,
            "30d": 905078888,
            "90d": 3109882429
        },
        "total_messages": 1185740202,
        "total_volume_usd": 76882164630,
        "total_transactions": 8724860
    },
    "meta": {
        "timestamp": "2026-06-12T19:36:09.578Z",
        "request_id": "ad8ccd12-6f70-47ec-8d66-0e344a2d2ecb"
    },
    "status": "ok",
    "message": "Stats retrieved successfully",
    "success": true
}
```

### Chains

#### `GET /v1/chains` — Blockchains ranked by cross-chain activity (24h)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wormhole-api/v1/chains"
```

**Response:**
```json
{
    "data": {
        "note": "Blockchains ranked by their Wormhole cross-chain transfer activity over the last 24 hours — the number of transfers leaving each chain (as the source/emitter) and the dollar volume — showing which ecosystems are the busiest exporters of value across chains. Volumes are converted from Wormhole's fixed-point to US dollars. Live, cached ~60s.",
        "count": 24,
        "chains": [
            {
                "chain": "Solana",
                "chain_id": 1,
                "transfers": 343,
                "volume_usd": 2814289
            },
            {
                "chain": "Ethereum",
                "chain_id": 2,
                "transfers": 434,
                "volume_usd": 1427446
            },
            {
                "chain": "Linea",
                "chain_id": 38,
                "transfers": 2,
                "volume_usd": 1001105
            },
            {
                "chain": "Base",
                "chain_id": 30,
                "transfers": 419,
                "volume_usd": 516233
            },
            {
                "chain": "Arbitrum",
                "chain_id": 23,
                "transfers": 73,
                "volume_usd": 486471
            },
            {
                "chain": "Avalanche",
                "chain_id": 6,
                "transfers": 114,
                "volume_usd": 331873
            },
            {
                "chain": "Unichain",
                "chain_i
…(truncated, see openapi.json for full schema)
```

### Assets

#### `GET /v1/assets` — Top tokens bridged by volume

**Parameters:**
- `timespan` (query, optional, string) — Window: 7d, 15d or 30d Example: `7d`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wormhole-api/v1/assets?timespan=7d"
```

**Response:**
```json
{
    "data": {
        "note": "The tokens bridged the most across Wormhole by dollar volume over the chosen window — which assets are actually moving between chains (stablecoins, ETH, wrapped majors and the rest), each with its native chain and the volume in USD. Pass timespan (7d, 15d or 30d; default 7d). Live, cached ~60s.",
        "count": 7,
        "assets": [
            {
                "symbol": "hype",
                "volume_usd": 12535769,
                "token_chain": "Solana",
                "emitter_chain": "Solana",
                "token_address": "78e17ff9cf9ef28b15e3d5832741ece7804e07d5c97f42ef33ed5f059c74925f",
                "token_chain_id": 1
            },
            {
                "symbol": "WETH",
                "volume_usd": 11870854,
                "token_chain": "Ethereum",
                "emitter_chain": "Ethereum",
                "token_address": "000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "token_chain_id": 2
            },
            {
                "symbol": "WETH",
                "volume_usd": 1505849,
                "token_chain": "Ethereum",
                "emitter_chain": "Solana",
                "token_address": "000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "token_chain_id": 2
            },
            {
                "symbol": "Velvet",
                "volume_usd": 1339870,
                "token_chain": "BNB Chain",
                "
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/wormhole-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "stats and chains and meta take no parameters; assets takes timespan (7d, 15d or 30d; default 7d). Volumes and value locked are in US dollars (cross-chain transfer volumes converted from Wormhole's fixed-point). Chain IDs are Wormhole's canonical identifiers mapped to names. A short ~60-second protective cache fronts the upstream.",
        "source": "Wormholescan public API (api.wormholescan.io), keyless, live",
        "service": "wormhole-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/stats": "Global Wormhole scorecard — messages, volume, TVL over 24h/7d/30d/90d/1y.",
            "GET /v1/assets": "Top tokens bridged by volume (timespan 7d/15d/30d).",
            "GET /v1/chains": "Blockchains ranked by cross-chain transfer activity over the last 24h."
        },
        "scorecard": {
            "tvl_usd": 2159954176,
            "24h_messages": 186555,
            "total_messages": 1185740202
        },
        "description": "Cross-chain messaging and bridging activity across the Wormhole network — one of crypto's largest interoperability protocols, carrying messages and value between 30+ blockchains — live from the public Wormholescan API (no key). It exposes the global scorecard (total messages, bridged volume, value locked, and activity over 24h/7d/30d/90d/1y), the blockchains ranked by their cross-chain transfer activity over the last day, and the tokens being bridged the most by
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/wormhole-api
OpenAPI spec: https://www.oanor.com/api/wormhole-api/openapi.json
