Welcome to the Somnia docs

Good to see you.What will you build?

Somnia runs order books, matching, oracles, agents and settlement as smart contracts on one fast EVM chain. Pick a path below and we’ll take you to the right page, or hand these docs to your coding agent and build together.

Find your path Build with your agent

Know what you’re after? Press ⌘K to search every page.

I want to…

Pick a path

Six common starting points, each with the pages that get you there.

New here

Get connected

Networks, wallets and testnet funds: everything you need before your first transaction.

Developers

Ship a smart contract

Deploy with the tools you already use, then test, verify and harden it for mainnet.

Traders

Trade or run a bot

Onchain order books for spot, perpetuals and event contracts, with APIs to automate them.

Venues

Launch a market or venue

Put your own markets on the shared engine, with your brand, your fees and sponsored gas.

Data

Bring the world onchain

Prices, outcomes and live events your contracts can read and react to.

Put AI agents to work

Consensus-validated compute: LLM calls, web parsing and API requests from a contract.

Agent-first docs

Hand the docs to your agent.

Every page is written so a coding agent can follow it. Pick a goal, paste the prompt into Claude, and it reads the whole corpus and builds with you on testnet.

A bot streaming a live order book and placing orders on testnet, fills visible in the explorer.

paste into Claude

Read https://docs.somnia.network/llms-full.txt, then build me a trading bot on Somnia testnet: pick a live market, stream its order book, place and cancel small post-only orders, and show my fills from the explorer API. Set up keys and testnet funds the way the docs describe, and ask me before anything touches mainnet.

The platform