Transfer notifications
Watch wallet addresses, parse multi-chain transfers, and store them. Manage the list and query history over HTTP; receive hits over WebSocket or webhook.
Requires X-API-Key. The public WebSocket path is /tx/ws, not /tx/api/v1/transaction/ws.
Capabilities
| Capability | Entry |
|---|---|
| Add / remove watches | POST /tx/api/v1/addresses |
| Exclude addresses from push | POST /tx/api/v1/addresses/exclusions |
| History | POST /tx/api/v1/transfers/search |
| Live push | wss://gateway.gelabs.org/tx/ws |
| Outbound webhook | PUT /tx/api/v1/app/config |
Supported networks
Identify a network with chain_type (family) + chain_id. chain_type is one of evm / svm / tvm / utxo (case-insensitive):
| Network | Family | chain_id |
|---|---|---|
| Ethereum | evm | 1 |
| Sepolia | evm | 11155111 |
| BSC | evm | 56 |
| Polygon | evm | 137 |
| Arbitrum | evm | 42161 |
| Optimism | evm | 10 |
| Base | evm | 8453 |
| Solana Mainnet | svm | 1 |
| Tron Mainnet | tvm | 728126428 |
| Bitcoin Mainnet | utxo | 1 |
WebSocket frames are {id,time,type,code,data,message}. Webhooks are POST of a JSON array with a Sign header. Shapes: API reference.
Next: Quick start.