Skip to content
AnnouncementSomnia Oracle settles event contracts onchain, in minutes, with receipts.

Create your venue on shared liquidity.

Run your own markets, brand and fee on shared onchain infrastructure with the Somnia Markets SDK. This guide takes you through each step on the Global testnet, and only the last step touches mainnet.

Read the docs

New venue

Global testnet

Operator

0x7a3c…91e2Registered

Market type

Event markets

Fixed when the venue is created

Charged on event markets. Each market keeps the fee it was created with.

Fee recipient

0x7a3c…91e2Operator default

Market policy

Who can create markets on this venue

Venue structure

Operatorone addressYour venuefee · policyMarket AMarket BMarket CSomnia Markets · shared indexermarkets by the operator

Set up a venue in a few commands with Venue Kit.

You or a coding agent scaffold, register and launch a venue in a few commands. Venue Kit is a thin layer over the Somnia CLI and MCP server: a front-end template, the venue commands and an agent skill. Venue Kit is not yet available, so build on the Markets SDK for now.

Talk to an expert

Terminal

venue-kit

Concept
$ somnia venue init my-venue+ front-end template ready$ somnia venue create --network testnet? market type      event markets? venue fee        set by you? fee recipient    operator default? market policy    allowlist+ venue created on chain 50312$ somnia venue markets add --from question.json
  • Venue template

    A front end for your venue, with wallet connection, ready for your brand.

  • Venue commands

    Create the venue, list markets, set fees and attach liquidity, from testnet to mainnet.

  • Agent skill

    The same steps as MCP tools, so Claude Code, Cursor or any agent can set up a venue with you.

Venue Kit, the Somnia CLI and the Somnia MCP server are not yet available. Join waitlist to receive updates.

Keep your own brand and fee, and share the liquidity.

Every venue on Somnia Markets shares the same order books and one indexer, so yours opens on shared liquidity instead of building its own. Your markets, brand, fee and policy stay yours.

Yours

  • Your venuemarkets · brand · fee · policy
  • Venue Bmarkets · brand · fee · policy
  • Venue Cmarkets · brand · fee · policy

Shared

Somnia Markets · shared by every venue

  • Markets indexer
  • Somnia Oracle
  • Onchain settlement

Chain

Somnia L1

Yours

Markets
Event markets, the type fixed when you create the venue
Brand and front end
Built on the SDK and the indexer
Venue fee
Set in the venue config and paid to your address
Market policy
Who can create markets on your venue

Shared

Somnia Markets
Shared liquidity and matching for every venue
Indexer
One shared markets indexer
Visibility
Your venue appears in Somnia Explorer once on mainnet

Alternatively build your venue with a coding agent.

Paste this prompt into Claude Code, Cursor or any coding agent. It reads the Somnia docs as its source of truth and takes you through the same steps, on testnet first.

Venue agent

prompt.md

  1. Help me create a venue on Somnia, the modular chain layer for building markets. It is EVM-compatible, and order books, matching, oracles and settlement run onchain as smart contracts.

  2. Read the docs index at https://new.docs.somnia.network/llms.txt and the Somnia Markets SDK docs at https://new.docs.somnia.network/markets/somnia-markets. Treat them as the source of truth.

  3. Read the Somnia Explorer's https://new.explorer.somnia.network/llms.txt for the APIs you can use to check what's onchain.

  4. Use the Markets SDK to register my venue on the Global testnet (chain ID 50312) first. Ask me which markets to list, what venue fee to charge and which address receives it.

  5. Build a front end for it on the SDK and the indexer, and run it locally so I can try it.

  6. Ask me before deploying to mainnet (chain ID 5031) or spending real funds.

Reads
llms.txt, the Markets SDK docs and the Explorer APIs
Asks you
Which markets, what fee and which address receives it
Stops before
Mainnet or spending real funds

Plan your launch with the Somnia team.

Talk to an expert before you go live, or follow every step in the Markets SDK docs.

Talk to an expert