Core OptionBook Contract Indexer - Tracks events from OptionBook contract on Base network
This page documents the older optionbook-indexer.thetanuts.finance/api/v1 service used by existing apps. It is separate from the current V4 SDK indexer.
For new SDK integrations, use https://indexer.thetanuts.finance/api/v1/book for presigned maker-order execution history and /api/v1/factory for RFQs. Check book stats, factory stats, and the current SDK guide.
Do not copy the paths or response shapes below onto the current host. Check indexed contracts and checkpoints for the service you use. The separate old OF indexer is retired.
Indexes and tracks events from OptionBook contract on Base network, providing API access to options data and trading analytics.
Base Mainnet (Chain ID: 8453)
OptionBook: 0x1bDff855d6811728acaDC00989e79143a2bdfDed
36605331
Every 5 minutes (cron trigger)
Real-time event indexing, user position tracking, options data aggregation, and trading analytics.
Address: 0x71041dddad3595f9ced3dccfbe3d1f4b0a16bb70
Decimals: 8
Address: 0x64c911996d3c6ac71f9b455b1e8e7266bcbd848f
Decimals: 8
Address: 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
Decimals: 6
Address: 0x4200000000000000000000000000000000000006
Decimals: 18
Address: 0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf
Decimals: 8
ETH Call (Inverse Vanilla Call)
ETH Put (Vanilla Put)
10 seconds - Minimum time between manual updates
50,000 blocks - Maximum blocks per RPC batch
15 seconds - Cache validity period
Returns the full internal state object including all positions, user mappings, and events. This endpoint is useful for debugging and administration.
| Parameter | Type | Required | Description |
|---|---|---|---|
| address | string | Required | Option contract address |
| Parameter | Type | Required | Description |
|---|---|---|---|
| address | string | Required | User's Ethereum address |
| type | string | Required | Either "positions" or "history" |
This API allows cross-origin requests from all origins (Access-Control-Allow-Origin: *) to facilitate easy integration.