Skip to main content
GET
/
v2
/
x402
/
discovery
/
merchant
Get merchant resources by payTo address
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/x402/discovery/merchant
{
  "payTo": "0x209693Bc6afc0C5328bA36FaF03C514EF312287C",
  "resources": [
    {
      "resource": "https://api.example.com/premium/data",
      "type": "http",
      "x402Version": 1,
      "accepts": [
        {
          "scheme": "exact",
          "network": "eip155:1",
          "asset": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "amount": "1000000",
          "payTo": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "maxTimeoutSeconds": 10,
          "extra": {
            "name": "USDC",
            "version": "2"
          }
        }
      ],
      "lastUpdated": "2025-06-01T12:00:00.000Z",
      "metadata": {
        "description": "Premium weather API data",
        "output": {
          "type": "json",
          "example": {
            "temperature": 72,
            "conditions": "sunny"
          }
        }
      }
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "total": 42
  }
}

Query Parameters

​
payTo
string
required

The wallet address of the merchant. For EVM networks, this is a 0x-prefixed address. For Solana networks, this is a base58-encoded address.

​
limit
integer
default:25

The maximum number of resources to return. Defaults to 25.

Required range: 1 <= x <= 100
​
offset
integer
default:0

The number of resources to skip before returning results. Used for pagination. Defaults to 0.

Required range: x >= 0

Response

Successfully retrieved the merchant's active resources.

​
payTo
string
required

The merchant's wallet address that was queried.

Example:

"0x209693Bc6afc0C5328bA36FaF03C514EF312287C"

​
resources
object[]
required

The list of active x402-gated resources registered to the merchant.

​
pagination
object
required

Pagination information for discovery results.