x402 Discovery

Get one x402 service

Fetch a single x402 service directory entry by its id.

get/v1/x402/resources/{id}

Request

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

Path parameters

idstring uuid required

Response

idstring uuid required

Entity UUID

createdAtstring date-time required

Creation date (ISO 8601)

updatedAtstring date-time required

Last update date (ISO 8601)

resourcestring required

Absolute URL of the x402-protected service endpoint.

serviceNamestring nullable

Human-friendly service name from the upstream directory.

descriptionstring nullable

Vendor-supplied description of what the service does.

iconUrlstring nullable

Absolute URL of the service icon.

typestring required

Resource transport type from the directory.

x402Versioninteger required

x402 protocol version the service implements.

tagsstring[] required

Free-form keywords from the directory; drive tag filter + search.

networksstring[] required

Distinct CAIP-2 chain ids derived from accepts[].network; drives the network filter.

httpMethodstring nullable

HTTP method the endpoint answers on, from the directory metadata. Probing a POST-only service with a GET never reaches its x402 middleware: it answers 404/405 instead of the payment terms.

requestHintobject nullable

Vendor-supplied call hint (method, bodyType, example body, query and path params). The shape varies per service — treat it as an opaque hint, not a contract.

source'coinbase' | 'orthogonal' required

Upstream directory this entry is mirrored from.

hoststring required

Lowercase host of resource; destination rules match on it.

viastring nullable

Gateway that resells the provider and collects the payment (e.g. Orthogonal). Null when the provider is paid directly.

priceVariableboolean required

True when the price is set per request rather than by the directory: accepts is then empty and x402_info gives the actual price.

payableboolean required

Whether the service offers a payment scheme the Keyban agent wallet can settle (today: exact). Unpayable services are listed last.

operationstring nullable

Short endpoint label from the last path segments (gateway slug and version prefix dropped).

Example response

{
  "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"
}

Changes

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