# Agentic Payments

Call the Nansen API without an account, subscription, or API key. Pay per request in USDC and get data back.

Agentic payments let machines: AI agents, scripts, bots access Nansen data on demand, settling each call on-chain. No provisioning, no key management, no long-lived credentials. Sign a payment, make the request, get the response.

Nansen supports two agentic payment rails on the same `/api/v1/*` endpoints:

* **x402:** The open HTTP payment standard. USDC on Base or Solana. Broad client-side tooling and SDK support. Best for agents already operating on Base or Solana.
* **MPP on Tempo:** Machine Payments Protocol settlement on Tempo mainnet. Sub-cent per-call pricing. Best for agents already settling on Tempo or optimising for per-call cost.

Both rails hit the same endpoints and return identical response bodies. An agent can mix and match x402 for some calls, MPP for others.

### Supported endpoints

All Pro-tier endpoints accept agentic payments, except:

* `/api/v1/labels/*` — Pro subscription only (proprietary entity data).

Pricing is tiered by endpoint:

| Tier        | Price      | Examples                                                              |
| ----------- | ---------- | --------------------------------------------------------------------- |
| Basic       | $0.01/call | Token Screener, Wallet Balances, Transactions, PnL, DEX Trades, Flows |
| Premium     | $0.05/call | Counterparties, Holders, PnL Leaderboard, Perp Leaderboard            |
| Smart Money | $0.05/call | SM Net Flow, SM Inflows, SM Holdings, SM DEX Trades                   |

The full endpoint list and tier breakdown is on the [x402](https://claude.ai/chat/x402#pricing) page. MPP uses the same tiers and prices.

### Discovery

Fetch `/.well-known/x402` to see every priced endpoint, its cost, and which payment protocols it supports:

```bash
curl -s https://api.nansen.ai/.well-known/x402 | jq
```

The `paymentProtocols` field lists the rails available for each endpoint (`x402`, `mpp`, or both).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nansen.ai/getting-started/agentic-payments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.