8004scan Builder Hub
Programmatic access to 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
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, and X-RateLimit-Remaining-Day