x402 Discovery

List x402 services for an application

The x402 catalogue seen from one application.

  • authorized: the service host passes both the organization and the application destination rules.
  • orgRule: state of the organization rule alone for this host (drives the admin toggle).
  • usage: agent wallets of the application that paid this service this month, and the total.
  • authorized=true keeps only authorized services; without search, services paid this month come first, by spend.

Authorization reflects the organization and application destination rules only: a rule set on an individual agent wallet can still refuse a payment to an authorized service.

get/v1/applications/{applicationId}/x402/services

Request

  • Base URL: https://api.prod.keyban.io
  • URL: https://api.prod.keyban.io/v1/applications/{applicationId}/x402/services
  • Auth: one of:
    • API key in header X-Api-Key
    • bearer (a scheme the document does not define)

Path parameters

applicationIdstring uuid required

Query parameters

searchstring
Example:weather

Full-text query matched against service name, description and tags. Omit to list all, ordered by popularity.

networkstring
Example:eip155:8453

Filter to services accepting payment on this CAIP-2 chain id.

tagstring
Example:market news

Filter to services carrying this exact tag.

currentPageinteger
Example:1

1-based page index.

pageSizeinteger
Example:24

Items per page (max 100).

authorizedstring

Keep only services whose host passes the organization and application rules (per-agent-wallet rules are not evaluated).

sourcesstring[]

Comma-separated upstream directories to keep. Omit to list every source.

[
  "orthogonal"
]

Response

totalinteger required

Example response

{
  "data": [
    {
      "resource": "https://x402.ottoai.services/crypto-news",
      "serviceName": "Otto AI",
      "description": "Real-time crypto market news with sentiment analysis.",
      "iconUrl": "https://res.cloudinary.com/bdb-prod/image/upload/icon.png",
      "type": "http",
      "x402Version": 2,
      "tags": [
        "crypto news",
        "market news"
      ],
      "networks": [
        "eip155:8453"
      ],
      "accepts": [
        {
          "scheme": "exact",
          "network": "eip155:8453",
          "amount": "1000",
          "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "payTo": "0x0E84dDEdAaE6A779c462C22a59F301EC31B6b808",
          "maxTimeoutSeconds": 300
        }
      ],
      "httpMethod": "POST",
      "quality": {
        "l30DaysTotalCalls": 1284,
        "l30DaysUniquePayers": 73,
        "lastCalledAt": "2026-06-24T13:19:49.520Z"
      },
      "source": "orthogonal",
      "host": "x402.orthogonal.com",
      "via": "Orthogonal",
      "payable": true,
      "operation": "people/count",
      "orgRule": "allowed",
      "usage": {
        "amountRef": "7810"
      }
    }
  ],
  "summary": {
    "catalogueTotal": 24545,
    "authorizedTotal": 12,
    "gatewayProviders": {
      "Orthogonal": 120
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.