TaifoonTAIFOON
TAIFOON PROTOCOL — API SURFACE

UNIVERSAL API ENDPOINTS

21 endpoints across 5 grids. Cryptographic proofs, finality verification, event indexing, oracle pricing, and trading signals — all under one SuperRoot.

CHAINS
—live
BLOCKS
—indexed
GRIDS
5domains
ENDPOINTS
21available
G13 ENDPOINTS

Core Proofs

SuperRoot + block inclusion — the foundation

The SuperRoot is Taifoon's global anchor — a single hash binding every chain's MMR tree into one cryptographic root. Every proof traces back here.

EXAMPLE
curl https://taifoon.io/v5/superroot
RESPONSE
{ "superroot_hash": "0x7f9f...", "chain_count": 41, "batch_id": 184209 }
EXAMPLE
curl https://taifoon.io/api/v5/proof/blob/1/21000000
RESPONSE
{ "superroot": {...}, "chain_header": {...}, "block_proof": { "siblings": [...] }, "finality": {...} }
EXAMPLE
curl https://taifoon.io/api/mmr/superroot/breakdown
RESPONSE
{ "chains": [{ "chain_id": 1, "block_count": 21482901, "mmr_root": "0x..." }] }
G25 ENDPOINTS

Proof Types

Transaction · Receipt · Order — trustless verification

Three proof primitives cover every on-chain action: transaction inclusion (MPT), event/receipt proofs (log-level), and protocol order bundles (multi-step).

EXAMPLE
curl https://taifoon.io/v5/proof/tx/1/0xabc...def
RESPONSE
{ "tx": {...}, "proof": { "siblings": [...], "receipt_root": "0x..." }, "superroot": "0x..." }
EXAMPLE
curl https://taifoon.io/v5/proof/event/137/65000000/12/0
RESPONSE
{ "event": {...}, "receipt_proof": { "siblings": [...] }, "block_proof": {...} }
EXAMPLE
curl https://taifoon.io/api/lambda/proof-bundle/ord_0x3f...
RESPONSE
{ "order_id": "...", "proofs": [{ "step": "SRC_LOCK", "v5_blob": {...} }, ...] }
EXAMPLE
curl https://taifoon.io/api/tx/1/0xabc...def/with-proof
EXAMPLE
curl https://taifoon.io/api/chain/1/block/21000000/receipts
G33 ENDPOINTS

Finality

14 finality types — when blocks become permanent

From Ethereum PoS checkpoints to Solana Tower BFT to GRANDPA parachains. Each chain's finality proof confirms irreversibility with chain-native evidence.

EXAMPLE
curl https://taifoon.io/api/spinner/para-finality
EXAMPLE
curl https://taifoon.io/api/spinner/commitment/1
RESPONSE
{ "chain_id": 1, "finality_type": "ETH_POS_CHECKPOINT", "finalized_block": 21482901 }
EXAMPLE
curl https://taifoon.io/api/mmr/chain/1/block/21000000/proof
RESPONSE
{ "siblings": [...], "root": "0x...", "leaf_index": 21000000 }
G43 ENDPOINTS

Lambda Orders

Protocol order lifecycle — detection to proof

Track cross-chain protocol orders from source lock through destination execution. Every step gets a V5 proof bundle for trustless settlement.

EXAMPLE
curl https://taifoon.io/v5/orders/decoded?limit=5
RESPONSE
{ "orders": [{ "id": "...", "protocol": "t3rn", "state": "EXECUTED", ... }] }
EXAMPLE
curl https://taifoon.io/api/lambda/delivery-trace/ord_0x3f...
EXAMPLE
curl https://taifoon.io/api/lambda/t3rn/orders/stats
RESPONSE
{ "total": 12847, "executed": 11902, "pending": 945 }
G57 ENDPOINTS

Signals & Trading

Real-time streams · Oracle · Sniper · Token Watch

Complete trading signal surface for AI agents: SSE streams for launches and arbitrage, credit-metered oracle pull API, DEX sniper signals with quality scores, token watch alerts (whale, dump, wind-up), and universal bloom search.

EXAMPLE
curl -N https://taifoon.io/signals/launches
RESPONSE
data: { "symbol": "HYPER", "chain": 8453, "liquidity_usd": 142000, "pool": "0x..." }
EXAMPLE
curl -N https://taifoon.io/signals/arb
RESPONSE
data: { "pair": "ETH/USDC", "spread_bps": 12, "chains": [1, 42161], "route": "uniswap→sushi" }
EXAMPLE
curl https://taifoon.io/jobs/signals/sniper/all/stats
RESPONSE
{ "chains": [{ "chain_id": 8453, "signals_24h": 142, "avg_quality": 72.3 }] }
EXAMPLE
curl -H 'X-Taifoon-Key: ...' https://taifoon.io/api/oracle/signals?signal_type=token_launch&limit=10
RESPONSE
{ "signals": [...], "credits_consumed": 30, "remaining": 970 }
EXAMPLE
curl -N https://taifoon.io/api/token-watch/alerts/stream
RESPONSE
data: { "alert": "WindUp", "entity": "CEX", "token": "TRN", "chain": 42161 }
EXAMPLE
curl https://taifoon.io/api/dex/launches/8453
RESPONSE
{ "launches": [{ "pool": "0x...", "token0": "ETH", "tvl": 89000 }] }
EXAMPLE
curl -X POST https://taifoon.io/bloom/query -d '{"address":"0x..."}'
RESPONSE
{ "matches": [{ "chain_id": 1, "blocks": [21000001, 21000045] }] }
BASE URL
api.taifoon.dev
AUTHENTICATION
X-Taifoon-Key header
100 req/min (no key) · 5,000 req/min (paid)
RESPONSE FORMAT
JSON + V5 proof anchors
Merkle siblings for trustless verification