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


---

# 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-metadata-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.