Token Rank

This endpoint will be deprecated before the end of January 2026.

The "Test it" functionality requires providing an API key in the Authorization Header. You can acquire a free API key by "purchasing" the free tier of the SVS API at https://cloud.solanavibestation.com

Get Token Rankings

post

Retrieve a list of top 10 mints whose ratio of avg_1min/avg_15min is greater than or equal to 1.0.

Supports ranking by:

• Price metrics across different time periods

• Configurable filters for top/bottom performers

• Ratio-based filtering and analysis

Authorizations

AuthHeaderURLParameter

AuthorizationstringOptional

Authorization header for API key authentication.

Example:

Authorization: your-api-key-here

Body

application/json

Request for token ranking information

metricone ofOptional

Metric to rank by (defaults to Price if not specified)

nullOptional

or

string · enumOptional

Metric to use for ranking tokens

Example: PricePossible values:

operationone ofOptional

Operation to apply to the metric (defaults to Average if not specified)

nullOptional

or

string · enumOptional

Mathematical operation to apply to the metric

Example: AveragePossible values:

numeratorone ofOptional

Time period for the numerator in ratio calculations

nullOptional

or

string · enumOptional

Time period for metric calculations

Example: PastTwentyFourHoursPossible values:

denominatorone ofOptional

Time period for the denominator in ratio calculations

nullOptional

or

string · enumOptional

Time period for metric calculations

Example: PastTwentyFourHoursPossible values:

count_filterone ofOptional

Filter to limit the number of results returned

nullOptional

or

or

ratio_filterone ofOptional

Filter based on ratio values

nullOptional

or

or

or

Responses

200

Success

application/json

Response containing ranked token information

ordered_mintsobject[][]Required

Array of ranked tokens in order

Example: ["EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm",{"rank":1,"ratio":2.45}]

400

Invalid input

application/json

401

Unauthorized

text/plain

403

Forbidden

text/plain

429

Too Many Requests

text/plain

500

Internal Server Error

text/plain

post

/rank

HTTPcURLJavaScriptPython

POST /rank HTTP/1.1
Host: free.api.solanavibestation.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 134

{
  "metric": "Price",
  "operation": "Average",
  "numerator": "PastTwentyFourHours",
  "denominator": "PastOneHour",
  "count_filter": {
    "Top": {
      "n": 10
    }
  }
}

Top 10 performing tokens by priceBottom 5 performing tokensTokens with price ratios in specific rangeBasic ranking request with defaults

{
  "ordered_mints": [
    [
      "EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm",
      {
        "rank": 1,
        "ratio": 2.45
      }
    ],
    [
      "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      {
        "rank": 2,
        "ratio": 1.87
      }
    ],
    [
      "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
      {
        "rank": 3,
        "ratio": 1.23
      }
    ]
  ]
}