> ## Documentation Index > Fetch the complete documentation index at: https://docs.donate.gg/llms.txt > Use this file to discover all available pages before exploring further. # Get charity token leaderboard > Get the leaderboard for top donating tokens for a specific chain. ## OpenAPI ````yaml https://www.donate.gg/api/v1/openapi get /{chainId}/tokens/leaderboard openapi: 3.0.0 info: title: Donate Developer API version: 1.0.0 description: >- API for developers to list charities, create and manage donation configs. All endpoints require the `donate-api-key` header. Endpoints are gated by API scopes enabled at the organization level: Core API endpoints require the `core` scope (enabled by default), Partner API endpoints require the `partner` scope (must be explicitly granted). servers: - url: /api/v1 description: API v1 base path (relative to your dashboard origin) security: [] paths: /{chainId}/tokens/leaderboard: get: summary: Get charity token leaderboard description: Get the leaderboard for top donating tokens for a specific chain. parameters: - schema: type: integer description: Chain ID for the token leaderboard required: true description: Chain ID for the token leaderboard name: chainId in: path - schema: type: string enum: - 'true' - 'false' default: true description: >- Whether to include inappropriate entries in the leaderboard (default true) required: false description: >- Whether to include inappropriate entries in the leaderboard (default true) name: includeInappropriate in: query - schema: type: string enum: - top-donated - recent-donation default: top-donated description: Sort order for leaderboard results (default top-donated) required: false description: Sort order for leaderboard results (default top-donated) name: sortBy in: query - schema: type: integer minimum: 1 maximum: 100 default: 25 description: Page size (default 25, max 100) required: false description: Page size (default 25, max 100) name: limit in: query - schema: type: string description: Cursor for next page (from previous pageKey) required: false description: Cursor for next page (from previous pageKey) name: cursor in: query - schema: type: string minLength: 1 description: Developer API key required: true description: Developer API key name: donate-api-key in: header responses: '200': description: Leaderboard of top donating tokens for the specified chain. headers: X-RateLimit-Limit: schema: type: integer description: Maximum requests allowed in the current window. X-RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window. X-RateLimit-Reset: schema: type: integer description: Unix epoch seconds when the current window resets. content: application/json: schema: type: object properties: pageKey: type: string nullable: true response: type: array items: type: object properties: rank: type: integer minimum: 0 exclusiveMinimum: true chain: type: object properties: id: type: number name: type: string type: type: string enum: - bitcoin - evm - solana required: - id - name - type additionalProperties: false token: type: object properties: address: type: string name: type: string symbol: type: string decimals: type: number required: - address - name - symbol - decimals additionalProperties: false stats: type: object properties: usdDonatedE6: type: string donationCount: type: string firstDonationDate: type: string nullable: true lastDonationDate: type: string nullable: true required: - usdDonatedE6 - donationCount - firstDonationDate - lastDonationDate additionalProperties: false creatorAddress: type: string required: - rank - chain - token - stats - creatorAddress additionalProperties: false required: - pageKey - response additionalProperties: false '400': description: Invalid query parameters or chain ID. headers: X-RateLimit-Limit: schema: type: integer description: Maximum requests allowed in the current window. X-RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window. X-RateLimit-Reset: schema: type: integer description: Unix epoch seconds when the current window resets. content: application/json: schema: type: object properties: error: type: string code: type: string enum: - VALIDATION_ERROR issues: type: array items: nullable: true required: - error - code - issues additionalProperties: false '404': description: No charity tokens found for the specified chain. headers: X-RateLimit-Limit: schema: type: integer description: Maximum requests allowed in the current window. X-RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window. X-RateLimit-Reset: schema: type: integer description: Unix epoch seconds when the current window resets. content: application/json: schema: type: object properties: error: type: string code: type: string enum: - NOT_FOUND required: - error - code additionalProperties: false '429': description: >- Rate limit exceeded. Retry after the period indicated by the Retry-After header. headers: X-RateLimit-Limit: schema: type: integer description: Maximum requests allowed in the current window. X-RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window. X-RateLimit-Reset: schema: type: integer description: Unix epoch seconds when the current window resets. Retry-After: schema: type: integer description: Seconds until the client should retry. content: application/json: schema: type: object properties: error: type: string code: type: string required: - error - code additionalProperties: false security: - ApiKeyAuth: [] components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: donate-api-key description: >- Developer API key. Required for all requests. Obtain from the Donate dashboard. ````