> 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-price-change.md).

# Token Price Change

## Get token price changes

> Retrieve price change data for one or more cryptocurrency tokens.\
> Returns a simplified view focused on price changes across different timeframes.\
> \
> \*\*Features:\*\*\
> \- Focused on price change metrics only\
> \- Multiple timeframe support (1h, 24h, 7d, 30d, 60d, 90d)\
> \- Optimized for charting and trend analysis\
> \- Same caching and data sources as \`/token/quote\`<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":{"TokenPriceChange":{"type":"object","title":"Token Price Change Data","description":"Price and percentage change information across multiple timeframes","properties":{"price":{"type":"number","format":"float","description":"Current price in USD","minimum":0},"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"}},"required":["price","percentageChange1h","percentageChange24h","percentageChange7d","percentageChange30d","percentageChange60d","percentageChange90d"],"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/price-change":{"get":{"summary":"Get token price changes","description":"Retrieve price change data for one or more cryptocurrency tokens.\nReturns a simplified view focused on price changes across different timeframes.\n\n**Features:**\n- Focused on price change metrics only\n- Multiple timeframe support (1h, 24h, 7d, 30d, 60d, 90d)\n- Optimized for charting and trend analysis\n- Same caching and data sources as `/token/quote`\n","operationId":"getTokenPriceChanges","tags":["Quotes"],"parameters":[{"$ref":"#/components/parameters/TokenSlugs"}],"responses":{"200":{"description":"List of token price change data","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TokenPriceChange"}}}}},"400":{"$ref":"#/components/responses/BadRequestError"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"429":{"$ref":"#/components/responses/TooManyRequestsError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}}}
````

## The TokenPriceChange object

```json
{"openapi":"3.0.3","info":{"title":"Hyperbola Mesh API","version":"1.0.0"},"components":{"schemas":{"TokenPriceChange":{"type":"object","title":"Token Price Change Data","description":"Price and percentage change information across multiple timeframes","properties":{"price":{"type":"number","format":"float","description":"Current price in USD","minimum":0},"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"}},"required":["price","percentageChange1h","percentageChange24h","percentageChange7d","percentageChange30d","percentageChange60d","percentageChange90d"],"additionalProperties":false}}}}
```