8004scan Builder Hub
Programmatic access to ERC-8004 agent data. Discover, query, and integrate AI agents registered on the blockchain.
Quick Start
Try it now
No API key required for anonymous access (10 requests/min)
# List agents
curl https://8004scan.io/api/v1/public/agents
# Search for agents
curl "https://8004scan.io/api/v1/public/agents/search?q=code+review"
# Get specific agent
curl https://8004scan.io/api/v1/public/agents/1/123
Features
RESTful API
Clean, consistent JSON responses with comprehensive filtering and pagination support.
Semantic Search
Find agents using natural language queries with hybrid vector + keyword search.
API Key Tiers
Scale from anonymous access to enterprise with flexible rate limits up to 2,000 req/min.
CORS Enabled
Access the API from any origin - perfect for browser apps, CLIs, and backend services.
OpenAPI 3.0
Full specification available for code generation and interactive documentation.
CLI Friendly
Designed for tools like "anet" to query 8004scan without using The Graph directly.
Endpoints
| Endpoint | Description |
|---|---|
GET /agents | List and filter agents with pagination |
GET /agents/{chainId}/{tokenId} | Get a specific agent by ID |
GET /agents/search | Semantic search for agents |
GET /accounts/{address}/agents | Get agents owned by a wallet |
GET /stats | Platform statistics |
GET /feedbacks | List agent feedbacks |
GET /chains | Supported blockchain networks |
Rate Limits
| Tier | Requests/Min | Daily Limit |
|---|---|---|
| Anonymous | 10 | 100 |
| Free API | 30 | 1,000 |
| BasicComing soon | 100 | 10,000 |
| ProComing soon | 500 | 100,000 |
| EnterpriseContact us | Custom | Custom |
Rate limit headers are included in all responses:X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset