API Documentation

The fetchsblock API lets you stream real-time crypto wallet activity into your application. Create a stream for one or more wallets and receive decoded events through secure webhooks.

Authentication

All requests are authenticated with your secret API key, sent in theX-API-Keyheader.

curl https://api.fetchblockchain.com/v1/streams \
  -H "X-API-Key: fb_live_xxxxxxxxxxxx"

Create a wallet stream

Subscribe to wallet events by posting the addresses, chains, and event types you care about.

POST /v1/streams
{
  "addresses": ["0x217E26E4bE924256e0135BcEE6f4a5b4472D2989"],
  "chains": ["bsc", "ethereum", "tron"],
  "events": ["transfer", "balance", "swap"],
  "webhookUrl": "https://yourapp.com/hooks/fetch"
}

Webhook payload

Every matching event is delivered to your webhook URL as a signed JSON payload.

{
  "stream": "stm_abc123",
  "chain": "bsc",
  "type": "transfer",
  "wallet": "0x217E...2989",
  "token": { "symbol": "USDT", "decimals": 18 },
  "amount": "125.00",
  "usdValue": "125.00",
  "txHash": "0x9f...",
  "confirmedAt": "2026-06-09T12:47:21Z"
}

Supported chains

• • BNB Smart Chain (BEP20)
• • Ethereum (ERC20)
• • Tron (TRC20)
• • Polygon