Agentic Terminal Directory

Search OP-verified merchants by rail, chain, category, agent-callable tier, trust tier, and free text. Ranked by trust tier then verification recency.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "rail": {
      "type": "string",
      "enum": [
        "lightning",
        "bolt12",
        "l402",
        "usdt"
      ]
    },
    "chain": {
      "type": "string",
      "enum": [
        "tron",
        "ethereum",
        "solana",
        "bsc",
        "polygon",
        "arbitrum",
        "base"
      ]
    },
    "category": {
      "type": "string"
    },
    "agent_callable_tier": {
      "type": "string",
      "enum": [
        "full-api",
        "structured-handoff",
        "human-checkout"
      ]
    },
    "trust_tier_min": {
      "type": "number",
      "enum": [
        1,
        2,
        3
      ]
    },
    "accepts_usdc": {
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get the full record for one merchant including all rails, payment endpoints, and OP attestation. Tier 2+ requires an AT credential.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Run a live check against a merchant's declared payment endpoint for a rail. Returns health, detail, and rail-specific evidence.

{
  "type": "object",
  "properties": {
    "merchant_id": {
      "type": "string",
      "minLength": 1
    },
    "rail": {
      "type": "string",
      "enum": [
        "lightning",
        "bolt12",
        "l402",
        "usdt"
      ]
    }
  },
  "required": [
    "merchant_id",
    "rail"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the category taxonomy with merchant counts.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List supported payment rails and their current merchant counts.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Report the resolved credential state and rate limits for the calling agent.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}