> ## Documentation Index
> Fetch the complete documentation index at: https://docs.si.ampli.net/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> These are the Ampli Intelligence docs. API base: https://si.ampli.net/api/v1. API MCP: https://si.ampli.net/mcp.
> Auth is a partner key (X-Partner-Name and X-Partner-API-Key headers) or an x402 payment in USDC on Base.
> For a single-treasury agentic wallet or Wallet-as-a-Service, use the ampli^ SDK at https://ampli.net and https://docs.ampli.net. agk_ keys and /api/v1/agent-runtime belong to that SDK.
> Use only the routes and tools documented here. Do not invent endpoints or parameters.
> The ampli^ SDK (https://ampli.net, docs at https://docs.ampli.net) can use this intelligence to deliver a single-treasury agentic wallet or Wallet-as-a-Service. This host is si.ampli.net. Auth is a partner key or an x402 payment. agk_ keys and /api/v1/agent-runtime belong to the SDK Agent API.
> Every amount is an integer string in the token's base units. USDC, EURC, USDT0, and USDG use 6 decimals (1000000 is 1 USDC). WETH and cbETH use 18. cbBTC uses 8.
> The service is non-custodial. It returns an allocation, an action plan, and calldata. It never holds keys, signs, or sends a transaction.
> APR values are percentages measured now or over the trailing 7 days. They are not forecasts and nothing here guarantees a return.
> x402 payments are verified before the work and settled only when the response is 2xx. A 400 or 422 costs nothing.
> Partner headers always win. A request with a wrong partner key returns 401 and does not fall back to payment.
> Monitor alerts arrive only on the websocket. create_monitor_session returns a token; the client must open the socket itself.
> Market names in optimize must come from list_protocols for the same chain and token. Do not guess names.

# Market list

> GET /{chain_id}/{token_address}/protocols lists every supported lending market and vault for a token, with current supply, reward, and net APR and the 7-day net APR.

```http theme={null}
GET https://si.ampli.net/api/v1/{chain_id}/{token_address}/protocols
```

Priced per call with x402, or free with partner headers. MCP tool: `list_protocols`.

Use it first. The `protocol` values it returns are the only valid names for `protocols`, `current_allocations`, and constraints in an [optimize](https://docs.si.ampli.net/optimize.md) call on the same chain and token.

## Request

```bash theme={null}
curl -s https://si.ampli.net/api/v1/8453/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913/protocols \
  -H "X-Partner-Name: your-partner-name" \
  -H "X-Partner-API-Key: $AMPLI_PARTNER_API_KEY"
```

`chain_id` is one of the [supported chains](https://docs.si.ampli.net/coverage.md). `token_address` is the underlying token. Address case does not matter.

## Response

```json theme={null}
{
  "protocols": [
    {
      "protocol": "aave",
      "name": "Aave V3",
      "parent": "Aave",
      "website": "https://aave.com",
      "address": "0xa238dd80c259a72e81d7e4664a9801593f98d1c5",
      "kind": "market",
      "asset_symbol": "USDC",
      "total_assets_usd": 412000000.0,
      "supply_apr": 3.61,
      "reward_apr": 0.19,
      "net_apr": 3.80,
      "net_apr_7d": 3.92,
      "net_apr_7d_samples": 168
    }
  ]
}
```

Fields with no value are left out, so check for presence before reading.

| Field | Meaning |
| :- | :- |
| `protocol` | Market name to use in optimize |
| `name`, `parent`, `website` | Display name, brand, and site |
| `address` | Market or vault contract |
| `kind` | `market` for a lending pool, `vault` for a curated vault |
| `total_assets_usd` | Size of the market in US dollars |
| `supply_apr` | Base lending rate now, in percent |
| `reward_apr` | Incentive rate now, where the protocol publishes one, in percent |
| `net_apr` | `supply_apr` plus `reward_apr` |
| `net_apr_7d` | Trailing 7-day average of `net_apr`, from hourly samples |
| `net_apr_7d_samples` | How many hourly samples back that average. Fewer than 24 means the history is thin |

> [!NOTE]
>
> `net_apr_7d` is a trailing measurement, not a forecast. The optimizer prices a market whose latest APR spikes above its 7-day average at the average. See [risk rules](https://docs.si.ampli.net/risk-rules.md).

## See it live

The [live markets page](https://si.ampli.net/markets) shows every tracked market across all eleven assets, with APR, TVL, utilization, withdrawable liquidity, and a health status, built from this route and [health](https://docs.si.ampli.net/health.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.