# Seistream — full agent surface

Companion to [llms.txt](https://seistream.app/llms.txt). Use this file
when you need every live route, not a crawl of the HTML.

## Do / don't

- **Do** call `https://api.seistream.app/api/v2/…` for data. No API key.
- **Do** attach MCP at `https://api.seistream.app/mcp` (streamable HTTP).
- **Don't** scrape `/transactions/*`, `/blocks*` or `/codes*` HTML —
  `robots.txt` disallows them. The JSON API is the supported interface.
- **Don't** use `https://mcp.seistream.app` — that host does not exist.
  **Don't** POST `/mcp` on `api-v2.seistream.app` (404). MCP is only on
  `api.seistream.app`.
- **Don't** use `/search?query=` on the API origin; the path is
  `/api/v2/search?query=` (or `/api/v2/search/{query}`).

## Network

| Network | Cosmos chain id | EVM chain id | Explorer | Native denom |
|---------|-----------------|--------------|----------|--------------|
| Mainnet | `pacific-1`     | `1329`       | https://seistream.app | `usei` (6 dp) |
| Testnet | `atlantic-2`    | `1328`       | https://testnet.seistream.app | `usei` (6 dp) |

Sei is one chain with two execution views. Block **heights match 1:1**.
An account has two encodings of the same 20-byte key:

- Cosmos bech32 `sei1…` (validators `seivaloper1…`, consensus `seivalcons1…`)
- EVM hex `0x` + 40 hex

Resolve either side with
`GET /api/v2/cosmos/addresses/associated/{sei1_or_0x}`
→ `{ cosmos, eth, associated }`.

Pointer registry (CW20/ERC20 links, account pointers):
`GET /api/v2/evm/pointer` (list) and `GET /api/v2/evm/pointer/{0x}`.

EVM native balances use 18 decimals; Cosmos `usei` uses 6. Amounts in
the API are **decimal strings**. Times are ISO-8601 UTC. Cosmos tx
hashes are 64 hex (case-insensitive). EVM tx hashes are `0x` + 64 hex.

## Web routes (verified)

Canonical origin: `https://seistream.app`.

| Path | Notes |
|------|--------|
| `/` | Home: live feed + stats |
| `/blockchain` | Chain metrics |
| `/stats` | Historical charts |
| `/gas-tracker` | EVM gas oracle |
| `/address/{sei1\|0x\|denom}` | **Canonical** account / contract / token page |
| `/account/{id}` | 308 → `/address/{id}` |
| `/contracts/{0x}` | 308 → `/address/{0x}?tab=contract` (list `/contracts` is 404) |
| `/contracts/verify` | Source verification form |
| `/tokens` | Token list. `/tokens/{id}` without `?standart=` 308s to `/address/{id}?tab=transfers` |
| `/blocks/{height}` | One block, Cosmos + EVM tabs. There is **no** `/blocks` index (404). |
| `/transactions/{hash}` | One tx. Alias `/tx/{hash}`. No `/transactions` index. |
| `/validators`, `/validators/{seivaloper1}` | Set + detail |
| `/proposals`, `/proposals/{id}` | Governance |
| `/relayers`, `/relayers/{channel}` | IBC |
| `/token-approvals` | Allowance checker |
| `/token-transfers` | Global transfers |
| `/internal-transactions` | Internal calls |
| `/advanced-filter` | Tx query builder |
| `/utilities` | Converters |
| `/labs` | Node ops (snapshots, state-sync, RPC, upgrades) via `?page=` |
| `/mcp` | MCP attach docs |
| `/migrate-sip03` | SIP-03 address migration helper |

## REST (`https://api.seistream.app`)

No auth on reads. OpenAPI: `/swagger`. Liveness: `GET /health`.
Indexer lag: `GET /api/v2/status` (`headHeight`, `syncedHeight`, `chainId`).

### Search

- `GET /api/v2/search?query={q}`
- `GET /api/v2/search/{q}`

Accepts block height, 64-hex hash, `0x` address, `sei1`/`seivaloper1`,
moniker, token symbol, contract name. Bare JSON array; count in
`X-Total-Count`.

### Cosmos

- `GET /api/v2/cosmos/blocks/{height}`
- `GET /api/v2/cosmos/blocks?limit=&offset=`
- `GET /api/v2/cosmos/transactions/{hash}`
- `GET /api/v2/cosmos/addresses/{sei1}`
- `GET /api/v2/cosmos/addresses/{sei1}/transactions`
- `GET /api/v2/cosmos/addresses/associated/{sei1_or_0x}`
- `GET /api/v2/cosmos/tokens/{denom}`
- `GET /api/v2/cosmos/validators`
- `GET /api/v2/cosmos/validators/{seivaloper1}`
- `GET /api/v2/cosmos/proposals`
- `GET /api/v2/cosmos/proposals/{id}`

### EVM

- `GET /api/v2/evm/blocks/{height}` — add `?light=true` for header-only (no live RPC).
- `GET /api/v2/evm/blocks?limit=`
- `GET /api/v2/evm/transactions/{0xhash}`
- `GET /api/v2/evm/transactions/{0xhash}/logs`
- `GET /api/v2/evm/transactions/{0xhash}/internals`
- `GET /api/v2/evm/accounts/{0x}`
- `GET /api/v2/evm/accounts/{0x}/transactions`
- `GET /api/v2/evm/tokens/{0x}`
- `GET /api/v2/evm/contracts/{0x}`
- `GET /api/v2/evm/pointer`, `GET /api/v2/evm/pointer/{0x}`
- `POST /api/v2/evm/rpc/get-supported-networks` and sibling `POST /api/v2/evm/rpc/*` helpers (not a raw `eth_*` POST to `/evm/rpc`).

### Etherscan-compatible (Hardhat / Foundry / Remix)

Origin `https://api.seistream.app` (path `/api`, **not** `/api/v2`):

- `POST /api?module=contract&action=verifysourcecode`
- `GET  /api?module=contract&action=checkverifystatus`
- `GET  /api?module=contract&action=getabi&address=0x…`
- `GET  /api?module=contract&action=getsourcecode&address=0x…`

## MCP

- **URL:** `https://api.seistream.app/mcp`
- **Transport:** streamable HTTP (JSON-RPC over POST). There is **no**
  public `/sse` or `/messages` on this host.
- **Auth:** none for read tools. Writes are prepare → sign off-server →
  broadcast. The server never accepts a private key.
- **Tools:** 150+ covering EVM + Cosmos (blocks, txs, accounts, tokens,
  contracts, staking, IBC, governance, pointers, search). `tools/list`
  after `initialize`.

Cursor / Claude / similar (`mcp.json`):

```json
{
  "mcpServers": {
    "seistream": {
      "url": "https://api.seistream.app/mcp"
    }
  }
}
```

SDK + slash-skills: https://github.com/stakeme-team/sei-agent-kit

Discovery files on the explorer origin:

- `https://seistream.app/llms.txt`
- `https://seistream.app/llms-full.txt`
- UI walkthrough: `https://seistream.app/mcp`

## Worked examples

Replace ids as needed. All on `https://api.seistream.app`.

```
GET /api/v2/search?query=227726022
GET /api/v2/cosmos/blocks/227726022
GET /api/v2/evm/blocks/227726022?light=true
GET /api/v2/cosmos/addresses/associated/sei1t84wt0aranjjv9es0wazfzs5lzlhpateuwz8dm
GET /api/v2/evm/contracts/0x3217bc8ac416423338C51EA893E3Ce7e9001426E
GET /api/v2/status
```

Matching UI:

```
https://seistream.app/blocks/227726022
https://seistream.app/address/sei1t84wt0aranjjv9es0wazfzs5lzlhpateuwz8dm
https://seistream.app/address/0x3217bc8ac416423338C51EA893E3Ce7e9001426E?tab=contract
```

## Contact

- Product / explorer: team@stakeme.pro
- Bugs: https://feedback.stakeme.pro
- Protocol docs: https://docs.sei.io/
- Sei: https://www.sei.io/