ERC-8004 API: Agent Discovery &amp; Reputation

🤖

AI Enabled

🔑

Quicknode Exclusive

15Supported chains 9RPC Methods 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 via JSON-RPC.

ERC-8004 defines the onchain standard for AI agent identity and reputation. This add-on gives you a fully indexed, query-ready 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.

RPC Methods

Download OpenAPI Spec

erc8004_getAgent

Documentation

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

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

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

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

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

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

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

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

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

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);
})();

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

Free

$0.00/month