Beta

ERC-8004 API: Agent Discovery & Reputation

by Quicknode 15Supported chains 9RPC Methods 9 REST Paths 1Plan

Starting from FREE

🤖

AI Enabled

🔑

Quicknode Exclusive

15Supported chains 9RPC Methods 9REST Paths 1Plan

Starting from FREE

Back to Marketplace

ERC-8004 API: Agent Discovery & Reputation image 0

This add-on is currently in Beta

Feel free to test it, we would appreciate feedback to address any errors that may occur

Supported Chains

Published on Apr 30, 2026

Support Website Support Email

Discover, query, and evaluate ERC-8004 AI agents. Search by owner or network, retrieve reputation scores, and access full feedback and validation history across 15+ networks.

ERC-8004 defines the onchain standard for AI agent identity and reputation. This add-on gives you a fully indexed, query-ready REST and JSON-RPC interface: no node syncing, no event log parsing, no reputation formula to implement yourself. Discover registered agents by owner address or network, and retrieve their transparently computed reputation score. List an agent's full feedback and validation history, query outstanding validator requests, and filter across mainnet and testnet deployments, all from the endpoint you already have. Reputation scores are computed using feedback scoring, sybil resistance, reliability, and validator-weighted signals. The underlying data is continuously indexed from live contract events across every supported network, so results always reflect current onchain state. Coverage spans 15 mainnets and 11 testnets across the most widely used EVM-compatible chains, making this the broadest single-endpoint source of ERC-8004 agent data available.

Download OpenAPI Spec

RPC Methods

erc8004_getAgent

Returns the full identity record for a single ERC-8004 registered agent, including owner address, agent URI, resolved metadata, registration timestamp, and aggregate feedback and validation counts.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"erc8004_getAgent","params":["25255", "{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"],"id":1,"jsonrpc":"2.0"}'

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  const data = {
    jsonrpc: "2.0",
    id: 1,
    method: "erc8004_getAgent","params":["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"],
  };
  axios
    .post(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com",
      data,
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

from jsonrpcclient import request, parse, Ok
import logging
import requests
response = requests.post("https://YOUR_QUICKNODE_ENDPOINT_HERE.com", json=request("erc8004_getAgent",["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"]))
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'erc8004_getAgent',["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"erc8004_getAgent","params":["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "erc8004_getAgent",["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"]
  );
  console.log(network);
})();

erc8004_searchAgents

Returns a paginated list of registered agents, optionally filtered by owner address and/or network. Results are ordered by agent ID descending. The primary method for agent discovery across all supported networks.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"erc8004_searchAgents","params":["{ \"owner\": \"0x806eca4d9e4cebea43df3d0fbb4867aa59422c7a\", \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"page\": 1, \"perPage\": 25 }"],"id":1,"jsonrpc":"2.0"}'

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  const data = {
    jsonrpc: "2.0",
    id: 1,
    method: "erc8004_searchAgents","params":["{ \"owner\": \"0x806eca4d9e4cebea43df3d0fbb4867aa59422c7a\", \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"page\": 1, \"perPage\": 25 }"],
  };
  axios
    .post(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com",
      data,
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

from jsonrpcclient import request, parse, Ok
import logging
import requests
response = requests.post("https://YOUR_QUICKNODE_ENDPOINT_HERE.com", json=request("erc8004_searchAgents",["{ \"owner\": \"0x806eca4d9e4cebea43df3d0fbb4867aa59422c7a\", \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"page\": 1, \"perPage\": 25 }"]))
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'erc8004_searchAgents',["{ \"owner\": \"0x806eca4d9e4cebea43df3d0fbb4867aa59422c7a\", \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"page\": 1, \"perPage\": 25 }"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"erc8004_searchAgents","params":["{ \"owner\": \"0x806eca4d9e4cebea43df3d0fbb4867aa59422c7a\", \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"page\": 1, \"perPage\": 25 }"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "erc8004_searchAgents",["{ \"owner\": \"0x806eca4d9e4cebea43df3d0fbb4867aa59422c7a\", \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"page\": 1, \"perPage\": 25 }"]
  );
  console.log(network);
})();

erc8004_getFeedback

Returns a paginated global feed of feedback records across all agents and networks. Each record is prefixed with the owning agent's on-chain ID and network. Supports filtering by network and revocation status.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"erc8004_getFeedback","params":["{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"includeRevoked\": false, \"page\": 1, \"perPage\": 20 }"],"id":1,"jsonrpc":"2.0"}'

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  const data = {
    jsonrpc: "2.0",
    id: 1,
    method: "erc8004_getFeedback","params":["{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"includeRevoked\": false, \"page\": 1, \"perPage\": 20 }"],
  };
  axios
    .post(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com",
      data,
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

from jsonrpcclient import request, parse, Ok
import logging
import requests
response = requests.post("https://YOUR_QUICKNODE_ENDPOINT_HERE.com", json=request("erc8004_getFeedback",["{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"includeRevoked\": false, \"page\": 1, \"perPage\": 20 }"]))
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'erc8004_getFeedback',["{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"includeRevoked\": false, \"page\": 1, \"perPage\": 20 }"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"erc8004_getFeedback","params":["{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"includeRevoked\": false, \"page\": 1, \"perPage\": 20 }"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "erc8004_getFeedback",["{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"includeRevoked\": false, \"page\": 1, \"perPage\": 20 }"]
  );
  console.log(network);
})();

erc8004_getAgentFeedback

Returns a paginated list of on-chain feedback records submitted against a specific agent. Supports filtering by revocation status. Each record includes the client address, value, tags, endpoint, and submission timestamp.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"erc8004_getAgentFeedback","params":["25255", "{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"includeRevoked\": false, \"page\": 1, \"perPage\": 20 }"],"id":1,"jsonrpc":"2.0"}'

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  const data = {
    jsonrpc: "2.0",
    id: 1,
    method: "erc8004_getAgentFeedback","params":["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"includeRevoked\": false, \"page\": 1, \"perPage\": 20 }"],
  };
  axios
    .post(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com",
      data,
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

from jsonrpcclient import request, parse, Ok
import logging
import requests
response = requests.post("https://YOUR_QUICKNODE_ENDPOINT_HERE.com", json=request("erc8004_getAgentFeedback",["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"includeRevoked\": false, \"page\": 1, \"perPage\": 20 }"]))
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'erc8004_getAgentFeedback',["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"includeRevoked\": false, \"page\": 1, \"perPage\": 20 }"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"erc8004_getAgentFeedback","params":["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"includeRevoked\": false, \"page\": 1, \"perPage\": 20 }"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "erc8004_getAgentFeedback",["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false, \"includeRevoked\": false, \"page\": 1, \"perPage\": 20 }"]
  );
  console.log(network);
})();

erc8004_getAgentValidations

Returns a paginated list of validation records for a specific agent. Supports filtering by tag and response status. Each record includes the validator address, request and response URIs and hashes, response score, and timestamps.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"erc8004_getAgentValidations","params":["4821", "{ \"network\": \"base-sepolia\", \"includeTestnets\": true, \"tag\": \"goal-progress\", \"hasResponse\": true, \"page\": 1, \"perPage\": 20 }"],"id":1,"jsonrpc":"2.0"}'

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  const data = {
    jsonrpc: "2.0",
    id: 1,
    method: "erc8004_getAgentValidations","params":["4821","{ \"network\": \"base-sepolia\", \"includeTestnets\": true, \"tag\": \"goal-progress\", \"hasResponse\": true, \"page\": 1, \"perPage\": 20 }"],
  };
  axios
    .post(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com",
      data,
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

from jsonrpcclient import request, parse, Ok
import logging
import requests
response = requests.post("https://YOUR_QUICKNODE_ENDPOINT_HERE.com", json=request("erc8004_getAgentValidations",["4821","{ \"network\": \"base-sepolia\", \"includeTestnets\": true, \"tag\": \"goal-progress\", \"hasResponse\": true, \"page\": 1, \"perPage\": 20 }"]))
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'erc8004_getAgentValidations',["4821","{ \"network\": \"base-sepolia\", \"includeTestnets\": true, \"tag\": \"goal-progress\", \"hasResponse\": true, \"page\": 1, \"perPage\": 20 }"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"erc8004_getAgentValidations","params":["4821","{ \"network\": \"base-sepolia\", \"includeTestnets\": true, \"tag\": \"goal-progress\", \"hasResponse\": true, \"page\": 1, \"perPage\": 20 }"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "erc8004_getAgentValidations",["4821","{ \"network\": \"base-sepolia\", \"includeTestnets\": true, \"tag\": \"goal-progress\", \"hasResponse\": true, \"page\": 1, \"perPage\": 20 }"]
  );
  console.log(network);
})();

erc8004_getAgentReputation

Returns the full computed reputation score for an agent under formula v1.3. Includes the composite 0–100 score, confidence tier, per-component breakdown (feedback score, sybil resistance, reliability, validation score), active weights, and sybil-hardening diagnostics including concentration exclusions and variance discount status.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"erc8004_getAgentReputation","params":["25255", "{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"],"id":1,"jsonrpc":"2.0"}'

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  const data = {
    jsonrpc: "2.0",
    id: 1,
    method: "erc8004_getAgentReputation","params":["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"],
  };
  axios
    .post(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com",
      data,
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

from jsonrpcclient import request, parse, Ok
import logging
import requests
response = requests.post("https://YOUR_QUICKNODE_ENDPOINT_HERE.com", json=request("erc8004_getAgentReputation",["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"]))
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'erc8004_getAgentReputation',["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"erc8004_getAgentReputation","params":["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "erc8004_getAgentReputation",["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"]
  );
  console.log(network);
})();

erc8004_getAgentStats

Returns lightweight summary statistics for an agent: total feedback count, validation count, average validation response score, and a snapshot of the 10 most recent active feedback entries.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"erc8004_getAgentStats","params":["25255", "{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"],"id":1,"jsonrpc":"2.0"}'

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  const data = {
    jsonrpc: "2.0",
    id: 1,
    method: "erc8004_getAgentStats","params":["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"],
  };
  axios
    .post(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com",
      data,
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

from jsonrpcclient import request, parse, Ok
import logging
import requests
response = requests.post("https://YOUR_QUICKNODE_ENDPOINT_HERE.com", json=request("erc8004_getAgentStats",["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"]))
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'erc8004_getAgentStats',["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"erc8004_getAgentStats","params":["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "erc8004_getAgentStats",["25255","{ \"network\": \"ethereum-mainnet\", \"includeTestnets\": false }"]
  );
  console.log(network);
})();

erc8004_getValidatorRequests

Returns a paginated list of all validation requests submitted by a given validator address, with a summary of total validations, completion count, and average response score. Supports filtering by tag, response status, and network.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"erc8004_getValidatorRequests","params":["0x12b456dcc0e669eeb1d96806c8ef87b713d39cc8", "{ \"tag\": \"KYC_VERIFIED\", \"hasResponse\": true, \"network\": \"base-sepolia\", \"includeTestnets\": true, \"page\": 1, \"perPage\": 20 }"],"id":1,"jsonrpc":"2.0"}'

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  const data = {
    jsonrpc: "2.0",
    id: 1,
    method: "erc8004_getValidatorRequests","params":["0x12b456dcc0e669eeb1d96806c8ef87b713d39cc8","{ \"tag\": \"KYC_VERIFIED\", \"hasResponse\": true, \"network\": \"base-sepolia\", \"includeTestnets\": true, \"page\": 1, \"perPage\": 20 }"],
  };
  axios
    .post(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com",
      data,
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

from jsonrpcclient import request, parse, Ok
import logging
import requests
response = requests.post("https://YOUR_QUICKNODE_ENDPOINT_HERE.com", json=request("erc8004_getValidatorRequests",["0x12b456dcc0e669eeb1d96806c8ef87b713d39cc8","{ \"tag\": \"KYC_VERIFIED\", \"hasResponse\": true, \"network\": \"base-sepolia\", \"includeTestnets\": true, \"page\": 1, \"perPage\": 20 }"]))
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'erc8004_getValidatorRequests',["0x12b456dcc0e669eeb1d96806c8ef87b713d39cc8","{ \"tag\": \"KYC_VERIFIED\", \"hasResponse\": true, \"network\": \"base-sepolia\", \"includeTestnets\": true, \"page\": 1, \"perPage\": 20 }"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"erc8004_getValidatorRequests","params":["0x12b456dcc0e669eeb1d96806c8ef87b713d39cc8","{ \"tag\": \"KYC_VERIFIED\", \"hasResponse\": true, \"network\": \"base-sepolia\", \"includeTestnets\": true, \"page\": 1, \"perPage\": 20 }"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "erc8004_getValidatorRequests",["0x12b456dcc0e669eeb1d96806c8ef87b713d39cc8","{ \"tag\": \"KYC_VERIFIED\", \"hasResponse\": true, \"network\": \"base-sepolia\", \"includeTestnets\": true, \"page\": 1, \"perPage\": 20 }"]
  );
  console.log(network);
})();

erc8004_getValidationSummary

Returns aggregate validation statistics for an agent: total completed validation count and average response score. Optionally scoped to a specific set of validator addresses and/or tag.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01
02
03
04

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"erc8004_getValidationSummary","params":["4821", "{ \"validators\": [\"0xf99f05904194ef8394d484a9c3519b9ea6240aca\"], \"tag\": \"goal-progress\", \"network\": \"base-sepolia\", \"includeTestnets\": true }"],"id":1,"jsonrpc":"2.0"}'

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  const data = {
    jsonrpc: "2.0",
    id: 1,
    method: "erc8004_getValidationSummary","params":["4821","{ \"validators\": [\"0xf99f05904194ef8394d484a9c3519b9ea6240aca\"], \"tag\": \"goal-progress\", \"network\": \"base-sepolia\", \"includeTestnets\": true }"],
  };
  axios
    .post(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com",
      data,
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

from jsonrpcclient import request, parse, Ok
import logging
import requests
response = requests.post("https://YOUR_QUICKNODE_ENDPOINT_HERE.com", json=request("erc8004_getValidationSummary",["4821","{ \"validators\": [\"0xf99f05904194ef8394d484a9c3519b9ea6240aca\"], \"tag\": \"goal-progress\", \"network\": \"base-sepolia\", \"includeTestnets\": true }"]))
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'erc8004_getValidationSummary',["4821","{ \"validators\": [\"0xf99f05904194ef8394d484a9c3519b9ea6240aca\"], \"tag\": \"goal-progress\", \"network\": \"base-sepolia\", \"includeTestnets\": true }"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"erc8004_getValidationSummary","params":["4821","{ \"validators\": [\"0xf99f05904194ef8394d484a9c3519b9ea6240aca\"], \"tag\": \"goal-progress\", \"network\": \"base-sepolia\", \"includeTestnets\": true }"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "erc8004_getValidationSummary",["4821","{ \"validators\": [\"0xf99f05904194ef8394d484a9c3519b9ea6240aca\"], \"tag\": \"goal-progress\", \"network\": \"base-sepolia\", \"includeTestnets\": true }"]
  );
  console.log(network);
})();

REST Paths

GET /v1/agents

Returns a paginated list of registered agents, optionally filtered by owner address and/or network. Results are ordered by agent ID descending. The primary method for agent discovery across all supported networks.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents?owner=0x806eca4d9e4cebea43df3d0fbb4867aa59422c7a&network=ethereum-mainnet&page=1&per_page=25 \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents?owner=0x806eca4d9e4cebea43df3d0fbb4867aa59422c7a&network=ethereum-mainnet&page=1&per_page=25",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents?owner=0x806eca4d9e4cebea43df3d0fbb4867aa59422c7a&network=ethereum-mainnet&page=1&per_page=25")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /v1/agents/{agent_id}

Returns the full identity record for a single ERC-8004 registered agent, including owner address, agent URI, resolved metadata, registration timestamp, and aggregate feedback and validation counts.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/25255?network=ethereum-mainnet \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/25255?network=ethereum-mainnet",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/25255?network=ethereum-mainnet")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /v1/agents/{agent_id}/feedback

Returns a paginated list of on-chain feedback records submitted against a specific agent. Supports filtering by revocation status. Each record includes the client address, value, tags, endpoint, and submission timestamp.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/25255/feedback?network=ethereum-mainnet&page=1&per_page=20 \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/25255/feedback?network=ethereum-mainnet&page=1&per_page=20",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/25255/feedback?network=ethereum-mainnet&page=1&per_page=20")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /v1/agents/{agent_id}/reputation

Returns the full computed reputation score for an agent under formula v1.3. Includes the composite 0–100 score, confidence tier, per-component breakdown (feedback score, sybil resistance, reliability, validation score), active weights, and sybil-harden...

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/25255/reputation?network=ethereum-mainnet \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/25255/reputation?network=ethereum-mainnet",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/25255/reputation?network=ethereum-mainnet")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /v1/agents/{agent_id}/stats

Returns lightweight summary statistics for an agent: total feedback count, validation count, average validation response score, and a snapshot of the 10 most recent active feedback entries.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/4821/stats?network=base-sepolia&include_testnets=true?network=base-sepolia&include_testnets=true \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/4821/stats?network=base-sepolia&include_testnets=true?network=base-sepolia&include_testnets=true",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/4821/stats?network=base-sepolia&include_testnets=true?network=base-sepolia&include_testnets=true")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /v1/agents/{agent_id}/validations

Returns a paginated list of validation records for a specific agent. Supports filtering by tag and response status. Each record includes the validator address, request and response URIs and hashes, response score, and timestamps.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/4821/validations?network=base-sepolia&include_testnets=true&tag=goal-progress&has_response=true&page=1&per_page=20 \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/4821/validations?network=base-sepolia&include_testnets=true&tag=goal-progress&has_response=true&page=1&per_page=20",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/4821/validations?network=base-sepolia&include_testnets=true&tag=goal-progress&has_response=true&page=1&per_page=20")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /v1/agents/{agent_id}/validations/summary

Returns aggregate validation statistics for an agent: total completed validation count and average response score. Optionally scoped to a specific set of validator addresses and/or tag.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/4821/validations/summary?network=base-sepolia&include_testnets=true&validators[]=0xf99f05904194ef8394d484a9c3519b9ea6240aca&tag=goal-progress \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/4821/validations/summary?network=base-sepolia&include_testnets=true&validators[]=0xf99f05904194ef8394d484a9c3519b9ea6240aca&tag=goal-progress",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/agents/4821/validations/summary?network=base-sepolia&include_testnets=true&validators[]=0xf99f05904194ef8394d484a9c3519b9ea6240aca&tag=goal-progress")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /v1/feedback

Returns a paginated global feed of feedback records across all agents and networks. Each record is prefixed with the owning agent's on-chain ID and network. Supports filtering by network and revocation status.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/feedback?network=ethereum-mainnet&page=1&per_page=20 \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/feedback?network=ethereum-mainnet&page=1&per_page=20",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/feedback?network=ethereum-mainnet&page=1&per_page=20")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /v1/validators/{address}/requests

Returns a paginated list of all validation requests submitted by a given validator address, with a summary of total validations, completion count, and average response score. Supports filtering by tag, response status, and network.

Sample code

Curl
Axios
Python
Web3
Eth
Ethers.js

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/validators/0x12b456dcc0e669eeb1d96806c8ef87b713d39cc8/requests?network=base-sepolia&include_testnets=true&tag=KYC_VERIFIED&has_response=true&page=1&per_page=20 \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/validators/0x12b456dcc0e669eeb1d96806c8ef87b713d39cc8/requests?network=base-sepolia&include_testnets=true&tag=KYC_VERIFIED&has_response=true&page=1&per_page=20",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1150/v1/validators/0x12b456dcc0e669eeb1d96806c8ef87b713d39cc8/requests?network=base-sepolia&include_testnets=true&tag=KYC_VERIFIED&has_response=true&page=1&per_page=20")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

Supported Chains

Published on Apr 30, 2026

Support Website Support Email

Plans & features

Free - $0/month

Free - $0/month

Enterprise Sales

Free

$0.00/month

Enterprise

Contact us

Free

$0.00/month

1 RPS

Up to 1 requests per second.

10,000 Requests Per Month

Up to 10,000 requests per month.

Pre-Computed Reputation Scores

Query a fully computed 0–100 reputation score for any registered agent without running your own indexer or implementing the formula yourself.

Multi-Chain Agent Discovery

Search and filter registered ERC-8004 agents by owner address or network across 25+ networks in a single API call.

Full Feedback History

Access complete onchain feedback records for any agent, including submitter address, value, tags, endpoint, and revocation status.

Validation & Trust Signals

Retrieve per-agent validation records, aggregated response scores, and outstanding validator requests, with filtering by tag, validator address, and response status.