Skip to main content

​
Getting an API key

  1. Sign up at agentscore.sh
  2. Go to the dashboard
  3. Copy your API key (starts with as_live_)

​
Using your API key

Include the key in the X-API-Key header on every request: 
curl -H "X-API-Key: as_live_your_key_here" \
  https://api.agentscore.sh/v1/reputation/0x1234567890abcdef1234567890abcdef12345678

​
Error responses

​
Missing or invalid key (401)

{
  "error": {
    "code": "signup_required",
    "message": "Sign up for a free account to use the AgentScore API.",
    "signup_url": "https://agentscore.sh/sign-up"
  }
}

{
  "error": {
    "code": "payment_required",
    "message": "This endpoint requires a paid plan ($100/mo). Upgrade at https://agentscore.sh/pricing"
  }
}

​
Rate limits and quotas

TierPer-second limitRequest quota
Free1 req/sec50 lifetime
Paid ($100/mo)5 req/sec1,000/month
EnterpriseUnlimitedUnlimited
When you exceed the per-second rate limit, you’ll receive a 429 with code: "rate_limited". When you exceed your monthly or lifetime quota, you’ll receive a 429 with code: "quota_exceeded". Rate limit headers are included in every response:
HeaderDescription
X-RateLimit-LimitRequests per second allowed (e.g., 5/s or unlimited)
X-RateLimit-RemainingRequests remaining in current window
X-RateLimit-ResetSeconds until the rate limit window resets
X-Quota-LimitTotal request quota for your tier
X-Quota-UsedRequests used in current quota period
X-Quota-ResetDate when quota resets, e.g. 2026-05-01 (paid) or never (free). Omitted for enterprise.
Enterprise tier returns only X-RateLimit-Limit: unlimited with no remaining, reset, or quota headers.

​
Key management

  • Keys can be regenerated from the dashboard
  • Each account gets one active key
  • Enterprise accounts can request multiple keys