Reference
API Documentation
All SKOOR endpoints. Base URL: https://api.agentfinancial.ai
Authentication
Authenticated endpoints require an API key passed via the X-API-Key header or api_key query parameter.
Rate Limits
| Tier | Public | Starter | Pro | Enterprise |
|---|---|---|---|---|
| Calls/day | 10 (IP) | 100 | 10,000 | Unlimited |
| Batch size | — | — | 100 | 1,000 |
| Proofs/day | — | — | 100 | Unlimited |
Public (No Auth Required)
/v1/public/credit-score/:addressGet any agent's score. Rate limited: 10/min per IP.
{ agentId, score, tier, layer, ceiling, components, reasons, computedAt, trend }
/v1/public/credit-score/:address/badge.svgEmbeddable SVG badge. 5-min cache.
SVG image
/v1/skoor/analytics/distributionPlatform-wide score distribution. 1-hr cache.
{ totalAgents, mean, median, percentiles, tierDistribution }
/v1/skoor/analytics/leaderboard?limit=25Top agents by score (1-100).
{ agents: [{ agentId, score, tier, rank }], totalAgents }
/v1/skoor/analytics/percentile/:agentIdAgent's percentile rank.
{ percentileRank, topPercent, totalAgents }
/v1/skoor/verifyVerify a signed JWT proof. Body: { proof: string }
{ valid, agentId, score, tier, computedAt, expiresAt } or { valid: false, error }
/v1/skoor/specFull scoring specification (factors, tiers, layers, decay).
{ name, factors[], tiers[], coldStartLayers[], decay, verification }
/.well-known/skoor-jwks.jsonRSA public keys for JWT verification.
{ keys: [{ kty, n, e, kid, alg, use }] }
/.well-known/skoor-spec.jsonQuick metadata discovery.
{ name, version, scoreRange, factors, tiers }
Authenticated (X-API-Key Required)
/v1/agents/:agentId/credit-scoreFull score with components and reasons.
{ agentId, score, tier, layer, components, reasons, computedAt, trend }
/v1/agents/:agentId/credit-score/summaryLightweight score summary.
{ score, tier, computedAt }
/v1/agents/:agentId/credit-score/history?days=30Score history (1-365 days).
{ agentId, days, snapshots[] }
/v1/agents/credit-scoresBatch lookup (max 100). Body: { agentIds: string[] }
{ scores: [{ agentId, score, tier, computedAt }] }
/v1/agents/:agentId/credit-score/refreshForce recompute. Rate limit: 1/min per agent.
Full score object
/v1/skoor/proof/:agentIdGenerate signed JWT proof. 100/day per agent.
{ proof, proofId, expiresAt }
/v1/skoor/report/:agentId?period=90dFull credit report (history, transitions, milestones).
{ currentScore, previousScore, trend, transitions[], milestones[], factors[], percentile }