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

# SuperAPI

> Discover and call paid APIs through one x402-compatible interface.

SuperAPI lets an agent discover a service, receive a price quote, authorize payment, and get the API response.

<Card title="Browse SuperAPI" icon="arrow-up-right-from-square" href="https://app.anyway.sh/marketplace?view=agent">
  Open SuperAPI in the Agents view and copy a ready-made prompt or endpoint example.
</Card>

<Frame>
  <img src="https://mintcdn.com/anyway/2VVTFU_BTPgbm7OY/images/marketplace/marketplace-page.png?fit=max&auto=format&n=2VVTFU_BTPgbm7OY&q=85&s=068227eabb1a66fafdb716dfb0fcd2ea" alt="SuperAPI — paid services with endpoint status and pricing" width="3024" height="1466" data-path="images/marketplace/marketplace-page.png" />
</Frame>

## Always discover before calling

List the available services:

```bash theme={null}
curl https://marketplace-prod.anyway.sh/v1/api/directory
```

Then fetch the selected service's current endpoint details:

```bash theme={null}
curl https://marketplace-prod.anyway.sh/v1/api/info/{upstream_id}
```

<Warning>
  Use the directory entry's `id` as `upstream_id`. Then use the HTTP method, parameters, and x402 URL in the info response's `endpoints` and `curl_x402` fields; do not derive them from the display name.
</Warning>

## Make a paid call

With an Agent Wallet Key configured:

```bash theme={null}
anyway superapi call "<x402 endpoint URL>"
```

For a POST endpoint:

```bash theme={null}
anyway superapi call "<x402 endpoint URL>" \
  --body '{"query":"open source payment APIs"}'
```

The command:

1. sends the initial request;
2. decodes the returned payment requirement;
3. shows the quote;
4. asks for confirmation;
5. signs with the selected Agent Wallet;
6. retries with the payment signature; and
7. prints the API result.

Use `--format json` for machine-readable output. Use `--yes` only when the runtime is intentionally allowed to approve quotes automatically.

## Payment guardrails

* Organization Credits are used before wallet USDC when eligible.
* The selected agent wallet's spending policy is enforced server-side.
* A payment above the policy limit is rejected.
* Discovery and info responses should be refreshed instead of cached indefinitely.


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