# Breeze MPP API

Payment-gated Solana yield strategy endpoints powered by the [Model Payment Protocol](https://github.com/solana-foundation/mpp-sdk).

## Endpoints

| Method | Path                              | Auth | Description                           |
|--------|-----------------------------------|------|---------------------------------------|
| GET    | /healthz                          | -    | Service health check                  |
| GET    | /strategy-info/:strategy_id?      | MPP  | Strategy metadata and APY             |
| GET    | /breeze-balances/:user_pubkey     | MPP  | Wallet positions, deposits, yield     |
| GET    | /user-balances/:user_id           | MPP  | User balance info                     |
| GET    | /user-yield/:user_id              | MPP  | Total yield earned                    |
| POST   | /deposit/tx                       | MPP  | Build unsigned deposit transaction    |
| POST   | /deposit/ix                       | MPP  | Raw deposit instructions              |
| POST   | /withdraw/tx                      | MPP  | Build unsigned withdraw transaction   |
| POST   | /withdraw/ix                      | MPP  | Raw withdraw instructions             |
| POST   | /close-user-account/tx            | MPP  | Close account transaction             |
| POST   | /close-user-account/ix            | MPP  | Close account instructions            |

## Auth

Protected endpoints require a USDC micropayment (0.001 USDC) via the MPP protocol.
Use @solana/mpp/client to handle payment challenges automatically.

## Links

- https://agent.breeze.baby
- https://breeze.baby
- https://github.com/anagrambuild/breeze-agent-kit

---

Built for agents, with <3