REST API Reference — Agent Chain Docs

← Back to Agent Chain

🌐 REST API Reference

All endpoints, authentication, rate limits, and error handling

Base URL

https://api.agent-chain.io

Authentication

All billable endpoints require an API key in the Authorization header:

Authorization: Bearer ac_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API keys are 72 characters: ac_live_ prefix (8 chars) + 64 hex characters. Get one by signing up at agent-chain.io.

Rate Limits

Tier	Requests/min	Burst
Free	60	10
Hobby	120	20
Starter	300	50
Scale	600	100
Pro	1,200	200
Business	3,000	500
Enterprise	6,000	1,000

Response Format

All responses are JSON with a consistent structure:

{ "ok": true, "data": { ... }, "meta": { "requestId": "req_abc123", "quotaUsed": 1, "quotaRemaining": 4999, "latency_ms": 23 } }

Error Format

{ "ok": false, "error": { "code": "RATE_LIMIT_EXCEEDED", "message": "You have exceeded your rate limit. Try again in 15 seconds.", "status": 429, "retryAfter": 15 } }

Common Error Codes

Status	Code	Description
400	BAD_REQUEST	Invalid request body or parameters
401	UNAUTHORIZED	Missing or invalid API key
403	FORBIDDEN	API key valid but insufficient permissions
404	NOT_FOUND	Resource not found
409	CONFLICT	Resource already exists (e.g., duplicate DID)
429	RATE_LIMIT_EXCEEDED	Too many requests — back off and retry
500	INTERNAL_ERROR	Server error — contact support

Endpoint Summary by Product

🪪 AC-1 Agent ID (6) 🩻 AC-2 Scanner (6) 🤝 AC-3 Trust (5) 🕵️ AC-4 Intel (6) 📦 AC-5 SDK (3 interfaces) 📋 AC-6 Audit (7) 🥷 AC-7 Shadow (9) 🔥 AC-8 Firewall (15) 📡 AC-9 Tracker (12)

AC-10 Agent Chain (10) 💰 AC-11 Payments (14) 🏪 AC-12 Market (20)

Total: 26 free endpoints + ~110 billable endpoints

💡 For detailed cost-per-call breakdown, see the API Call Pricing page.