# Token Price API

{% hint style="info" %}
We're seeking feedback to improve this API! Please share your thoughts in our Discord [#svs-api](https://discord.com/channels/1241508519190986752/1388947652128936129) channel let us know how we can improve or report any bugs you encounter!
{% 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 <https://cloud.solanavibestation.com>
{% endhint %}

## Get Token Prices

> Retrieve current and historical pricing information for specified token mints. Returns comprehensive price metrics including average, minimum, and maximum prices across multiple time periods (1-minute, 15-minute, 1-hour, 24-hour, 72-hour), plus latest trade price and trading volume. Optionally returns prices in USDC.\
> \
> Supports tokens launched through the following platforms:\
> \
> \* Raydium\
> \* Raydium Launchpad\
> \* Bonk.fun\
> \* Pump.fun\
> \* Pump.swap<br>

````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":{"PriceRequest":{"type":"object","description":"Request for token pricing information","required":["mints"],"properties":{"mints":{"type":"array","description":"Array of token mint addresses to retrieve pricing for","items":{"type":"string","description":"Token mint address (base58 encoded)"},"maxItems":36},"prices_in_usdc":{"type":["boolean","null"],"description":"Whether to return prices in USDC"}}},"PriceResponse":{"type":"object","description":"Response containing token pricing information","required":["prices"],"properties":{"prices":{"type":"array","description":"Array of market state objects or null for unavailable data","items":{"oneOf":[{"type":"null","description":"No pricing data available for this token"},{"$ref":"#/components/schemas/MarketState"}]}}}},"MarketState":{"type":"object","description":"Current market state and pricing information for a token pair","required":["base_mint","quote_mint","quote_symbol"],"properties":{"base_mint":{"type":"string","description":"Base token mint address"},"quote_mint":{"type":"string","description":"Quote token mint address"},"quote_symbol":{"type":"string","description":"Quote token symbol"},"avg_price_15min":{"type":["number","null"],"format":"double","description":"Average price over the last 15 minutes"},"avg_price_1h":{"type":["number","null"],"format":"double","description":"Average price over the last 1 hour"},"avg_price_1min":{"type":["number","null"],"format":"double","description":"Average price over the last 1 minute"},"avg_price_24h":{"type":["number","null"],"format":"double","description":"Average price over the last 24 hours"},"avg_price_72h":{"type":["number","null"],"format":"double","description":"Average price over the last 72 hours"},"latest_price":{"type":["number","null"],"format":"double","description":"Most recent trade price"},"max_price_15min":{"type":["number","null"],"format":"double","description":"Maximum price over the last 15 minutes"},"max_price_1h":{"type":["number","null"],"format":"double","description":"Maximum price over the last 1 hour"},"max_price_1min":{"type":["number","null"],"format":"double","description":"Maximum price over the last 1 minute"},"max_price_24h":{"type":["number","null"],"format":"double","description":"Maximum price over the last 24 hours"},"max_price_72h":{"type":["number","null"],"format":"double","description":"Maximum price over the last 72 hours"},"min_price_15min":{"type":["number","null"],"format":"double","description":"Minimum price over the last 15 minutes"},"min_price_1h":{"type":["number","null"],"format":"double","description":"Minimum price over the last 1 hour"},"min_price_1min":{"type":["number","null"],"format":"double","description":"Minimum price over the last 1 minute"},"min_price_24h":{"type":["number","null"],"format":"double","description":"Minimum price over the last 24 hours"},"min_price_72h":{"type":["number","null"],"format":"double","description":"Minimum price over the last 72 hours"},"volume_15min":{"type":["number","null"],"format":"double","description":"Trading volume over the last 15 minutes"},"volume_1h":{"type":["number","null"],"format":"double","description":"Trading volume over the last 1 hour"},"volume_1min":{"type":["number","null"],"format":"double","description":"Trading volume over the last 1 minute"},"volume_24h":{"type":["number","null"],"format":"double","description":"Trading volume over the last 24 hours"},"volume_72h":{"type":["number","null"],"format":"double","description":"Trading volume over the last 72 hours"}}},"PriceRequestError":{"oneOf":[{"type":"object","required":["InvalidInput"],"properties":{"InvalidInput":{"type":"string","description":"Error message for invalid input format"}}},{"type":"object","required":["InvalidMint"],"properties":{"InvalidMint":{"type":"string","description":"Error message for invalid mint address"}}},{"type":"object","required":["TooManyMints"],"properties":{"TooManyMints":{"type":"string","description":"Error message when too many mints are requested in a single call"}}}]}}},"paths":{"/price":{"post":{"operationId":"price","summary":"Get Token Prices","description":"Retrieve current and historical pricing information for specified token mints. Returns comprehensive price metrics including average, minimum, and maximum prices across multiple time periods (1-minute, 15-minute, 1-hour, 24-hour, 72-hour), plus latest trade price and trading volume. Optionally returns prices in USDC.\n\nSupports tokens launched through the following platforms:\n\n* Raydium\n* Raydium Launchpad\n* Bonk.fun\n* Pump.fun\n* Pump.swap\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceResponse"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceRequestError"}}}},"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-price-api.md?ask=<question>
```

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.