> For the complete documentation index, see [llms.txt](https://effortless-labs.gitbook.io/hyperbola/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://effortless-labs.gitbook.io/hyperbola/token-quote.md).

# Token Quote

## Get token quotes

> Retrieve current market quotes for one or more cryptocurrency tokens.\
> \
> \*\*Data Sources & Caching:\*\*\
> \- Primary data cached in Redis for fast response times\
> \- Fallback to CoinMarketCap API for missing data\
> \- Cache TTL: 10 seconds for real-time accuracy\
> \
> \*\*Supported Metrics:\*\*\
> \- Current price and market cap\
> \- Volume and volume changes\
> \- Price changes across multiple timeframes (1h, 24h, 7d, 30d, 60d, 90d)\
> \- Supply metrics (circulating, total, max)\
> \- Market dominance and ranking<br>

````json
{"openapi":"3.0.3","info":{"title":"Hyperbola Mesh API","version":"1.0.0"},"tags":[{"name":"Quotes","description":"📈 **Live Market Data & Pricing**\n\nGet real-time market quotes, pricing data, and trading metrics for cryptocurrency tokens.\n\n{% hint style=\"warning\" %}\n**Rate Limits**: Market data is cached for 10 seconds. Requests within this window return cached data.\n{% endhint %}\n\n{% tabs %}\n{% tab title=\"Data Sources\" %}\n**Primary Sources:**\n- Redis cache for fast response times\n- CoinMarketCap API for real-time data\n- Fallback mechanisms ensure high availability\n{% endtab %}\n\n{% tab title=\"Supported Metrics\" %}\n**Price & Volume:**\n- Current USD price\n- 24h trading volume and changes\n- Price changes (1h, 24h, 7d, 30d, 60d, 90d)\n\n**Market Data:**\n- Market capitalization\n- Market dominance\n- Supply metrics (circulating, total, max)\n- Trading pairs count\n{% endtab %}\n\n{% tab title=\"DeFi Metrics\" %}\n**For DeFi Tokens:**\n- Total Value Locked (TVL)\n- TVL to Market Cap ratio\n- Additional DeFi-specific metrics\n{% endtab %}\n{% endtabs %}\n\n{% openapi-schemas spec=\"index\" schemas=\"Quote\" grouped=\"false\" %}\n**Token Quote Object**\n\nComplete market data structure with all pricing and trading metrics.\n{% endopenapi-schemas %}\n"}],"servers":[{"url":"https://cell0.hyperbola.network","description":"🌟 Production Server (Recommended)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"**API Key Authentication**\n\nAll endpoints require a valid API key in the `x-api-key` header.\n\n**How to get your API key:**\n1. Contact the Hyperbola team at support@hyperbola.network\n2. Provide your use case and expected API usage\n3. Receive your unique API key via secure email\n\n**Using with Scalar/GitBook:**\n- Click the \"Test Request\" button on any endpoint\n- In the Authentication section, enter your API key\n- The key will be automatically added to all requests\n\n**Example:**\n```\nx-api-key: your-actual-api-key-here\n```\n\n**Security:**\n- Keep your API key secure and never expose it in client-side code\n- API keys are rate-limited and monitored for abuse\n- Contact support immediately if you suspect your key is compromised\n"}},"parameters":{"TokenSlugs":{"name":"slugs","in":"query","required":true,"description":"Comma-separated list of token slugs to get quotes for.\n\n**Popular tokens**: bitcoin, ethereum, solana, cardano, polkadot\n**Limit**: Maximum 10 tokens per request\n","schema":{"type":"string","minLength":1,"pattern":"^[a-z0-9-]+(,[a-z0-9-]+)*$"}}},"schemas":{"Quote":{"type":"object","title":"Complete Market Quote Data","description":"Comprehensive market data and pricing information for a cryptocurrency token (extends hyperbola Types.QuoteData)","properties":{"slug":{"type":"string","description":"Token slug identifier"},"price":{"type":"number","format":"float","description":"Current price in USD","minimum":0},"volume24h":{"type":"number","format":"float","description":"24-hour trading volume in USD","minimum":0},"volumeChange24h":{"type":"number","format":"float","description":"24-hour volume change percentage"},"percentageChange1h":{"type":"number","format":"float","description":"1-hour price change percentage"},"percentageChange24h":{"type":"number","format":"float","description":"24-hour price change percentage"},"percentageChange7d":{"type":"number","format":"float","description":"7-day price change percentage"},"percentageChange30d":{"type":"number","format":"float","description":"30-day price change percentage"},"percentageChange60d":{"type":"number","format":"float","description":"60-day price change percentage"},"percentageChange90d":{"type":"number","format":"float","description":"90-day price change percentage"},"marketCap":{"type":"number","format":"float","description":"Market capitalization in USD","minimum":0},"marketCapDominance":{"type":"number","format":"float","description":"Market cap dominance percentage (0-100)","minimum":0,"maximum":100},"fullyDilutedMarketCap":{"type":"number","format":"float","description":"Fully diluted market cap in USD","minimum":0},"tvl":{"type":"number","format":"float","description":"Total Value Locked (for DeFi tokens)","minimum":0},"maxSupply":{"type":"number","format":"float","description":"Maximum possible token supply","minimum":0,"nullable":true},"circulatingSupply":{"type":"number","format":"float","description":"Current circulating token supply","minimum":0},"totalSupply":{"type":"number","format":"float","description":"Total token supply currently in existence","minimum":0},"tvlRatio":{"type":"number","format":"float","description":"TVL to Market Cap ratio","minimum":0,"nullable":true},"rank":{"type":"integer","description":"CoinMarketCap ranking position","minimum":1},"numMarketPairs":{"type":"integer","description":"Number of active trading pairs","minimum":0}},"required":["slug","price","volume24h","volumeChange24h","percentageChange1h","percentageChange24h","percentageChange7d","percentageChange30d","percentageChange60d","percentageChange90d","marketCap","marketCapDominance","fullyDilutedMarketCap","tvl","maxSupply","circulatingSupply","totalSupply","tvlRatio","rank","numMarketPairs"],"additionalProperties":false},"ValidationError":{"type":"object","title":"Validation Error Response","description":"Error response for request validation failures","properties":{"error":{"type":"object","description":"Validation error details","properties":{"message":{"type":"string","description":"General validation error message"},"fieldErrors":{"type":"object","description":"Field-specific validation errors","additionalProperties":{"type":"array","items":{"type":"string","maxLength":200}}}},"required":["fieldErrors"]}},"required":["error"],"additionalProperties":false},"Error":{"type":"object","title":"API Error Response","description":"Standard error response format","properties":{"error":{"type":"string","description":"Human-readable error message","maxLength":500},"code":{"type":"string","description":"Machine-readable error code"},"details":{"type":"object","description":"Additional error context and debugging information","additionalProperties":true}},"required":["error"],"additionalProperties":false}},"responses":{"BadRequestError":{"description":"Bad request - invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"UnauthorizedError":{"description":"Authentication required or invalid API key","content":{"text/plain":{"schema":{"type":"string"}}}},"TooManyRequestsError":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalServerError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/token/quote":{"get":{"summary":"Get token quotes","description":"Retrieve current market quotes for one or more cryptocurrency tokens.\n\n**Data Sources & Caching:**\n- Primary data cached in Redis for fast response times\n- Fallback to CoinMarketCap API for missing data\n- Cache TTL: 10 seconds for real-time accuracy\n\n**Supported Metrics:**\n- Current price and market cap\n- Volume and volume changes\n- Price changes across multiple timeframes (1h, 24h, 7d, 30d, 60d, 90d)\n- Supply metrics (circulating, total, max)\n- Market dominance and ranking\n","operationId":"getQuotes","tags":["Quotes"],"parameters":[{"$ref":"#/components/parameters/TokenSlugs"}],"responses":{"200":{"description":"List of token quotes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Quote"}}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"429":{"$ref":"#/components/responses/TooManyRequestsError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}}}
````

## The TokenQuote object

```json
{"openapi":"3.0.3","info":{"title":"Hyperbola Mesh API","version":"1.0.0"},"components":{"schemas":{"TokenQuote":{"$ref":"#/components/schemas/Quote"},"Quote":{"type":"object","title":"Complete Market Quote Data","description":"Comprehensive market data and pricing information for a cryptocurrency token (extends hyperbola Types.QuoteData)","properties":{"slug":{"type":"string","description":"Token slug identifier"},"price":{"type":"number","format":"float","description":"Current price in USD","minimum":0},"volume24h":{"type":"number","format":"float","description":"24-hour trading volume in USD","minimum":0},"volumeChange24h":{"type":"number","format":"float","description":"24-hour volume change percentage"},"percentageChange1h":{"type":"number","format":"float","description":"1-hour price change percentage"},"percentageChange24h":{"type":"number","format":"float","description":"24-hour price change percentage"},"percentageChange7d":{"type":"number","format":"float","description":"7-day price change percentage"},"percentageChange30d":{"type":"number","format":"float","description":"30-day price change percentage"},"percentageChange60d":{"type":"number","format":"float","description":"60-day price change percentage"},"percentageChange90d":{"type":"number","format":"float","description":"90-day price change percentage"},"marketCap":{"type":"number","format":"float","description":"Market capitalization in USD","minimum":0},"marketCapDominance":{"type":"number","format":"float","description":"Market cap dominance percentage (0-100)","minimum":0,"maximum":100},"fullyDilutedMarketCap":{"type":"number","format":"float","description":"Fully diluted market cap in USD","minimum":0},"tvl":{"type":"number","format":"float","description":"Total Value Locked (for DeFi tokens)","minimum":0},"maxSupply":{"type":"number","format":"float","description":"Maximum possible token supply","minimum":0,"nullable":true},"circulatingSupply":{"type":"number","format":"float","description":"Current circulating token supply","minimum":0},"totalSupply":{"type":"number","format":"float","description":"Total token supply currently in existence","minimum":0},"tvlRatio":{"type":"number","format":"float","description":"TVL to Market Cap ratio","minimum":0,"nullable":true},"rank":{"type":"integer","description":"CoinMarketCap ranking position","minimum":1},"numMarketPairs":{"type":"integer","description":"Number of active trading pairs","minimum":0}},"required":["slug","price","volume24h","volumeChange24h","percentageChange1h","percentageChange24h","percentageChange7d","percentageChange30d","percentageChange60d","percentageChange90d","marketCap","marketCapDominance","fullyDilutedMarketCap","tvl","maxSupply","circulatingSupply","totalSupply","tvlRatio","rank","numMarketPairs"],"additionalProperties":false}}}}
```