Market Cap Search

The Market Cap Search endpoint lets you look up any crypto asset by name or ticker to retrieve its current market cap, fully diluted valuation, all-time high price, and estimated ATH market cap. Use it to power "what if" comparisons -- e.g., "what would token X be worth at token Y's market cap?"

Search assets

Searches for crypto assets matching the query string and returns up to 10 results with full market data. Results are filtered to assets with non-zero market cap and sorted by market cap descending.

Query parameters

Name
q
Type
string
Description
Search query string. Minimum 2 characters, maximum 100. Matches against coin name and symbol.

Response fields

Name
assets
Type
array
Description
Array of matching asset objects (max 10). 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. Currently always "crypto".
Name
assets[].price
Type
number
Description
Current price in USD.
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, extrapolated from current supply. null when ATH is unavailable.
Name
assets[].change24h
Type
number
Description
24-hour price change percentage, rounded to 2 decimal places.
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

{
  "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"
  }
}

Read the error reference