> ## 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 a charity token stats by address > Get a charity token stats for a specific chain by its address. ## OpenAPI ````yaml https://www.donate.gg/api/v1/openapi get /{chainId}/tokens/{address}/stats 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/{address}/stats: get: summary: Get a charity token stats by address description: Get a charity token stats for a specific chain by its address. parameters: - schema: type: integer description: Chain ID required: true description: Chain ID name: chainId in: path - schema: type: string description: Token address required: true description: Token address name: address in: path - schema: type: string minLength: 1 description: Developer API key required: true description: Developer API key name: donate-api-key in: header responses: '200': description: Charity token stats including configs. 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: usdDonatedE6: type: string donationCount: type: string firstDonationDate: type: string nullable: true lastDonationDate: type: string nullable: true allTimeDonationRank: type: integer nullable: true minimum: 0 exclusiveMinimum: true description: >- Rank of this charity token by all-time donations, or null if it has no donations activeConfig: type: object properties: usdDonatedE6: type: string donationCount: type: string firstDonationDate: type: string nullable: true lastDonationDate: type: string nullable: true id: type: object properties: hex: type: string base58: type: string required: - hex - base58 additionalProperties: false inputVolumeGrossAtomic: type: object additionalProperties: type: string description: >- Input volume across all channels for this config. Keys are token addresses, values are atomic amounts (as strings to preserve precision). required: - usdDonatedE6 - donationCount - firstDonationDate - lastDonationDate - id - inputVolumeGrossAtomic additionalProperties: false previousConfigs: type: array items: type: object properties: usdDonatedE6: type: string donationCount: type: string firstDonationDate: type: string nullable: true lastDonationDate: type: string nullable: true id: type: object properties: hex: type: string base58: type: string required: - hex - base58 additionalProperties: false inputVolumeGrossAtomic: type: object additionalProperties: type: string description: >- Input volume across all channels for this config. Keys are token addresses, values are atomic amounts (as strings to preserve precision). required: - usdDonatedE6 - donationCount - firstDonationDate - lastDonationDate - id - inputVolumeGrossAtomic additionalProperties: false required: - usdDonatedE6 - donationCount - firstDonationDate - lastDonationDate - allTimeDonationRank - activeConfig - previousConfigs additionalProperties: false '400': description: Invalid chain ID or address. 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 - CHAIN_NOT_SUPPORTED issues: type: array items: nullable: true required: - error - code additionalProperties: false '404': description: Charity token not found for the specified chain and address. 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. ````