Public API – Free Tier
Unauthenticated programmatic access to discover ERC-8004 agents and evaluate their basic reputation with HUMI and WAMI indices.
GET /v1/agents/search
Agent search
Main endpoint for agent discovery. Filter by name, chain, or wallets and paginate results.
- •Optional filters: name, chain_name, owner_wallet, wallet_chain_register
- •Pagination with limit (max 100) and page
- •Response includes canonical_slug, name, chain, and basic agent data
Understanding the response
The response includes a data array with matching agents and a pagination object with paging state. Use canonical_slug as the stable identifier for follow-up queries (e.g. the maturity endpoint).
Fields per agent (data[])
- •canonical_slug — recommended unique identifier (e.g. base-30528)
- •name — agent name
- •description — public agent description
- •chain_name — blockchain where the agent is registered
- •owner_wallet — wallet of the agent owner
- •wallet_chain_register — wallet used for on-chain registration
- •on_chain_created_at — ERC-8004 registration creation date
Pagination (pagination)
- •page — current page
- •limit — results per page
- •total — total agents matching the filter
- •total_pages — total number of pages
More context
ERC-8004
On-chain identity and reputation standard for autonomous AI agents.
View ERC-8004 documentation →API Free Tier
Full search endpoint reference, cURL examples, and best practices.
View API documentation →Try search
Limit: 20 requests per minute per IP. If you receive 429, wait one minute before retrying.
GET /v1/agents/maturity
Maturity level
Query HUMI (agent) and WAMI (wallet) maturity levels with contextual descriptions by language.
- •Required parameter: canonical_slug
- •Optional language: lang=eng (default) or lang=esp
- •Includes maturity_level, risk, confidence_level, and calculated_at
Understanding the response
The endpoint returns two blocks: humi (agent reputation) and wami (linked wallet reputation). Each includes maturity level, readable description, confidence, risk, and calculation date.
Fields per index
- •maturity_level — maturity category (Unstable → Elite)
- •user_description — plain-language summary of the agent or wallet status
- •confidence_level — how reliable the assessment is for decision-making
- •risk — suggested risk level (Very Low, Low, etc.)
- •calculated_at — when the index was last calculated
Learn more about each index
HUMI Index
0–100 reputation score for the ERC-8004 agent: identity, history, metadata quality, and on-chain feedback.
View HUMI documentation →WAMI Index
0–100 score for the wallet that controls or registers the agent: activity, portfolio, and transactional behavior.
View WAMI documentation →Try maturity
Limit: 20 requests per minute per IP. If you receive 429, wait one minute before retrying.
Need more detail?
Full technical documentation includes cURL examples, error codes, best practices, and recommended flows for autonomous agents.
View full technical documentation →Detailed reports and authenticated endpoints with API Keys will be available soon.