Market Cap Search API

The Market Cap Search endpoint looks up crypto and supported TradFi assets by name or ticker. It returns current market cap, price, 24-hour change, and crypto-specific FDV and estimated ATH fields where available. Use it to power "what if" comparisons across tokens, stocks, indices, and commodities.

GET/v1/market-cap/search

Search assets

Searches the same crypto and TradFi universe used by the terminal and returns up to 20 results. Results are filtered to assets with non-zero market cap and sorted by market cap descending. When CoinGecko fails and no TradFi asset matches, the request returns 503 (service_unavailable, Retry-After: 60, detail "CoinGecko is unavailable."); an answer missing its TradFi or CoinGecko half says so in meta.runtime_status: "degraded" and is never cached.

Query parameters

Name
q
Type
string
Description
Search query string. Minimum 2 characters, maximum 100. Matches asset ID, name, or symbol.

Response fields

Name
assets
Type
array
Description
Array of matching asset objects (max 20). Returns an empty array if no matches are found.
Name
assets[].id
Type
string
Description
Canonical asset identifier (e.g., bitcoin, ethereum).
Name
assets[].name
Type
string
Description
Full asset name.
Name
assets[].symbol
Type
string
Description
Uppercase ticker symbol (e.g., BTC, ETH).
Name
assets[].assetClass
Type
string
Description
Asset class identifier: crypto, stock, index, or commodity.
Name
assets[].price
Type
number
Description
Current price in USD. null when the upstream did not publish a price.
Name
assets[].marketCap
Type
number
Description
Current market capitalization in USD.
Name
assets[].fdv
Type
number
Description
Fully diluted valuation in USD. null when FDV is not available.
Name
assets[].ath
Type
number
Description
All-time high price in USD. null when not available.
Name
assets[].athMarketCap
Type
number
Description
Estimated market cap at all-time high using current circulating supply. This is not historical point-in-time market cap and can overstate inflationary assets. null when ATH or current price is unavailable.
Name
assets[].change24h
Type
number
Description
24-hour price change percentage for crypto, rounded to 2 decimal places. For stocks, ETFs, indices and commodity proxies it is the last trading session's change versus the prior close, not a rolling 24 hours. null when unavailable.
Name
assets[].image
Type
string
Description
URL to the asset's logo image. Empty string "" if no logo is published.

Request

GET

/v1/market-cap/search?q=bitcoin

curl -G https://www.sharpe.ai/api/v1/market-cap/search \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d q=bitcoin

Response

{
  "data": {
    "assets": [
      {
        "id": "bitcoin",
        "name": "Bitcoin",
        "symbol": "BTC",
        "assetClass": "crypto",
        "price": 95200,
        "marketCap": 1870000000000,
        "fdv": 1998000000000,
        "ath": 108786,
        "athMarketCap": 2137000000000,
        "change24h": 2.15,
        "image": "https://assets.sharpe.ai/coins/bitcoin.png"
      },
      {
        "id": "bitcoin-cash",
        "name": "Bitcoin Cash",
        "symbol": "BCH",
        "assetClass": "crypto",
        "price": 482,
        "marketCap": 9560000000,
        "fdv": 10120000000,
        "ath": 4355,
        "athMarketCap": 86400000000,
        "change24h": 0.87,
        "image": "https://assets.sharpe.ai/coins/bitcoin-cash.png"
      }
    ]
  },
  "meta": {
    "request_id": "req_abc123def456ghij",
    "timestamp": "2026-03-28T12:00:05Z",
    "elapsed_ms": 12
  }
}

Read the error reference