# Token Rank {% hint style="danger" %} This endpoint will be deprecated before the end of January 2026. {% endhint %} {% hint style="warning" %} 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 {% endhint %} ## Get Token Rankings > 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
````json {"openapi":"3.1.0","info":{"title":"Solana Vibe Station API","version":"0.2.0"},"servers":[{"url":"https://free.api.solanavibestation.com"}],"security":[{},{"AuthHeader":[]},{"URLParameter":[]}],"components":{"securitySchemes":{"AuthHeader":{"type":"apiKey","in":"header","name":"Authorization","description":"Authorization header for API key authentication.\n\n**Example:**\n```\nAuthorization: your-api-key-here\n```\n"},"URLParameter":{"type":"apiKey","in":"query","name":"api_key","description":"API key passed as a URL parameter for authentication.\n\n**Example:**\n```\nhttps://free.api.solanavibestation.com/metadata?api_key=your-api-key-here\n```\n"}},"schemas":{"RankRequest":{"type":"object","description":"Request for token ranking information","properties":{"metric":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/RankMetric"}],"description":"Metric to rank by (defaults to Price if not specified)"},"operation":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/RankOperation"}],"description":"Operation to apply to the metric (defaults to Average if not specified)"},"numerator":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/TimePeriod"}],"description":"Time period for the numerator in ratio calculations"},"denominator":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/TimePeriod"}],"description":"Time period for the denominator in ratio calculations"},"count_filter":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/CountFilter"}],"description":"Filter to limit the number of results returned"},"ratio_filter":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/RatioFilter"}],"description":"Filter based on ratio values"}}},"RankMetric":{"type":"string","description":"Metric to use for ranking tokens","enum":["Price"]},"RankOperation":{"type":"string","description":"Mathematical operation to apply to the metric","enum":["Average"]},"TimePeriod":{"type":"string","description":"Time period for metric calculations","enum":["PastOneMinute","PastFifteenMinutes","PastOneHour","PastTwentyFourHours"]},"CountFilter":{"type":"object","description":"Filter for limiting the number of results","oneOf":[{"type":"object","required":["Top"],"properties":{"Top":{"type":"object","description":"Return the top N results","required":["n"],"properties":{"n":{"type":"integer","minimum":0,"description":"Number of top results to return"}}}}},{"type":"object","required":["Bottom"],"properties":{"Bottom":{"type":"object","description":"Return the bottom N results","required":["n"],"properties":{"n":{"type":"integer","minimum":0,"description":"Number of bottom results to return"}}}}}]},"RatioFilter":{"type":"object","description":"Filter based on ratio values between time periods","oneOf":[{"type":"object","required":["Top"],"properties":{"Top":{"type":"object","description":"Filter for ratios above a threshold","required":["value"],"properties":{"value":{"type":"number","format":"double","description":"Minimum ratio value"}}}}},{"type":"object","required":["Bottom"],"properties":{"Bottom":{"type":"object","description":"Filter for ratios below a threshold","required":["value"],"properties":{"value":{"type":"number","format":"double","description":"Maximum ratio value"}}}}},{"type":"object","required":["Range"],"properties":{"Range":{"type":"object","description":"Filter for ratios within a specific range","required":["from_value","up_to_and_including_value"],"properties":{"from_value":{"type":"number","format":"double","description":"Minimum ratio value (inclusive)"},"up_to_and_including_value":{"type":"number","format":"double","description":"Maximum ratio value (inclusive)"}}}}}]},"RankResponse":{"type":"object","description":"Response containing ranked token information","required":["ordered_mints"],"properties":{"ordered_mints":{"type":"array","description":"Array of ranked tokens in order","items":{"$ref":"#/components/schemas/Rank"}}}},"Rank":{"type":"array","description":"Ranking entry containing mint address and ranking metadata","items":{"type":"object"},"maxItems":2,"minItems":2},"RankRequestError":{"oneOf":[{"type":"object","required":["InvalidInput"],"properties":{"InvalidInput":{"type":"string","description":"Error message for invalid ranking parameters"}}}]}}},"paths":{"/rank":{"post":{"operationId":"rank","summary":"Get Token Rankings","description":"Retrieve a list of top 10 mints whose ratio of avg_1min/avg_15min is greater than or equal to 1.0.\n\nSupports ranking by:\n\n* Price metrics across different time periods\n* Configurable filters for top/bottom performers\n* Ratio-based filtering and analysis\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RankRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RankResponse"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RankRequestError"}}}},"401":{"description":"Unauthorized","content":{"text/plain":{"schema":{"type":"string"}}}},"403":{"description":"Forbidden","content":{"text/plain":{"schema":{"type":"string"}}}},"429":{"description":"Too Many Requests","content":{"text/plain":{"schema":{"type":"string"}}}},"500":{"description":"Internal Server Error","content":{"text/plain":{"schema":{"type":"string"}}}}}}}}} ```` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.solanavibestation.com/developers/partner-marketplace/svs-api/token-rank.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.