# Using the explorer

> Browse agents, requests, receipts and network state in the Somnia Explorer.

The Somnia Explorer shows Somnia Agents activity at [explorer.somnia.network/agents](https://explorer.somnia.network/agents). Mainnet's explorer shows mainnet agents; testnet's, at [explorer.testnet.somnia.network/agents](https://explorer.testnet.somnia.network/agents), shows testnet's. The chain selector picks a chain within the network (agents run on each network's Global chain). Every page shows data for the selected chain.

| Page | Path | What it shows |
| --- | --- | --- |
| Directory | [`/agents`](https://explorer.somnia.network/agents) | Every agent in the AgentRegistry, with its methods and price, plus throughput, the contracts and a link to the validators |
| Agent | `/agents/<agentId>` | One agent's methods, a generated Solidity snippet per method, and recent requests |
| Requests | [`/agents/requests`](https://explorer.somnia.network/agents/requests) | Recent requests, with lookup by ID |
| Request | `/agents/requests/<requestId>` | One request's on-chain state and each validator's signed receipt |
| Live feed | [`/agents/live`](https://explorer.somnia.network/agents/live) | Requests as they are created |

## Directory

[`/agents`](https://explorer.somnia.network/agents) lists every agent registered in the AgentRegistry, with its methods and price. Throughput, the success rate and the committee size sit above the list, with requests per 10 seconds beneath. Select an agent to open its page. The validators themselves, with every chain's committee, are on the explorer's [Validators](https://explorer.somnia.network/validators) page.

## Agent page

`/agents/<agentId>`, for example [`/agents/9911223344556677889`](https://explorer.somnia.network/agents/9911223344556677889) for the [Price Oracle](./base-agents/price-oracle), shows:

- each method, with its inputs and outputs;
- a generated Solidity snippet for each method, covering payload encoding, the deposit, the `createRequest` call and the callback, ready to copy into your contract (see [Invoking from Solidity](./invoking-agents/from-solidity));
- the agent's recent requests.

## Requests

[`/agents/requests`](https://explorer.somnia.network/agents/requests) lists recent requests with their status, subcommittee responses and payout. To find a specific request, look it up by the ID returned from `createRequest`.

## Request page

`/agents/requests/<requestId>` shows:

- the request's on-chain state;
- each validator's signed receipt, loaded from the receipts service.

Use it to check why a request succeeded, failed or timed out. See [Receipts](./invoking-agents/receipts) for what each receipt contains.

## Live feed

[`/agents/live`](https://explorer.somnia.network/agents/live) shows requests as they are created, refreshed every few seconds.

---

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.