# 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"}}}}}}}}}
````
