# Token Info 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 Mint Information

> Retrieve comprehensive information about a token mint including metadata, creator information, and trading history for tokens launched in the past 24 hours..\
> \
> Supports tokens launched through the following platforms:\
> \
> \* Raydium\
> \* Raydium Launchpad  \
> \* Bonk.fun\
> \* Pump.fun<br>

````json
{"openapi":"3.1.0","info":{"title":"Solana Vibe Station Mint Info 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/mint_info?api_key=your-api-key-here\n```\n"}},"schemas":{"MintInfoRequest":{"type":"object","description":"Request for comprehensive mint information","required":["mint"],"properties":{"mint":{"type":"string","description":"Token mint address (base58 encoded)","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"}}},"MintInfoResponse":{"type":"object","description":"Response containing comprehensive mint information","properties":{"mint_info":{"oneOf":[{"type":"null","description":"No information found for the specified mint"},{"$ref":"#/components/schemas/MintSummary"}]}}},"MintSummary":{"type":"object","description":"Comprehensive summary of mint information including metadata and trading activity","required":["name","symbol","uri","user","timestamp","trade_events","off_chain_metadata"],"properties":{"name":{"type":"string","description":"Token name"},"symbol":{"type":"string","description":"Token symbol"},"uri":{"type":"string","description":"URI pointing to token metadata","format":"uri"},"user":{"type":"string","description":"Address of the mint creator/authority","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},"timestamp":{"type":"integer","format":"int64","minimum":0,"description":"Unix timestamp of mint creation"},"trade_events":{"type":"array","description":"Array of recent trading events for this token","items":{"$ref":"#/components/schemas/SummarizedTradeEvent"}},"off_chain_metadata":{"description":"Additional off-chain metadata (structure varies by token standard)"}}},"SummarizedTradeEvent":{"type":"object","description":"Summary of a trading event for the token","required":["timestamp","user","sol_amount","token_amount","is_buy"],"properties":{"timestamp":{"type":"integer","format":"int64","description":"Unix timestamp of the trade"},"user":{"type":"string","description":"Address of the trader","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$"},"sol_amount":{"type":"integer","format":"int64","minimum":0,"description":"Amount of SOL involved in the trade (in lamports)"},"token_amount":{"type":"integer","format":"int64","minimum":0,"description":"Amount of tokens involved in the trade (in base units)"},"is_buy":{"type":"boolean","description":"True if this was a buy order, false if it was a sell order"}}}}},"paths":{"/mint_info":{"post":{"operationId":"mint_info","summary":"Get Mint Information","description":"Retrieve comprehensive information about a token mint including metadata, creator information, and trading history for tokens launched in the past 24 hours..\n\nSupports tokens launched through the following platforms:\n\n* Raydium\n* Raydium Launchpad  \n* Bonk.fun\n* Pump.fun\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MintInfoRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MintInfoResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Unauthorized","content":{"text/plain":{"schema":{"type":"string"}}}},"403":{"description":"Forbidden","content":{"text/plain":{"schema":{"type":"string"}}}},"404":{"description":"Mint not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"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-info-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.
