One market stack. Four ways in.
Somnia is a modular chain for building markets. Venues, trading firms, brokers and wallets, and AI agents reach the same onchain order books, prices, oracle and USDso settlement, each through the interface that fits their job.
Status today
Somnia docs
- Spot markets
- Live on mainnet
- Event contracts
- Live
- Perpetuals
- Testnet · mainnet coming soon
- Tokyo Subchain
- Live
- Somnia Agents
- Prototype on mainnet
- Somnia CLI · MCP
- Coming soon
Venues (Create and run markets), Market makers (Quote on the books), Brokers & wallets (Route user orders), AI agents (Call, trade and resolve) each reach the shared services through the Markets SDK (contracts and indexer): Order books, Price-time matching in contracts; Price Feeds · Oracle, Reference prices and resolution; USDso settlement, Settles onchain, same block; Somnia Agents, Prototype · API, LLM, web jobs.
What each group gets, and where to start.
Every group reaches the same contracts. What changes is the job, the interface and the first step.
Four groups on one stack
Somnia Markets
Group
Your job
What Somnia runs
First step
Launch a branded market with your own fee and users
Order books, matching, oracle resolution, price feeds and settlement
Quote on books whose rules you can read
Price-time matching in contracts and settlement in the same block
Offer markets in your app and earn on spot flow you route
Shared books, builder fees on routed orders and smart accounts
Let agents read the web, trade and resolve markets onchain
Agent jobs agreed by validator subcommittees, and the same SDK traders use
Exchanges and trading venues. Launch a venue, not an exchange.
A venue is your market on Somnia infrastructure. You choose the markets, the brand, the users and the fee. Somnia runs the order books, matching, oracles and settlement onchain, and your markets trade on shared books, so liquidity is not split.
Register
registerOperator
Your address becomes an operator with a default fee recipient.
Create a venue
createVenue
Market type, first fee and policy are fixed at creation.
Set the fee
fee parameters
Event markets: venue fee and recipient. Spot: builder fee on routed orders.
Choose who lists
venue policy
Open market creation to everyone, or gate it.
Build the front end
Markets SDK
Trading, accounts, prices and the GraphQL indexer.
Watch it
Somnia Explorer
Venues, operators and their trading are public.
You decide
Per venue
- Markets
- Spot pairs, event contracts or both; perpetuals on testnet
- Fee
- Paid to your address as trades settle
- Brand
- Your own front end on the Markets SDK
- Users
- Open, or an allow-list; optional gas sponsorship
Somnia runs
Onchain
- Matching
- Order books and price-time matching in contracts
- Prices
- Somnia Price Feeds spot and mark
- Resolution
- Somnia Oracle for event contracts
- Settlement
- USDso, recorded on Somnia Explorer
Market makers and trading firms. Quote where the rules are code.
Orders rest in onchain books and match in a contract by price-time priority. Somnia Markets charges no protocol fee, and reference prices are published onchain for anyone to read.
Matching you can read
Price-time priority and deterministic ordering inside the block are published as open contract code. Every order, match and fill is an onchain event.
No protocol fee on Somnia Markets
Somnia charges nothing on top of trading. A venue may set its own fee, and network gas still applies.
Prices for quoting and margin
Somnia Price Feeds publishes a spot and a mark price about once a second, free for any contract to read.
Quoting on Somnia Markets
Status per docs
- Matching
- Price-time, in contracts
- Settlement
- Same block, in USDso
- Protocol fee
- None on Somnia Markets
- Prices
- Spot and mark, about 1 s
- Access
- Markets SDK · GraphQL indexer
- Spot
- Live on mainnet
- Perpetuals
- Testnet · mainnet coming soon
- Tokyo Subchain
- Live · trade execution around 3 ms
- Dedicated RPC
- Coming soon
Tokyo 100 ms blocks are separate from trade execution.
Brokers, fintechs and wallets. Offer markets without running one.
Route your users’ orders into the shared books on Somnia Markets. Matching and settlement run in contracts, so your product places orders and shows state. On spot markets, the orders you route can carry your builder fee.
A routed spot order, in order: Your app (Your interface), then Session key (Signs without a prompt), then Order + builder tag (Builder attribution), then Shared book (All venues, one book), then Fill (Same block), then Fee to your address (Spot markets).
Earn on flow you route
Spot orders can carry your builder attribution. The fee applies once the trader approves you as a builder, within the pool fee cap. Event markets use venue fee settings instead.
Fewer wallet prompts
Somnia Accounts pair a Safe smart account with a session key your app holds, so users act without a prompt each time. A session key is a full co-owner today; scoped limits are not shipped yet.
Money in and out
The LI.FI SDK brings swaps and bridging from 50+ chains into your app, and the Somnia docs list Banxa as a fiat on-ramp. Native gas sponsorship is coming soon; today, sponsor gas with ERC-4337.
AI agent builders. Agents that read, trade and resolve.
Somnia Agents let a contract call an API, run deterministic LLM inference or parse a website. A validator subcommittee runs each job and agrees on the result onchain. Agents trade the same books as people, through the same SDK and contracts.
Prototype on mainnet and testnet · features and APIs may change
Base agents
SOMI per subcommittee member, today
Agent
What it does
Price
JSON API Request
Fetches JSON from a public API and extracts a value
0.0003 SOMI
LLM Inference
Deterministic inference, including tool use
0.07 SOMI
LLM Parse Website
Reads a page in a real browser and extracts structured data
0.10 SOMI
Price Oracle
Weighted median token price across exchanges
0.0003 SOMI
Trade the same books
Agents use the Markets SDK and contracts like any other trader.
Resolve markets
Somnia Oracle reads named sources through agent subcommittees and posts the answer onchain.
Docs for coding agents
The Somnia docs are published as llms.txt. The Somnia MCP server is coming soon.
Tell us what you are building. We will point you to the first step.
Venue, trading desk, app or agent: the Somnia team can walk you through the contracts, the SDK and what is live today.