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

# Ampli Intelligence

> Decide where on-chain capital should be lent. Get a non-custodial allocation, an ordered action plan, and ready-to-sign calldata, plus the market data and alerts behind it.

Ampli Intelligence decides where on-chain capital should be lent. You send what a wallet holds and which lending markets it may use. It returns the allocation with the best expected yield after gas, the withdrawals and deposits needed to get there, and the calldata for each step. It also serves the data behind that decision (APR, liquidity, utilization, peg, collateral backing) and pushes alerts when a market turns unsafe.

> [!NOTE]
>
> **Looking for our Full-stack SDK?**
>
> The ampli^ SDK can use this intelligence to deliver a single-treasury agentic wallet or a Wallet-as-a-Service product. Start at [ampli.net](https://ampli.net). The SDK docs are at [docs.ampli.net](https://docs.ampli.net). Send a partner key or an x402 payment on this host. `agk_` wallet keys belong to the SDK.

## Who it is for

* **Wallets and fintech apps** that offer an earn or savings product on stablecoins and need to pick markets, size positions, and rebalance without running a research desk.
* **Treasuries and DAOs** that hold idle stablecoins and want a defensible allocation across lending markets, within their own policy limits.
* **Vault and strategy builders** who want a solver and risk filter they can call instead of build.
* **AI agents** that manage funds and need one call that returns a plan they can sign. Every response is machine-readable and ends in calldata.

## What you can call

| Capability | REST route | MCP tool | Price unit |
| :- | :- | :- | :- |
| Optimize | `POST /optimizer/{chain_id}/optimize` | `optimize` | per call |
| Market list | `GET /{chain_id}/{token_address}/protocols` | `list_protocols` | per call |
| Health | `POST /protocols/health` | `protocol_health` | per asset |
| Monitor | `POST /monitor/sessions`, then `WS /monitor` | `create_monitor_session` | per hour |

The REST base is `https://si.ampli.net/api/v1`. The API MCP server is `https://si.ampli.net/mcp`.

## The non-custodial boundary

Ampli Intelligence reads chain state and returns advice. It never holds keys, never signs, and never sends a transaction. The caller's own wallet, smart account, or agent executes the plan, and stays responsible for checking it before signing.

* Rules restrict where **new** money may go. They never force a withdrawal from a position you already hold.
* APR values are measured now or over the trailing 7 days. They are not forecasts, and no plan is risk-free.
* Every amount is an integer string in the token's base units. USDC has 6 decimals, so `1000000000` is 1,000 USDC.

## Two ways to authenticate

* **Partner key.** Contracted partners send `X-Partner-Name` and `X-Partner-API-Key`. No payment is taken. Ask for one at [business@ampli.net](mailto:business@ampli.net).
* **x402.** Anyone else, including an autonomous agent, pays per call in USDC on Base. The first response is `402 Payment Required` with the price; the client signs and retries. Payment settles only when the call succeeds.

> [card] [Quickstart](https://docs.si.ampli.net/quickstart.md)
>
> One optimize call with a partner key, then the same call paid with x402.

> [card] [Authentication and payments](https://docs.si.ampli.net/authentication.md)
>
> Partner headers, the 402 offer, and when a payment settles.

> [card] [API MCP](https://docs.si.ampli.net/api-mcp.md)
>
> The four capabilities as MCP tools for agents.

> [card] [Build with AI](https://docs.si.ampli.net/build-with-ai.md)
>
> Skills, llms.txt, markdown pages, and the docs MCP.


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