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
Official API base URL: https://api-staging.8004scan.io/api/v1
# List agents
curl https://api-staging.8004scan.io/api/v1/agents
# Search for agents
curl "https://api-staging.8004scan.io/api/v1/agents/search/semantic?q=code+review"
# Get specific agent
curl -H "X-API-Key: YOUR_API_KEY" https://api-staging.8004scan.io/api/v1/agents/8453/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
Backend-enforced tiers scale from anonymous access to enterprise with limits up to 10,000 req/min.
Server-first Authentication
Keep API keys in trusted backends or CLI tools. Browser apps should call their own server and must not expose keys in client code.
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 /api/v1/agents | List and filter agents with pagination |
GET /api/v1/agents/{chainId}/{tokenId} | Get a specific agent by ID |
GET /api/v1/agents/search/semantic | Semantic search for agents |
GET /api/v1/agents?owner_address={address} | Get agents owned by a wallet |
GET /api/v1/stats/global | Platform statistics |
GET /api/v1/feedbacks | List agent feedbacks |
GET /api/v1/chains | Supported blockchain networks |
Rate Limits
| Tier | Requests/Min | Daily Limit |
|---|---|---|
| Anonymous | 30 | 1,000 |
| Free API | 600 | 100,000 |
| BasicContact us | 900 | 300,000 |
| ProContact us | 3,000 | 3,000,000 |
| EnterpriseContact us | 10,000 | Unlimited |
Rate limit headers are included in all responses:X-RateLimit-Tier,X-RateLimit-Limit-Minute,X-RateLimit-Remaining-Minute,X-RateLimit-Limit-Day, andX-RateLimit-Remaining-Day