Skip to content

Free API

Sharpe Terminal exposes public REST endpoints at https://www.sharpe.ai/api/* that return JSON data with no API key required. These are the same endpoints that power the Sharpe Terminal frontend — cached at the edge for 5-15 minutes, available to anyone.

For higher rate limits, pagination, request tracking, and a stable versioned contract, use the authenticated API at https://www.sharpe.ai/api/v1/*. The free endpoints below are best suited for dashboards, research scripts, and lightweight integrations.

Free endpoints return raw JSON without an envelope (no data / meta wrapper) — the response body IS the data. The authenticated v1 API wraps responses in { data, meta } and adds pagination cursors and request IDs.

Derivatives

Funding rates

Returns current, accumulated, or historical funding rates across 13 perpetual exchanges.

  • Name
    type
    Type
    string
    Description

    One of current, accumulated, history. Defaults to current.

  • Name
    coin
    Type
    string
    Description

    Asset ticker for history mode (e.g., BTC, ETH).

  • Name
    days
    Type
    number
    Description

    Lookback days for history mode. Defaults to 30.

Request

GET
/api/funding/rates
curl -G https://www.sharpe.ai/api/funding/rates \
  -d type=current

Futures data

Returns chart data for perpetual futures — open interest, funding rates, liquidations, long/short ratios, basis, volume, and more.

  • Name
    chart
    Type
    string
    Description

    Chart type. One of perpetual-price, funding-rate, oi-snapshot, oi-change, oi-daily-change, oi-stacked, oi-volume, liquidations, annualized-basis, term-structure, long-short-ratio, top-trader-ls, volume-snapshot, volume-history, cvd, returns-session, returns-heatmap, returns-hour, returns-day.

  • Name
    coin
    Type
    string
    Description

    Asset ticker. Defaults to BTC.

  • Name
    timeframe
    Type
    string
    Description

    One of 1W, 2W, 1M, 3M, 6M, 1Y, 3Y. Defaults to 3M.

  • Name
    exchanges
    Type
    string
    Description

    Comma-separated exchange IDs (e.g., binance,bybit,okx).

Request

GET
/api/futures/data
curl -G https://www.sharpe.ai/api/futures/data \
  -d chart=oi-snapshot \
  -d coin=BTC \
  -d timeframe=1M

Available futures coins

Returns the list of coins with available futures data, including which data types each coin supports.

No parameters required.

Request

GET
/api/futures/coins
curl https://www.sharpe.ai/api/futures/coins

Options data

Returns options analytics for BTC and ETH — implied volatility, put/call ratios, OI by strike, Greeks, and more.

  • Name
    chart
    Type
    string
    Description

    Chart type (e.g., atm-iv, put-call-oi-ratio, oi-by-strike, options-flow).

  • Name
    coin
    Type
    string
    Description

    One of BTC, ETH. Defaults to BTC.

  • Name
    timeframe
    Type
    string
    Description

    One of 1W, 1M, 3M, 6M, 1Y, 3Y, ALL. Defaults to 3M.

  • Name
    exchanges
    Type
    string
    Description

    Comma-separated exchange filter. Only Deribit is supported today.

Request

GET
/api/options/data
curl -G https://www.sharpe.ai/api/options/data \
  -d chart=atm-iv \
  -d coin=BTC \
  -d timeframe=3M

Arbitrage

Cross-exchange arbitrage

Returns funding rate differentials between exchange pairs — opportunities to go long on one exchange and short on another.

  • Name
    exchanges
    Type
    string
    Description

    Comma-separated exchange IDs. Returns all exchanges by default.

Spot-perp arbitrage

Returns spot-perp basis trade opportunities — go long spot and short perp (or vice versa) to capture funding.

  • Name
    exchange
    Type
    string
    Description

    Exchange ID or all. Defaults to all.

  • Name
    direction
    Type
    string
    Description

    One of all, long, short. Defaults to all.

Request

GET
/api/arbitrage/cross-exchange
curl https://www.sharpe.ai/api/arbitrage/cross-exchange

Market data

Heatmap

Returns treemap data — tokens sized by market cap, colored by performance. Supports 49 categories across themes, ecosystems, and sectors.

  • Name
    category
    Type
    string
    Description

    Category slug. Examples: top-100, defi, layer-1, artificial-intelligence, meme-token, ethereum-ecosystem, solana-ecosystem. Defaults to top-100.

  • Name
    mode
    Type
    string
    Description

    One of coins, narratives, ecosystems. Defaults to coins.

Request

GET
/api/heatmap/data
curl -G https://www.sharpe.ai/api/heatmap/data \
  -d category=defi

Correlation matrix

Returns an NxN Pearson correlation matrix for any combination of crypto assets and TradFi instruments.

  • Name
    period
    Type
    string
    Description

    One of 30d, 90d, 1y, 3y. Defaults to 30d.

  • Name
    ids
    Type
    string
    Description

    Comma-separated asset IDs. Crypto: canonical asset IDs (bitcoin, ethereum). TradFi: short IDs (sp500, gold, nvda). Max 10. Defaults to bitcoin,ethereum,solana,sp500,gold.

Request

GET
/api/correlation/matrix
curl -G https://www.sharpe.ai/api/correlation/matrix \
  -d period=90d \
  -d ids=bitcoin,ethereum,solana,sp500,gold

Correlation history

Returns rolling correlation windows (30D, 60D, 90D) between two assets over time.

  • Name
    asset1
    Type
    string
    Description

    First asset ID (e.g., bitcoin).

  • Name
    asset2
    Type
    string
    Description

    Second asset ID (e.g., sp500).

  • Name
    period
    Type
    string
    Description

    Lookback period. One of 30d, 90d, 1y, 3y. Defaults to 1y.

Request

GET
/api/correlation/history
curl -G https://www.sharpe.ai/api/correlation/history \
  -d asset1=bitcoin \
  -d asset2=sp500 \
  -d period=1y

Price prediction

Returns AI-powered price prediction scores with sub-signal breakdowns (funding, OI, long/short, liquidation, RSI, EMA).

  • Name
    coin
    Type
    string
    Description

    Asset slug (e.g., bitcoin, ethereum). Omit for all coins.

Request

GET
/api/price-prediction/data
curl -G https://www.sharpe.ai/api/price-prediction/data \
  -d coin=bitcoin

Gem finder

Returns AI-powered token discovery scores based on on-chain activity, social signals, and smart money movements.

No parameters required.

Request

GET
/api/gem-finder/data
curl https://www.sharpe.ai/api/gem-finder/data

Categories

Narratives

Returns analytics for 30 crypto narratives — market cap, volume, performance, social sentiment, derivatives positioning, and correlations.

  • Name
    narrative
    Type
    string
    Description

    Narrative ID for detail view (e.g., defi, ai-agents, rwa). Omit for the full list.

  • Name
    historical
    Type
    string
    Description

    Return historical snapshots. One of 24h, 7d, 30d, 90d, 1y.

  • Name
    correlation
    Type
    string
    Description

    Set to true to include a correlation matrix for the narrative's tokens.

  • Name
    chart
    Type
    string
    Description

    Specific chart data (e.g., market-cap, volume, funding-rate).

Request

GET
/api/narratives/data
curl https://www.sharpe.ai/api/narratives/data

Ecosystems

Analytics for 23 blockchain ecosystems — Ethereum, Solana, BNB, Arbitrum, Base, and more. Includes TVL data from DeFi Llama.

  • Name
    ecosystem
    Type
    string
    Description

    Ecosystem ID (e.g., ethereum, solana, arbitrum). Omit for the full list.

  • Name
    historical
    Type
    string
    Description

    Snapshot timeframe. One of 24h, 7d, 30d, 90d, 1y.

  • Name
    tvl
    Type
    string
    Description

    Set to true to include TVL data.

  • Name
    excludeNative
    Type
    string
    Description

    Set to true to exclude the native token from aggregate metrics.

Request

GET
/api/ecosystems/data
curl -G https://www.sharpe.ai/api/ecosystems/data \
  -d ecosystem=solana \
  -d tvl=true

Memecoins

Track 17 memecoin narratives — Dog coins, Cat coins, AI memes, political tokens, and more.

  • Name
    narrative
    Type
    string
    Description

    Narrative slug (e.g., dog-coins, ai-meme, political). Omit for all.

  • Name
    historical
    Type
    string
    Description

    One of 24h, 7d.

  • Name
    coinHistory
    Type
    string
    Description

    Set to 1m for 30-day price history per coin.

Request

GET
/api/memecoins/data
curl -G https://www.sharpe.ai/api/memecoins/data \
  -d narrative=dog-coins

Mindshare

Social attention and mindshare metrics across crypto narratives and tokens.

  • Name
    tokens
    Type
    string
    Description

    Set to true to return a flat list of token-level mindshare data.

  • Name
    narrative
    Type
    string
    Description

    With tokens=true, filter token rows by narrative slug, for example defi or layer-1.

  • Name
    window
    Type
    string
    Description

    Snapshot window for narrative rows. One of now, 24h, 7d, 30d.

  • Name
    historical
    Type
    string
    Description

    Set to true to include historical snapshots.

  • Name
    timeframe
    Type
    string
    Description

    Historical timeframe. One of 1W, 1M, 3M, 6M, 1Y, 3Y (aliases like 7d, 30d, and 90d are accepted).

Request

GET
/api/mindshare/data
curl -G https://www.sharpe.ai/api/mindshare/data \
  -d window=7d

Web traffic

Website traffic trends for 87+ exchanges and crypto projects — a leading indicator of adoption.

  • Name
    type
    Type
    string
    Description

    One of exchange, coin, narrative.

  • Name
    mode
    Type
    string
    Description

    One of rankings, trends, snapshots, market.

  • Name
    tf
    Type
    string
    Description

    Timeframe. One of 7d, 30d, 90d, 1y, 3y, all.

  • Name
    entities
    Type
    string
    Description

    Comma-separated entity slugs for detail view.

Request

GET
/api/web-traffic/data
curl -G https://www.sharpe.ai/api/web-traffic/data \
  -d type=exchange \
  -d mode=rankings

Caching behavior

All free endpoints return Cache-Control headers. Data freshness varies by product:

Endpoint groups-maxagestale-while-revalidate
Funding rates, futures, options, arbitrage, heatmap, gem finder5 min10 min
Price prediction10 min20 min
Narratives, ecosystems, memecoins, mindshare, web traffic15 min30 min
Correlation matrix/history1 hr2 hr

Rate limits

Most free endpoints have no per-client rate limiting — only edge caching protects origin load. Two endpoints enforce per-IP limits:

EndpointLimit
/api/correlation/on-demand10 requests/min
/api/price-prediction/search20 requests/min

For guaranteed rate limits, SLA, and usage tracking, use the authenticated API.

Get an API key for higher limits

Was this page helpful?