Skip to main content

Token Statistics API Overview

The Token Statistics API provides endpoints to retrieve various statistics related to tokens, primarily focused on the BLOCK token by default. It offers detailed information about token supply, buy-back tiers, token multipliers, user growth, and social statistics.

Authentication​

Authentication is automatically managed through HTTP cookies, with the system handling both the accessToken and the refreshToken. All queries in this API section should be authenticated.

Available Operations​

The Token Statistics API provides the following operations:

Queries​

  • tokenStat: Get comprehensive statistics for a specific token (BLOCK by default)

Data Models​

The API returns the following key data models:

TokenStatModel​

The main model containing all token-related statistics:

type TokenStatModel {
  id: ID!
  createdAt: DateTime!
  updatedAt: DateTime!
  token: TokenName!
  monthlyBuyBackHistory: [MonthlyBuyBackHistoryModel!]!
  buyBackTiers: [BuyBackTierResponse!]!
  userGrowth: [UserGrowthModel!]!
  socials: [SocialStatDataModel!]!
  multipliers: [TokenMultiplierResponse!]!
  tokenSupply: TokenSupplyResponse!
}

TokenSupplyResponse​

Contains information about the token supply:

type TokenSupplyResponse {
  title: String
  description: String
  burnt: Float!
  liquidity: Float!
  circulatingSupply: Float!
}

BuyBackTierResponse​

Contains information about buy-back tiers:

type BuyBackTierResponse {
  month: Month!
  tier: Float!
  info: String!
  description: String!
  active: Boolean!
}

TokenMultiplierResponse​

Contains information about token multipliers:

type TokenMultiplierResponse {
  month: Month!
  multiplier: Float!
  description: String!
  active: Boolean!
}

Enums​

TokenName​

enum TokenName {
  BLOCK
  BB10
}

Month​

enum Month {
  JAN
  FEB
  MAR
  APR
  MAY
  JUN
  JUL
  AUG
  SEP
  OCT
  NOV
  DEC
}

SocialType​

enum SocialType {
  TELEGRAM
  TWITTER
  DISCORD
  REDDIT
  YOUTUBE
  INSTAGRAM
}

Error Handling​

The API follows standard GraphQL error handling patterns. Errors will be returned in the errors array of the GraphQL response.