List x402 resources

Lists all active discovered x402 resources. This endpoint returns resources that have been discovered and cached by the x402 facilitator, including their payment requirements and metadata. The response is paginated, and by default, returns 100 items per page.

GET /v2/x402/discovery/resources

List x402 resources

cURL

curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources \
  --header 'Authorization: Bearer <token>'

200

{
  "x402Version": 2,
  "items": [
    {
      "resource": "https://api.example.com/weather/forecast",
      "description": "Real-time weather forecast data.",
      "type": "http",
      "x402Version": 2,
      "lastUpdated": "2024-01-15T10:30:00Z",
      "accepts": [
        {
          "scheme": "exact",
          "network": "eip155:8453",
          "amount": "1000000",
          "payTo": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
          "maxTimeoutSeconds": 60
        }
      ],
      "extensions": {
        "bazaar": {
          "info": {
            "input": {
              "type": "http",
              "method": "GET"
            }
          },
          "schema": {}
        }
      },
      "quality": {
        "l30DaysTotalCalls": 42,
        "l30DaysUniquePayers": 15,
        "lastCalledAt": "2024-01-15T10:30:00Z"
      },
      "serviceName": "Weather API",
      "tags": [
        "weather",
        "data"
      ]
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 1000
  }
}

Query Parameters

type · string

Filter by protocol type (e.g., "http", "mcp"). Currently, the only supported protocol type is "http".

Example:

"http"

limit · integer · default: 100

The number of discovered x402 resources to return per page.

offset · integer · default: 0

The offset of the first discovered x402 resource to return.

Response

200

application/json

Successfully retrieved discovery list.

Response containing discovered x402 resources.

x402Version · enum<integer> · required

The version of the x402 protocol.

Available options: 1, 2

Example:

2

items · object[] · required

List of discovered x402 resources.

Show child attributes

Example:

[
  {
    "resource": "https://api.example.com/weather/forecast",
    "description": "Real-time weather forecast data.",
    "type": "http",
    "x402Version": 2,
    "lastUpdated": "2024-01-15T10:30:00Z",
    "accepts": [
      {
        "scheme": "exact",
        "network": "eip155:8453",
        "amount": "1000000",
        "payTo": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
        "maxTimeoutSeconds": 60
      }
    ],
    "extensions": {
      "bazaar": {
        "info": {
          "input": { "type": "http", "method": "GET" }
        },
        "schema": {}
      }
    },
    "quality": {
      "l30DaysTotalCalls": 42,
      "l30DaysUniquePayers": 15,
      "lastCalledAt": "2024-01-15T10:30:00Z"
    },
    "serviceName": "Weather API",
    "tags": ["weather", "data"]
  }
]

pagination · object · required

Pagination information for the response.

Show child attributes

Example:

{ "limit": 100, "offset": 0, "total": 1000 }