Token Quote

Get token quotes

get

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

Authorizations

ApiKeyAuth

x-api-keystringRequired

API Key Authentication

All endpoints require a valid API key in the x-api-key header.

How to get your API key:

1. Contact the Hyperbola team at [e-mail]
2. Provide your use case and expected API usage
3. Receive your unique API key via secure email

Using with Scalar/GitBook:

• Click the "Test Request" button on any endpoint
• In the Authentication section, enter your API key
• The key will be automatically added to all requests

Example:

x-api-key: your-actual-api-key-here

Security:

• Keep your API key secure and never expose it in client-side code
• API keys are rate-limited and monitored for abuse
• Contact support immediately if you suspect your key is compromised

Query parameters

slugsstring · min: 1Required

Comma-separated list of token slugs to get quotes for.

Popular tokens: bitcoin, ethereum, solana, cardano, polkadot Limit: Maximum 10 tokens per request

Example: {"summary":"Single token","value":"bitcoin"}Pattern: ^[a-z0-9-]+(,[a-z0-9-]+)*$

Responses

200

List of token quotes

application/json

Comprehensive market data and pricing information for a cryptocurrency token (extends hyperbola Types.QuoteData)

slugstringRequired

Token slug identifier

Example: bitcoin

pricenumber · floatRequired

Current price in USD

Example: 45000.5

volume24hnumber · floatRequired

24-hour trading volume in USD

Example: 25000000000

volumeChange24hnumber · floatRequired

24-hour volume change percentage

Example: 5.25

percentageChange1hnumber · floatRequired

1-hour price change percentage

Example: 0.15

percentageChange24hnumber · floatRequired

24-hour price change percentage

Example: 2.34

percentageChange7dnumber · floatRequired

7-day price change percentage

Example: -1.45

percentageChange30dnumber · floatRequired

30-day price change percentage

Example: 12.67

percentageChange60dnumber · floatRequired

60-day price change percentage

Example: 8.92

percentageChange90dnumber · floatRequired

90-day price change percentage

Example: 15.43

marketCapnumber · floatRequired

Market capitalization in USD

Example: 850000000000

marketCapDominancenumber · float · max: 100Required

Market cap dominance percentage (0-100)

Example: 42.5

fullyDilutedMarketCapnumber · floatRequired

Fully diluted market cap in USD

Example: 945000000000

tvlnumber · floatRequired

Total Value Locked (for DeFi tokens)

Example: 0

maxSupplynumber · float · nullableRequired

Maximum possible token supply

Example: 21000000

circulatingSupplynumber · floatRequired

Current circulating token supply

Example: 19500000

totalSupplynumber · floatRequired

Total token supply currently in existence

Example: 19500000

tvlRationumber · float · nullableRequired

TVL to Market Cap ratio

Example: 0

rankinteger · min: 1Required

CoinMarketCap ranking position

Example: 1

numMarketPairsintegerRequired

Number of active trading pairs

Example: 10000

400

Bad request - invalid parameters

application/json

401

Authentication required or invalid API key

text/plain

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/token/quote

HTTPcURLJavaScriptPython

GET /token/quote?slugs=text HTTP/1.1
Host: cell0.hyperbola.network
x-api-key: YOUR_API_KEY
Accept: */*

[
  {
    "slug": "bitcoin",
    "price": 45000.5,
    "volume24h": 25000000000,
    "volumeChange24h": 5.25,
    "percentageChange1h": 0.15,
    "percentageChange24h": 2.34,
    "percentageChange7d": -1.45,
    "percentageChange30d": 12.67,
    "percentageChange60d": 8.92,
    "percentageChange90d": 15.43,
    "marketCap": 850000000000,
    "marketCapDominance": 42.5,
    "fullyDilutedMarketCap": 945000000000,
    "tvl": 0,
    "maxSupply": 21000000,
    "circulatingSupply": 19500000,
    "totalSupply": 19500000,
    "tvlRatio": 0,
    "rank": 1,
    "numMarketPairs": 10000
  }
]