OneSource REST API & MCP Server
A REST and MCP interface to live EVM data: balances, NFTs, transactions, events, contracts, ENS, and chain utilities, plus Deepstate protocol market data on Robinhood Chain. Serves Ethereum mainnet by default for chain data, plus the Sepolia testnet and Robinhood Chain via the network parameter. Designed for AI agents and apps that need fresh, on-chain answers without running their own node.
- Base URL:
https://api.onesource.io - MCP server:
@one-source/mcpon npm - OpenAPI:
/openapi.json - AI-optimized docs:
/llms-full.txt
Three ways to access
| Access path | How you authenticate | Best for |
|---|---|---|
| API key | Authorization: Bearer sk_… | Production apps, predictable monthly billing via Stripe |
| MCP server | ONESOURCE_API_KEY=sk_… (or an x402 / MPP wallet) | AI assistants: Claude Code, Claude Desktop, Cursor, Windsurf |
| x402 / MPP | USDC on Base (x402) or USDC.e on Tempo (MPP) | Pay-per-call from agents, no signup required |
See Getting Started to pick a path.
Response envelope
Every /api/* response is wrapped:
{ "data": { ... }, "error": null, "meta": { "endpoint": "/api/chain/network-info", "request_id": "…" } }
On failure, data is null and error is { code, message }. Standard HTTP status codes apply (200, 400, 401, 403, 404, 429).
Deepstate market data (/deepstate/v1/*) does not use this envelope; see its own response shape.
What's covered
- Chain RPC:
eth_call, gas estimate, code, nonce, storage, receipts, blocks, pending block, network info - Balances: ETH + ERC20 (batched), ERC1155, ERC20 allowances and total supply
- NFTs: ownership, metadata with IPFS/Arweave resolution, ERC721 token enumeration
- Logs:
eth_getLogs, ERC20 transfer history - ENS: forward resolution
- Identity: proxy detection, contract introspection
- Deepstate market data: order books, trades, candles, stats, maker analytics, gas cost-to-quote, and depth history for the Deepstate protocol on Robinhood Chain
- Free utilities: pricing, health, OpenAPI, sitemap, llms.txt
Full endpoint catalog: API Reference. Deepstate's own reference: Deepstate Market Data.