# Token Metadata 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 Metadata

> Retrieve metadata information for specified token mints.

````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":{"MetadataRequest":{"type":"object","description":"Request for token metadata information","required":["mints"],"properties":{"mints":{"type":"array","description":"Array of token mint addresses to retrieve metadata for","items":{"type":"string","description":"Token mint address (base58 encoded)"},"maxItems":36}}},"MetadataResponse":{"type":"object","description":"Response containing token metadata information","required":["metas"],"properties":{"metas":{"type":"array","description":"Array of token metadata objects","items":{"$ref":"#/components/schemas/TidyMetadata"}}}},"TidyMetadata":{"type":"object","description":"Clean and structured token metadata information","required":["mint","name","symbol","uri","fungible","decimals","primary_creator"],"properties":{"mint":{"type":"string","description":"Token mint address"},"name":{"type":"string","description":"Token name"},"symbol":{"type":"string","description":"Token symbol"},"uri":{"type":"string","description":"URI pointing to token metadata or image"},"fungible":{"type":"boolean","description":"Whether the token is fungible"},"decimals":{"type":"integer","format":"int32","minimum":0,"description":"Number of decimal places for the token"},"primary_creator":{"type":"string","description":"Primary creator of the token"},"freeze_authority":{"type":["string","null"],"description":"Freeze authority for the token (null if none)"},"off_chain_metadata":{"description":"Additional off-chain metadata (structure varies)"}}},"MetadataRequestError":{"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":["InvalidMetadata"],"properties":{"InvalidMetadata":{"type":"string","description":"Error message for invalid or corrupted metadata"}}},{"type":"object","required":["TooManyMints"],"properties":{"TooManyMints":{"type":"string","description":"Error message when too many mints are requested in a single call"}}}]}}},"paths":{"/metadata":{"post":{"operationId":"metadata","summary":"Get Token Metadata","description":"Retrieve metadata information for specified token mints.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetadataRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetadataResponse"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetadataRequestError"}}}},"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"}}}}}}}}}
````