{
  "info": {
    "_postman_id": "erc8004-api-collection",
    "name": "ERC-8004 Indexer API",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "description": "REST API for querying ERC-8004 agent data across Ethereum, Base, BNB Chain, Avalanche, and Mantle.\n\n**Auth**\n- REST endpoints (`/v1/agents`, `/v1/feedback`, `/v1/validators/...`) are paywalled via x402 stablecoin micropayments. Use an x402 client to sign each request; see /docs/api/v1/x402 on the live site.\n\nA JSON-RPC version of the same data is available to QuickNode customers via the marketplace add-on (https://marketplace.quicknode.com/add-on/erc-8004-api-agent-discovery-and-reputation); enable it on your existing QuickNode JSON-RPC endpoint."
  },
  "auth": { "type": "noauth" },
  "item": [
    {
      "name": "REST (x402-paywalled)",
      "description": "Each request requires a signed x402 payment header. Without one, the server returns 402 Payment Required.",
      "item": [
        {
          "name": "List agents",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/agents?network=base-mainnet&page=1&per_page=20",
              "host": ["{{base_url}}"],
              "path": ["v1", "agents"],
              "query": [
                { "key": "network", "value": "base-mainnet", "description": "Network slug, e.g. base-mainnet, ethereum-mainnet, bnb-mainnet, avalanche-mainnet, mantle-mainnet" },
                { "key": "owner", "value": "", "disabled": true, "description": "Filter by owner address (0x...)" },
                { "key": "include_testnets", "value": "false", "disabled": true },
                { "key": "page", "value": "1" },
                { "key": "per_page", "value": "20" }
              ]
            }
          }
        },
        {
          "name": "List agents (by owner)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/agents?owner={{owner_address}}",
              "host": ["{{base_url}}"],
              "path": ["v1", "agents"],
              "query": [
                { "key": "owner", "value": "{{owner_address}}" },
                { "key": "network", "value": "", "disabled": true }
              ]
            }
          }
        },
        {
          "name": "Get agent by ID",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/agents/{{agent_id}}?network=base-mainnet",
              "host": ["{{base_url}}"],
              "path": ["v1", "agents", "{{agent_id}}"],
              "query": [
                { "key": "network", "value": "base-mainnet", "description": "Required when the same agent_id exists on multiple chains" }
              ]
            }
          }
        },
        {
          "name": "Get agent feedback",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/agents/{{agent_id}}/feedback",
              "host": ["{{base_url}}"],
              "path": ["v1", "agents", "{{agent_id}}", "feedback"],
              "query": [
                { "key": "tag1", "value": "trust", "disabled": true },
                { "key": "tag2", "value": "", "disabled": true },
                { "key": "since", "value": "2026-01-01T00:00:00Z", "disabled": true },
                { "key": "until", "value": "", "disabled": true },
                { "key": "include_revoked", "value": "false", "disabled": true },
                { "key": "page", "value": "1", "disabled": true },
                { "key": "per_page", "value": "20", "disabled": true }
              ]
            }
          }
        },
        {
          "name": "Get agent validations",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/agents/{{agent_id}}/validations",
              "host": ["{{base_url}}"],
              "path": ["v1", "agents", "{{agent_id}}", "validations"],
              "query": [
                { "key": "tag", "value": "tee-attestation", "disabled": true },
                { "key": "has_response", "value": "true", "disabled": true },
                { "key": "since", "value": "", "disabled": true },
                { "key": "until", "value": "", "disabled": true },
                { "key": "page", "value": "1", "disabled": true },
                { "key": "per_page", "value": "20", "disabled": true }
              ]
            }
          }
        },
        {
          "name": "Get agent validation summary",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/agents/{{agent_id}}/validations/summary",
              "host": ["{{base_url}}"],
              "path": ["v1", "agents", "{{agent_id}}", "validations", "summary"]
            }
          }
        },
        {
          "name": "Get agent reputation",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/agents/{{agent_id}}/reputation",
              "host": ["{{base_url}}"],
              "path": ["v1", "agents", "{{agent_id}}", "reputation"],
              "query": [
                { "key": "network", "value": "base-mainnet", "disabled": true }
              ]
            }
          }
        },
        {
          "name": "Global feedback feed",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/feedback",
              "host": ["{{base_url}}"],
              "path": ["v1", "feedback"],
              "query": [
                { "key": "network", "value": "base-mainnet", "disabled": true },
                { "key": "include_revoked", "value": "false", "disabled": true },
                { "key": "page", "value": "1", "disabled": true },
                { "key": "per_page", "value": "20", "disabled": true }
              ]
            }
          }
        },
        {
          "name": "Validator requests",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/validators/{{validator_address}}/requests",
              "host": ["{{base_url}}"],
              "path": ["v1", "validators", "{{validator_address}}", "requests"],
              "query": [
                { "key": "network", "value": "base-mainnet", "disabled": true },
                { "key": "tag", "value": "tee-attestation", "disabled": true },
                { "key": "has_response", "value": "true", "disabled": true }
              ]
            }
          }
        }
      ]
    },
    {
      "name": "Health",
      "item": [
        {
          "name": "Healthz",
          "request": {
            "method": "GET",
            "header": [],
            "url": { "raw": "{{base_url}}/healthz", "host": ["{{base_url}}"], "path": ["healthz"] }
          }
        }
      ]
    }
  ],
  "variable": [
    { "key": "base_url", "value": "https://erc-8004.quicknode.com" },
    { "key": "agent_id", "value": "1" },
    { "key": "owner_address", "value": "0x0000000000000000000000000000000000000000" },
    { "key": "validator_address", "value": "0x0000000000000000000000000000000000000000" }
  ]
}