Partner API Documentation

Access CryptoGrade's ratings, rubrics, and research programmatically via our REST API.

Authentication

All API endpoints require a Partner API key. Provide your key in the Authorization header using the Bearer scheme.

Authorization: Bearer <YOUR_API_KEY>
Key Secrecy & Rotation

Your API key is a secret that grants access to your partner account. Never commit it to source control or expose it in client-side code.

If a key is compromised, contact your account manager to revoke it immediately and issue a replacement.

Self-Service & Billing

Self-service API key generation and automated billing are not currently available.

Usage limits are negotiated per partner. Please contact us to adjust your rate limits or quotas.

API Foundations

Base URL

https://cryptograde.ai/api/partner/v1

Scopes

Your API key must have the appropriate scope to access specific endpoints:

scores
Current Ratings
Read access to the latest asset grades and scores.
history
Time-Series Data
Access to historical daily scores over time.
research
Deep Dives
Read access to detailed rationales, risk analysis, and thesis.

Pagination

List endpoints use bounded limit/offset pagination. Parameters:

  • limit: Number of items to return. Max varies by endpoint.
  • offset: Number of items to skip.

Error Codes & Rate Limiting

401
Unauthorized — Missing, invalid, revoked, or expired API key.
403
Forbidden — API key lacks the required scope for this endpoint.
429
Too Many Requests — You have exceeded your per-minute or per-day quota.
Check the Retry-After header for the number of seconds to wait before retrying.
Data LimitationsThe Partner API provides CryptoGrade's proprietary analysis and scores. It does not serve raw third-party market data (e.g., real-time prices, raw TVL numbers, or live developer commit counts).

Endpoints

GET
/scores
Scope: scores

Retrieve a paginated list of the most recent ratings for all covered assets.

Query Parameters
limit=50 (default) | max: 100
offset=0 (default)
GET
/tokens/{id}
Scope: scores

Retrieve the current rating, identity, and verdict for a specific asset. You can use its internal ID, URL slug, or ticker symbol for {id}.

GET
/tokens/{id}/history
Scope: history

Retrieve historical daily scores for a specific asset, returned in descending order (newest first).

Query Parameters
limit=100 (default) | max: 366
offset=0 (default)
GET
/tokens/{id}/research
Scope: research

Retrieve detailed AI research, risk factors, and investment thesis for a specific asset.