Title: x402 API discovery
Source: https://nodely.io/docs/x402/discovery/

# x402 API discovery

Agents and x402 directories can find and use these APIs without reading this page. Every discovery route is free.

<a id="well-knownx402"></a>

## `/.well-known/x402`

[`https://x402.api.nodely.io/.well-known/x402`](https://x402.api.nodely.io/.well-known/x402) lists the paid resources:

```json
{
  "version": 1,
  "resources": [
    "https://x402.api.nodely.io/v1/search",
    "https://x402.api.nodely.io/v1/scrape",
    "https://x402.api.nodely.io/v1/prices/price",
    "https://x402.api.nodely.io/v1/prices/history",
    "https://x402.api.nodely.io/v1/prices/pairs",
    "https://x402.api.nodely.io/v1/prices/pools",
    "https://x402.api.nodely.io/v1/prices/candles",
    "https://x402.api.nodely.io/v1/prices/account",
    "https://x402.api.nodely.io/v1/images/search",
    "https://x402.api.nodely.io/v1/images/similar/{cid}"
  ]
}
```

<a id="openapi"></a>

## OpenAPI

[`https://x402.api.nodely.io/openapi.json`](https://x402.api.nodely.io/openapi.json) is an OpenAPI 3.1 description of all routes, with request and response schemas and the payment headers. The [live API reference](https://x402.api.nodely.io/docs/) renders it as an interactive page.

<a id="llmstxt"></a>

## llms.txt

[`https://x402.api.nodely.io/llms.txt`](https://x402.api.nodely.io/llms.txt) is a short plain-text summary for language models: the APIs, prices, how to pay and links to the machine-readable files.

<a id="bazaar-metadata-in-the-402"></a>

## Bazaar metadata in the 402

Each 402 response describes the resource it is selling, so x402 directories (the “bazaar”) can list it:

-   a description, MIME type, service name and tags
-   an example input and output
-   a JSON Schema for the request body

This metadata is under `extensions.bazaar` in the `PAYMENT-REQUIRED` JSON. To see it, decode the header from an unpaid request:

```bash
curl -s -o /dev/null -D - -X POST https://x402.api.nodely.io/v1/scrape \
  -H 'Content-Type: application/json' -d '{"url":"https://example.org/"}' \
  | awk -F': ' 'tolower($1)=="payment-required"{print $2}' | tr -d '\r' | base64 -d | jq .
```