ThetaNuts API Documentation

Complete API reference for all ThetaNuts ecosystem services

Overview

The ThetaNuts ecosystem consists of multiple specialized services, each with its own API. This documentation provides comprehensive reference for all public endpoints across the platform.

Integrating with Thetanuts V4?

Start with the task handbook. It covers filling orders, RFQ, positions, settlement, Theta AMM vaults, launching your own site, and the design rules behind each product.

Open the handbook

What's new — September 2026

Current V4 indexer

Read presigned maker-order execution history under https://indexer.thetanuts.finance/api/v1/book and RFQ history under /api/v1/factory. Check indexed contracts, blocks and update times.

History integration guide · Contract callbacks and external webhooks · SDK reference

API reference

RPC Proxy

Base Network RPC Service

Provides CORS-enabled RPC proxy with automatic failover for Base network. Includes health monitoring, WebSocket support, and load balancing.

Health Check Status Monitoring WebSocket RPC Proxy
View Documentation

Older OptionBook Indexer

Core Options Blockchain Indexer

Separate OptionBook history service used by existing Base apps. New SDK integrations use indexer.thetanuts.finance for book execution and RFQ history; the hosts have different paths and schemas.

Options Data Event Indexing User Positions Real-time Stats
View Documentation

Legacy OptionFactory API

Retired service

The old OF indexer is decommissioned. Use the current V4 RFQ indexer and its SDK integration guide.

Retired — 10 October 2026 RFQs Offers Options User Data
Archived API format

Nut Ecosystem

AI Assistant & Analytics

AI-powered ecosystem assistant with market data, news analysis, options data, and conversational AI capabilities.

AI Chat Market Data News Analysis Options Data
View Documentation

MM Worker

Market Making Orders

Manages market making orders with real-time caching, R2 storage, and historical data archiving for market analysis.

Order Management Historical Data R2 Storage API Key Auth
View Documentation

Deribit Worker

Options Data Proxy

Proxies and filters Deribit options data with tolerance-based filtering to ensure data quality and relevance.

Data Filtering Tolerance Checks ETH/BTC Options Real-time Cache
View Documentation

Analytics Worker

Market Intelligence

Comprehensive Deribit analytics with key levels, options flow analysis, and professional-grade market intelligence.

17+ Indicators Key Levels Flow Analysis Tiered Cache
View Documentation

Kyber Proxy

Price Discovery

Proxy service that interfaces with KyberSwap API for price path discovery and route encoding across multiple blockchain networks.

Offline 20+ Chains Route Encoding Multi-Chain CORS Proxy
View Documentation

1inch Proxy

Swap Routing

Proxy service that interfaces with 1inch API for token swap routing and price discovery across multiple blockchain networks.

Offline API v6.1 Route Optimization Multi-DEX Bearer Auth
View Documentation

Network Information

Primary Network

Base Mainnet (Chain ID: 8453)

RPC Providers

Infura Base, Ankr Base with automatic failover

Data Sources

On-chain events, external APIs, real-time market data

Update Frequency

Real-time event indexing with configurable batch processing

Security & CORS

All APIs implement CORS protection with whitelisted origins. Each service has specific CORS configurations appropriate for its use case. Authentication and rate limiting are implemented where necessary.

Common Response Formats

Success Response
{ "status": "success", "data": { ... }, "timestamp": "2024-01-01T00:00:00.000Z" }
Error Response
{ "status": "error", "message": "Error description", "code": 400, "timestamp": "2024-01-01T00:00:00.000Z" }