SKOOR

SKOOR Connect

Connect API Reference

5 endpoints for fleet risk, decisions, score feeds, compliance certificates, and public verification.

Authentication

All endpoints except /verify/:certId require an API key passed via the X-API-Key header.

curl -H "X-API-Key: sk_live_your_key_here" \
  "https://api.skoor.ai/v1/connect/..."}

Get your API key at skoor.ai/get-started. Free keys get 100 queries/day.

Base URL

https://api.skoor.ai/v1/connect
GET/fleet-risk

Fleet Risk Report

Returns aggregate risk grade, premium multiplier, compliance rate, and per-entity scores for all agents owned by an address.

Parameters

NameTypeRequiredDescription
ownerstringYesOwner wallet address (0x...)
chainIdnumberNoFilter by chain ID (default: all chains)

Request

curl -H "X-API-Key: sk_live_..." \
  "https://api.skoor.ai/v1/connect/fleet-risk?owner=0x1234...abcd"

Response

{
  "owner": "0x1234...abcd",
  "fleetSize": 3,
  "riskGrade": "B+",
  "avgScore": 742,
  "premiumMultiplier": 0.85,
  "complianceRate": 1.0,
  "entities": [
    { "address": "0xaa...", "score": 780, "tier": "good" },
    { "address": "0xbb...", "score": 720, "tier": "good" },
    { "address": "0xcc...", "score": 725, "tier": "good" }
  ]
}

Error Codes

401Missing or invalid API key
404No entities found for owner
429Rate limit exceeded
GET/decide

Decision

Returns a single verdict (PROCEED, REVIEW, or BLOCK) based on an agent's score and your minimum threshold.

Parameters

NameTypeRequiredDescription
addressstringYesAgent wallet address (0x...)
minScorenumberNoMinimum acceptable score (default: 670)

Request

curl -H "X-API-Key: sk_live_..." \
  "https://api.skoor.ai/v1/connect/decide?address=0xaa11...ff22&minScore=670"

Response

{
  "address": "0xaa11...ff22",
  "score": 780,
  "tier": "good",
  "verdict": "PROCEED",
  "minScore": 670,
  "margin": 110,
  "complianceStatus": "clear",
  "decidedAt": "2026-06-10T12:00:00Z"
}

Error Codes

401Missing or invalid API key
404Agent not found or not scored
429Rate limit exceeded
GET/score-feed

Score Feed

Bulk access to all scored agents. Filter by chain, minimum score, or badge tier. Paginated results.

Parameters

NameTypeRequiredDescription
chainIdnumberNoFilter by chain ID
minScorenumberNoMinimum score threshold
tierstringNoFilter by tier: exceptional, good, fair, poor
limitnumberNoResults per page (default: 100, max: 1000)
offsetnumberNoPagination offset (default: 0)

Request

curl -H "X-API-Key: sk_live_..." \
  "https://api.skoor.ai/v1/connect/score-feed?chainId=8453&minScore=700&limit=100"

Response

{
  "total": 12847,
  "limit": 100,
  "offset": 0,
  "agents": [
    {
      "address": "0xaa...",
      "score": 812,
      "tier": "exceptional",
      "chainId": 8453,
      "badge": "autonomous",
      "lastUpdated": "2026-06-10T11:55:00Z"
    },
    {
      "address": "0xbb...",
      "score": 780,
      "tier": "good",
      "chainId": 8453,
      "badge": "verified",
      "lastUpdated": "2026-06-10T11:50:00Z"
    }
  ]
}

Error Codes

401Missing or invalid API key
400Invalid parameters (e.g., limit > 1000)
429Rate limit exceeded
GET/compliance-cert

Compliance Certificate

Generates a verifiable compliance certificate proving an agent has passed OFAC/SDN screening. Certificate includes a unique ID for public verification.

Parameters

NameTypeRequiredDescription
addressstringYesAgent wallet address (0x...)

Request

curl -H "X-API-Key: sk_live_..." \
  "https://api.skoor.ai/v1/connect/compliance-cert?address=0xaa11...ff22"

Response

{
  "certId": "cert_8f3a2b1c",
  "address": "0xaa11...ff22",
  "status": "clear",
  "screenedAgainst": ["OFAC/SDN", "EU Sanctions"],
  "issuedAt": "2026-06-10T12:00:00Z",
  "expiresAt": "2026-06-17T12:00:00Z",
  "verifyUrl": "https://api.skoor.ai/v1/connect/verify/cert_8f3a2b1c",
  "signature": "0x3a4b5c..."
}

Error Codes

401Missing or invalid API key
404Agent not found
429Rate limit exceeded
GET/verify/:certId

Verify Certificate (Public)

Publicly verifiable endpoint. No authentication required. Returns the validity status of a compliance certificate.

Parameters

NameTypeRequiredDescription
certIdstringYesCertificate ID (path parameter)

Request

curl "https://api.skoor.ai/v1/connect/verify/cert_8f3a2b1c"

Response

{
  "certId": "cert_8f3a2b1c",
  "valid": true,
  "address": "0xaa11...ff22",
  "status": "clear",
  "issuedAt": "2026-06-10T12:00:00Z",
  "expiresAt": "2026-06-17T12:00:00Z"
}

Error Codes

404Certificate not found
410Certificate expired

Rate Limits

PlanQuery LimitNote
Free100/dayNo fleet reports
Starter10K/mo10 fleet reports/mo
Pro100K/mo100 fleet reports/mo
EnterpriseUnlimitedCustom SLA
See Full Pricing

Related

SKOOR Connect

Overview of all 4 data products

Fleet Risk Reports

Deep dive on fleet scoring

Pricing

Free to Enterprise tiers

Start Querying Agent Scores

Get your free API key and make your first query in under 2 minutes.

Get Your API Key