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.

GET/api/funding/rates

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 perp-dislocation, funding-cost, crowding-risk, flow-confirmation, carry-curve, 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
GET/api/arbitrage/*

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

Request

GET
/api/arbitrage/spot-perp
curl -G https://www.sharpe.ai/api/arbitrage/spot-perp \
  -d direction=long

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

Correlation on-demand

Fetches price data for a coin that is not already in the correlation database, then computes correlations against selected assets.

  • Name
    coinId
    Type
    string
    Description

    CoinGecko asset ID or supported TradFi ID to compute on demand, for example sharpe-ai.

  • Name
    period
    Type
    string
    Description

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

  • Name
    against
    Type
    string
    Description

    Comma-separated comparison asset IDs. Max 20.

Request

GET
/api/correlation/on-demand
curl -G https://www.sharpe.ai/api/correlation/on-demand \
  -d coinId=sharpe-ai \
  -d period=30d \
  -d against=bitcoin,ethereum,solana

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.

  • Name
    coingeckoId
    Type
    string
    Description

    CoinGecko ID for live scoring of a non-indexed coin. Use with symbol and name.

  • Name
    symbol
    Type
    string
    Description

    Ticker symbol for live scoring of a non-indexed coin.

  • Name
    name
    Type
    string
    Description

    Display name for live scoring of a non-indexed coin.

Request

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

Price prediction search

Searches indexed and CoinGecko-backed assets for price prediction candidates.

  • Name
    q
    Type
    string
    Description

    Search query from 1 to 100 characters. At least 2 searchable characters are required after sanitization.

Request

GET
/api/price-prediction/search
curl -G https://www.sharpe.ai/api/price-prediction/search \
  -d q=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. Accepts calendar/time-window values such as 24h, 7d, 30d, 90d, 1y, plus 1W, 1M, 3M, 6M, MTD, YTD, and 3Y.

  • Name
    correlation
    Type
    string
    Description

    Set to true to return the narrative correlation matrix.

  • Name
    timeframe
    Type
    string
    Description

    Timeframe for correlation and history helper modes. Defaults to 1M where applicable.

  • Name
    funding_history
    Type
    string
    Description

    Narrative ID for per-token funding history heatmap rows.

  • Name
    token_volume
    Type
    string
    Description

    Narrative ID for latest token volume with 10-day rolling average.

  • Name
    token_history
    Type
    string
    Description

    Narrative ID for per-token market cap, volume, and open-interest history.

  • Name
    chart
    Type
    string
    Description

    Historical metric selector, for example market-cap, volume, or funding-rate.

  • Name
    mindshare_history
    Type
    string
    Description

    Set to a narrative ID to return narrative mindshare snapshots.

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. Accepts values such as 24h, 7d, 30d, 90d, 1y, plus 1W, 1M, 3M, 6M, MTD, YTD, and 3Y.

  • Name
    correlation
    Type
    string
    Description

    Set to true to return the ecosystem correlation matrix.

  • Name
    timeframe
    Type
    string
    Description

    Timeframe for correlation and history helper modes. Defaults to 1M where applicable.

  • Name
    tvl
    Type
    string
    Description

    Set to true to include TVL data.

  • Name
    chart
    Type
    string
    Description

    Historical metric selector, for example market-cap, volume, or tvl.

  • Name
    mindshare_history
    Type
    string
    Description

    Set to an ecosystem ID to return ecosystem mindshare snapshots.

  • 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 grouped memecoin categories across aggregate, theme, chain, and launchpad views with market share, freshness, coverage, and performance fields.

  • Name
    narrative
    Type
    string
    Description

    Narrative slug (e.g., dog-coins, cat-coins, frog-coins, ai-memes, trump-coins). Omit for all.

  • Name
    historical
    Type
    string
    Description

    One of 24h, 7d, 30d, or 1y.

  • Name
    series
    Type
    string
    Description

    Set to primaryTheme with historical to return only primary-theme historical rows.

  • Name
    coinHistory
    Type
    string
    Description

    Set to 24h, 7d, 1m, or 1y for retained price history per coin.

Request

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

Memecoin launches

Recently launched memecoin pairs screened by age, liquidity, volume, and transaction count. The feed is discovery-first; canonical tracker inclusion requires category membership or minimum liquidity, volume, age, and activity thresholds.

  • Name
    chains
    Type
    string
    Description

    Comma-separated chain ids, e.g. solana,base,bsc,ethereum.

  • Name
    days
    Type
    number
    Description

    Launch lookback window from 1 to 30 days.

  • Name
    limit
    Type
    number
    Description

    Maximum launch rows from 1 to 200.

  • Name
    profile
    Type
    string
    Description

    Screening profile: discovery, balanced, or strict.

Request

GET
/api/memecoins/launches
curl -G https://www.sharpe.ai/api/memecoins/launches \
  -d chains=solana,base \
  -d days=7 \
  -d limit=25

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
    sub
    Type
    string
    Description

    Market submode for mode=market. One of trending, categories, global.

  • 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, 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

Free endpoints are cache-backed and may also have route-specific protective limits. Do not treat them as SLA-backed quotas. Documented per-IP limits include:

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?