# Welcome

> Somnia is the decentralized platform for onchain finance: order books, matching, oracles, agents and settlement running onchain on a high-throughput EVM network.

Somnia runs order books, matching, oracles, agents and settlement as smart contracts on one fast EVM chain, so a venue built on Somnia inherits the same liquidity, the same receipts and the same tooling as every other venue. Pick a path below, or hand these docs to your coding agent: the full corpus is at [llms-full.txt](https://docs.somnia.network/llms-full.txt). To see the platform running first, open the [Somnia Explorer](https://explorer.somnia.network).

## New to Somnia? Start here

Four steps from zero to a contract on testnet:

1. [Add Somnia to your wallet](/blockchain/connect-a-wallet)
2. [Get testnet STT from the faucet](/blockchain/faucet)
3. [Deploy your first contract](/developer/development-frameworks/deploy-with-hardhat)
4. [Verify it in the Somnia Explorer](/developer/development-frameworks/verifying-via-explorer)

## Pick a path

- **Get connected**: networks, wallets and testnet funds. [Somnia networks](/blockchain/networks), [public RPCs](/blockchain/rpcs) and [bridging tokens](/blockchain/bridge).
- **Ship a smart contract**: deploy with the tools you already use, then test, verify and harden it. [Deploy with Foundry](/developer/development-frameworks/deploy-with-foundry), [use viem](/developer/development-frameworks/using-the-viem-library) and the [audit checklist](/developer/security/audit-checklist).
- **Trade or run a bot**: onchain order books for spot, perpetuals and event contracts. [Somnia Markets](/markets/somnia-markets), [perpetual futures](/markets/perpetuals) and the [API, MCP & SDK](/build/api).
- **Launch a market or venue**: your own markets on the shared engine. [Somnia Venues](/markets/venues), the [Venue Kit](/build/venue-kit) and the [go-live checklist](/developer/deployment-and-production/go-live-checklist).
- **Bring the world onchain**: prices, outcomes and live events. The [Somnia Oracle](/data/somnia-oracle), [Price Feeds](/data/price-feeds) and [Reactivity](/developer/reactivity).
- **Put AI agents to work**: LLM calls, web parsing and API requests from a contract. [Somnia Agents](/agents/somnia-agents), [LLM Inference](/agents/llm-inference) and [JSON API Request](/agents/json-api-request).

## Hand the docs to your agent

Every page is written so a coding agent can follow it. Pick a goal and paste the prompt into your agent. The [MCP server](/build/mcp) and the [Somnia CLI](/build/cli) let it operate what you build.

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

> 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.

**Your own market, in an hour**: a market you defined, resolved by the Somnia Oracle, trading on an existing venue.

> Read https://docs.somnia.network/llms-full.txt, then take me from an idea to a live market on Somnia testnet: the market definition, the Somnia Oracle question that resolves it, seed liquidity and settlement. Ask me for the market question before you start.

**A venue, in a day**: a branded venue on testnet with its own markets and sponsored gas, ready for the go-live checklist.

> Read https://docs.somnia.network/llms-full.txt, then set up the Somnia Venue Kit in a new repository and take me to a branded venue on Somnia testnet with sponsored gas: the template, venue registration, markets and the go-live checklist.

## Explore every section

The docs open on Developers, then follow the sections of the Somnia Explorer's sidebar, with a page for every product in each:

- **[Developers](/build)**: the Somnia CLI, MCP server and Venue Kit, every API and SDK, and the developer guide.
- **[Blockchain](/blockchain)**: the Global L1 and Regional Subchains: networks, RPCs, the explorer, faucet and validators, the bridge, accounts, reactivity and gas sponsorship.
- **[Markets](/markets)**: spot, perpetual and event markets on one onchain matching engine; venues and analysis.
- **[Data & Truth](/data)**: prices and real-world outcomes, delivered onchain with provenance: the oracle and price feeds.
- **[Agents](/agents)**: consensus-validated compute for smart contracts: Somnia Agents and its agent types, from LLM inference to price oracles.
- **[Settlement & Liquidity](/settlement)**: USDso, Somnia Lend and privacy (coming soon).
- **[Prediction Markets](/prediction-markets)**: trade the outcome of real-world events, settled by the Somnia Oracle: Prophecy Pulse (coming soon).

Reading rather than building: [Concepts](/concepts), [how the chain works](/concepts/somnia-blockchain/overview) and [tokenomics](/concepts/tokenomics/overview). Bringing capital or infrastructure: [staking](/concepts/tokenomics/token-staking-and-delegation), [validators](/blockchain/validators), [dedicated RPC](/blockchain/rpcs/dedicated-rpc) and [sustained-use gas discounts](/developer/deployment-and-production/sustained-use-gas-discounts).

## Get help

The [developer FAQs](/developer/deployment-and-production/support-and-community/developer-faqs), the [Somnia Discord](https://discord.com/invite/somnia), [network status](https://status.somnia.network) and the [Somnia Explorer](https://explorer.somnia.network).

---

Every page is also Markdown: append `.md` to its URL, or ask for `text/markdown`. Found something wrong, missing or confusing in these docs? Tell us: `POST /api/feedback` on this site with JSON `{"message": "…", "context": "what you were doing and what happened", "page": "…"}`, or a plain-text body. `GET /api/feedback` gives the JSON Schema. The team reads every one.
