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 from 1 minute to 1 hour depending on the dataset, and open to anyone. The cache table at the bottom of this page lists the exact TTL per endpoint group.

For higher rate limits, 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.

Browser access (CORS)

Every free endpoint on this page answers cross-origin browser requests, so the fetch() examples below run from any page:

Access-Control-Allow-Origin: * on every response
OPTIONS preflights answered with 204 and Access-Control-Allow-Methods: GET, HEAD, OPTIONS
Data-provenance headers such as X-Data-Source, X-Data-Stale, X-Data-As-Of, X-Freshness-Sla-Seconds, and X-Sharpe-Data-State are listed in Access-Control-Expose-Headers, so browser code can read them

Two limits are deliberate. Access-Control-Allow-Credentials is never sent, so cookies are never part of a cross-origin call. And the authenticated /api/v1/* API sends no CORS headers at all: calling it from a browser would expose your API key in page JavaScript, so keep v1 requests on your server.

GET/api/funding/rates

Derivatives

Funding rates

Returns current, accumulated, or historical funding rates across 33 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
exchange
Type
string
Description
Filter to a single venue. Accepts the slug (gate-io), the display name (Gate.io), or the ccxt id.
Name
margin
Type
string
Description
Collateral convention: linear or inverse. Unfiltered by default.
Name
asset_class
Type
string
Description
One of crypto, equity, commodity, fx, index. Unfiltered by default.
Name
days
Type
number
Description
Lookback days for history mode. Defaults to 30.
Name
limit
Type
number
Description
Maximum rows per page. Combine with cursor to page the full book.
Name
cursor
Type
string
Description
Opaque cursor from the previous response's pagination.cursor.
Name
max_age_h
Type
number
Description
Optional maximum row age for current responses. Omit it for the backwards-compatible unbounded snapshot; terminal views request 24 hours. Current rows include age_seconds, is_stale, freshness_sla_seconds, and data_source metadata.

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 executable ask/bid pairs ranked by fee-adjusted net APR after the entry spread and four execution fees.

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
Perpetual-leg direction: short for positive funding capture, long for negative funding capture, or all. 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 with tokens sized by market cap and colored by performance. Supports 34 category slugs: the legacy top-100 slug returns the Top 50 universe, alongside 15 narratives and 18 ecosystems.

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 deterministic directional scores with sub-signal breakdowns and optional volatility-scaled heuristic scenarios. Legacy modelConfidence and forecast confidence fields measure signal agreement, not probability.

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 market-ranked token rows with price, market cap, nullable FDV and FDV/MCap ratio, volume, nullable price changes, ATH metrics, exchange availability, and a preferred chain scope. Ambiguous same-ticker assets do not receive symbol-only exchange attribution, and syncStatus exposes degraded enrichment coverage. This endpoint does not return a proprietary score or wallet signal.

No parameters required.

A cache/database read failure returns 502 with X-Sharpe-Data-State: unavailable; a readable cache with no populated row returns a normal empty dataset.

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 plus explicit coverage and availableTimeframes metadata. Partial lookbacks are never relabeled as the requested full window.
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, including Ethereum, Solana, BNB, Arbitrum, and Base. 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 plus explicit coverage and availableTimeframes metadata. Partial lookbacks are never relabeled as the requested full window.
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. Token and narrative sentimentPct is null when the upstream sentiment sample is unavailable; it is never synthesized as neutral 50%.

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 88 tracked entities (16 exchanges, 50 crypto projects, and 22 narrative baskets), 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 IDs 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 group	`s-maxage`	`stale-while-revalidate`
Cross-exchange arbitrage	1 min	2 min
Funding rates, spot-perp arbitrage	5 min	10 min
Gem finder	5 min	5 min
Price prediction	10 min	20 min
Futures, heatmap	15 min	30 min
Narratives, ecosystems, memecoins, web traffic	15 min	30 min
Mindshare, correlation matrix/history	1 hr	2 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:

Endpoint	Limit
`/api/correlation/on-demand`	10 requests/min
`/api/price-prediction/search`	20 requests/min

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

Get an API key for higher limits