---
title: "Search the x402 catalogue with usage figures"
method: GET
path: "/v1/discovery"
tags: ["discovery", "directory", "x402", "search", "agents"]
---

# Search the x402 catalogue with usage figures

`GET /v1/discovery`

## Request

- Base URL: `https://api.402rates.com`
- URL: `https://api.402rates.com/v1/discovery`
- Auth: none declared

Free directory of the x402 resource catalogue: search paid endpoints by what they do, filter by price and network, and see for each one its 30-day call count, its number of distinct paying addresses, the ratio between them and how long since it was last paid. Answers from a dated weekly snapshot and says which day it is from.

## Query parameters

- `q` string: words to look for in the provider's own description, service name, URL and tags; every word must match
- `max_price` number: highest price per call in USDC to include
- `network` string: chain id a resource must accept payment on, for example eip155:8453
- `limit` integer: how many results to return, 1 to 50 (default 10)

## Response `200`

Successful response

- object
  - `data` object[]
    - `resource` string
    - `price_usdc` number
    - `calls_30d` integer
    - `unique_payers_30d` integer
    - `calls_per_payer` number
    - `days_since_last_call` integer
    - `snapshot_date` string
  - `meta` object
    - `method` object
      - `version` string
      - `ranking` string[]

---

[API](https://skmtc.dev/402rates/apis/402rates-com.md) · [All operations](https://skmtc.dev/402rates/apis/402rates-com/llms.txt) · [OpenAPI document](https://skmtc.dev/402rates/apis/402rates-com/revisions/483a9d0a3f0b?raw)