AIvsRank API Reference

Welcome to AIvsRank API docs. API lets you programmatically access leaderboard data and legacy historical credit balance records.

Base URL

https://api.aivsrank.com/v1

All requests require HTTPS and a valid API key.

Response Format

All endpoints return a unified envelope:

{
  "code": 200,
  "message": "Success",
  "data": { ... },
  "success": true,
  "timestamp": 1710154200000
}
Field Type Description
code integer HTTP status code
message string Human-readable status
data object/array Response payload
success boolean true when code is 200
timestamp long Response time (milliseconds)

Available Endpoints

Endpoint Scope Required Description
GET /v1/leaderboard/industries leaderboard:read List all active industries
GET /v1/leaderboard/industries/{id} leaderboard:read Get industry detail with latest rankings
GET /v1/leaderboard/industries/{id}/trend leaderboard:read Get historical trend data
GET /v1/credits/balance credit:read Legacy Credits API for historical balance records

Quick Start

  1. Get your API key from the dashboard
  2. Include the key in every request as Authorization: Bearer gly_<key>
  3. Call any active endpoint — leaderboard, legacy credit records, or another documented API.
Next Authentication