API Documentation

Every response includes rate limit headers so you always know where you stand. Limits reset daily at midnight UTC.

When you hit the limit, the API returns 429 Too Many Requests. The best practice is to check X-RateLimit-Remaining and back off before hitting zero. Our SDK handles this automatically with exponential backoff.

Get the top 5 coding models in a single request:

curl "https://api.lmmarketcap.com/v1/rankings/coding?limit=5" \
  -H "X-API-Key: YOUR_API_KEY"

Errors follow a consistent format. The code field is machine-readable, and message is a human-friendly explanation.

{
  "error": {
    "code": "not_found",
    "message": "No model found with slug 'gpt-5-turbo'. Did you mean 'gpt-4-turbo'?"
  }
}

List endpoints use cursor-based pagination. Each response includes a pagination object. To get the next page, pass the next_cursor value as the cursor query parameter.

{
  "data": [...],
  "pagination": {
    "next_cursor": "eyJpZCI6MTAxfQ==",
    "has_more": true,
    "total": 847
  }
}

When has_more is false, you have reached the last page. The default page size is 20; you can set it to anything between 1 and 100 with the limit parameter.