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

# MPP Agent endpoints

> Machine Payments Protocol (MPP): /agent/mpp/ guides plus V2 /api/2/ paths discoverable via openapi.json (x-payment-info).

**Machine Payments Protocol (MPP)** is Mobula’s payment rail for agent provisioning at **`/agent/mpp/...`**. The same flows exist on **x402** under **`/agent/x402/...`** ([x402 Subscribe to a plan](/guides/x402-agent-subscribe)); only the payment mechanism differs.

Base URL: `https://mpp.mobula.io` (or your deployment).

***

## Supported MPP Agent endpoints

Each item links to the guide that documents that operation (402 → pay → retry flow, query params, and examples).

* **[GET `/agent/mpp/subscription`](/guides/mpp-agent-subscription)**
* **[GET `/agent/mpp/subscribe`](/guides/mpp-agent-subscribe)**
* **[GET `/agent/mpp/top-up`](/guides/mpp-agent-topup)**
* **[GET `/agent/mpp/api-keys/create`](/guides/mpp-agent-api-key-create)**
* **[GET `/agent/mpp/api-keys/revoke`](/guides/mpp-agent-api-key-revoke)**

***

## V2 REST endpoints with MPP (`/api/2/*`)

The same [`openapi.json`](https://demo-api.mobula.io/openapi.json) document lists **V2** routes that support **MPP per-request payment** when you call them **without** an API key: each operation includes **`x-payment-info`** (first call → **402** → pay → retry). Use the same host you call for data (e.g. `https://mpp.mobula.io` or `https://demo-api.mobula.io`).

Paths present in OpenAPI (as of the published spec; use **`openapi.json`** for the live list). Each row links to the **REST API reference** page for that endpoint:

* **[GET `/api/2/asset/details`](/rest-api-reference/endpoint/asset-details)**
* **[GET `/api/2/asset/price-history`](/rest-api-reference/endpoint/asset-price-history)**
* **[GET `/api/2/fast-search`](/rest-api-reference/endpoint/fast-search)**
* **[GET `/api/2/market/details`](/rest-api-reference/endpoint/market-details)**
* **[GET `/api/2/market/lighthouse`](/rest-api-reference/endpoint/market-lighthouse)**
* **[GET `/api/2/market/ohlcv-history`](/rest-api-reference/endpoint/market-ohlcv-history)**
* **[POST `/api/2/perp/execute-v2`](/rest-api-reference/endpoint/perp-execute)**
* **[GET `/api/2/perp/check-process`](/rest-api-reference/endpoint/perp-check-process)**
* **[POST `/api/2/perp/payloads/cancel-order`](/rest-api-reference/endpoint/perp-payload-cancel-order)**
* **[POST `/api/2/perp/payloads/close-position`](/rest-api-reference/endpoint/perp-payload-close-position)**
* **[POST `/api/2/perp/payloads/create-account`](/rest-api-reference/endpoint/perp-payload-create-account)**
* **[POST `/api/2/perp/payloads/create-order`](/rest-api-reference/endpoint/perp-payload-create-order)**
* **[POST `/api/2/perp/payloads/deposit`](/rest-api-reference/endpoint/perp-payload-deposit)**
* **[POST `/api/2/perp/payloads/edit-order`](/rest-api-reference/endpoint/perp-payload-edit-order)**
* **[POST `/api/2/perp/payloads/update-margin`](/rest-api-reference/endpoint/perp-payload-update-margin)**
* **[POST `/api/2/perp/payloads/withdraw`](/rest-api-reference/endpoint/perp-payload-withdraw)**
* **[POST `/api/2/perp/quote`](/rest-api-reference/endpoint/perp-quote)**
* **[GET `/api/2/swap/quoting`](/rest-api-reference/endpoint/swap-quoting)**
* **[GET `/api/2/swap/quoting-instructions`](/rest-api-reference/endpoint/swap-instructions)**
* **[POST `/api/2/swap/send`](/rest-api-reference/endpoint/swap-send)**
* **[GET `/api/2/system-metadata`](/rest-api-reference/endpoint/system-metadata)**
* **[GET `/api/2/token/ath`](/rest-api-reference/endpoint/token-ath)**
* **[GET `/api/2/token/details`](/rest-api-reference/endpoint/token-details)**
* **[GET `/api/2/token/holder-positions`](/rest-api-reference/endpoint/token-holder-positions)**
* **[GET `/api/2/token/markets`](/rest-api-reference/endpoint/token-markets)**
* **[GET `/api/2/token/ohlcv-history`](/rest-api-reference/endpoint/token-ohlcv-history)**
* **[GET `/api/2/token/price`](/rest-api-reference/endpoint/token-price)**
* **[GET `/api/2/token/price-at`](/rest-api-reference/endpoint/token-price-at)**
* **[GET `/api/2/token/price-history`](/rest-api-reference/endpoint/token-price-history)**
* **[GET `/api/2/token/security`](/rest-api-reference/endpoint/token-security-get)**
* **[GET `/api/2/token/trade`](/rest-api-reference/endpoint/token-trade)**
* **[GET `/api/2/token/trader-positions`](/rest-api-reference/endpoint/token-trader-positions)**
* **[GET `/api/2/token/trades`](/rest-api-reference/endpoint/token-trades)**
* **[GET `/api/2/token/trades-enriched`](/rest-api-reference/endpoint/token-trades-enriched)**
* **[GET `/api/2/trades/filters`](/rest-api-reference/endpoint/trades-filters)**
* **[GET `/api/2/wallet/activity`](/rest-api-reference/endpoint/wallet-activity)**
* **[GET `/api/2/wallet/analysis`](/rest-api-reference/endpoint/wallet-analysis)**
* **[GET `/api/2/wallet/defi-positions`](/rest-api-reference/endpoint/wallet-defi-positions)**
* **[GET `/api/2/wallet/deployer`](/rest-api-reference/endpoint/wallet-deployer)**
* **[GET `/api/2/wallet/labels`](/rest-api-reference/endpoint/wallet-labels-get)**
* **[GET `/api/2/wallet/labels/search`](/rest-api-reference/endpoint/wallet-labels-search)**
* **[GET `/api/2/wallet/position`](/rest-api-reference/endpoint/wallet-position)**
* **[GET `/api/2/wallet/positions`](/rest-api-reference/endpoint/wallet-positions)**
* **[GET `/api/2/wallet/positions/perp/open`](/rest-api-reference/endpoint/wallet-perp-positions)**
* **[GET `/api/2/wallet/positions/perp/unfilled`](/rest-api-reference/endpoint/wallet-perp-orders)**
* **[GET `/api/2/wallet/trades`](/rest-api-reference/endpoint/wallet-trades-v2)**

***

## Discovery

Machine-readable catalog (paths and `x-payment-info` on V2 routes; agent routes are covered in the guides above):

* [`https://demo-api.mobula.io/openapi.json`](https://demo-api.mobula.io/openapi.json)
* [`https://api.mobula.io/openapi.json`](https://api.mobula.io/openapi.json)

Use with OpenAPI tools or **MPPscan** and the matching base URL. If the path list drifts, **`openapi.json`** is the source of truth.

***

## Learn more

Off-site references for the **MPP** stack Mobula wires into (payment headers, **mppx**, Tempo):

* **[docs.tempo.xyz/mpp](https://docs.tempo.xyz/mpp)** — Protocol reference and SDKs
* **[docs.tempo.xyz/faq](https://docs.tempo.xyz/faq)** — Tempo’s MPP FAQ
* **[tempo.xyz](https://tempo.xyz/)** — Tempo network (settlement layer for these flows)

***

## Related

* [Accessing Mobula for agents (x402)](/guides/x402-integration-guide)
* [x402 Subscription and top-up](/guides/x402-subscription-and-topup)
