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

# Pricing

> x402 prices per call, per asset, and per hour, paid in USDC on Base. Partners with an API key pay nothing per call.

Every paid route is priced in USDC on Base (`eip155:8453`) and paid with [x402](https://docs.si.ampli.net/authentication.md#x402). You pay only for calls that succeed: a `400`, `422`, or `500` never settles.

## x402 prices

| Capability | REST route | MCP tool | Unit | Price (USDC) | Base units |
| :- | :- | :- | :- | -: | -: |
| Optimize | `POST /optimizer/{chain_id}/optimize` | `optimize` | per call | 0.10 | `100000` |
| Market list | `GET /{chain_id}/{token_address}/protocols` | `list_protocols` | per call | 0.005 | `5000` |
| Health | `POST /protocols/health` | `protocol_health` | per asset in the request | 0.01 | `10000` |
| Monitor | `POST /monitor/sessions` | `create_monitor_session` | per hour of the window | 0.02 | `20000` |

USDC has 6 decimals, so `100000` base units is 0.10 USDC. The `amount` in the `402` offer is always in base units and already holds the total for the request.

## Worked examples

| Request | Units | Total (USDC) | `amount` in the offer |
| :- | -: | -: | -: |
| One optimize call | 1 | 0.10 | `100000` |
| Market list for USDC on Base | 1 | 0.005 | `5000` |
| Health for three assets | 3 | 0.03 | `30000` |
| Six-hour monitor session | 6 | 0.12 | `120000` |
| 24-hour monitor session (the maximum) | 24 | 0.48 | `480000` |

A monitor session is paid up front for the whole window. Closing the socket early does not refund the unused hours, so buy the window you need and renew it when the server sends `session_expired`.

## What is free

* MCP `initialize`, `tools/list`, and the tool schemas. Only `tools/call` is paid.
* The `402` offer itself. Asking for the price costs nothing.
* Every route for partners who send `X-Partner-Name` and `X-Partner-API-Key`.

## Partner plans

Products that call the API at volume, or hold many monitor sockets, can take a partner key on a monthly plan instead of paying per call. Write to [business@ampli.net](mailto:business@ampli.net).

> [!NOTE]
>
> The live price is the one in the `402` offer you receive. If a price changes between the offer and your retry, the server answers with a new `402` carrying the current price, and nothing is charged.


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