# Blockchain List with Market Data
Source: https://docs.cryptorank.io/api-reference/blockchains/blockchain-list-with-market-data
/openapi.json get /v3/blockchains/list
Returns all supported blockchains with their market metrics.
Available from: Sandbox
Cost: 1 credit per request
# Blockchain Map (ID Reference)
Source: https://docs.cryptorank.io/api-reference/blockchains/blockchain-map-id-reference
/openapi.json get /v3/blockchains/map
Returns a lightweight list of all supported blockchains with their IDs.
Available from: Sandbox
Cost: 1 credit per request
Use as a lookup table to resolve blockchain identifiers for other endpoints.
# Blockchain Profile
Source: https://docs.cryptorank.io/api-reference/blockchains/blockchain-profile
/openapi.json get /v3/blockchains/{id}
Returns the full profile of a single blockchain by its ID.
Available from: Sandbox
Cost: 1 credit per request
Resolve IDs via [/blockchains/map](https://docs.cryptorank.io/api-reference/blockchains/blockchain-map-id-reference). TVL history is served separately via [/blockchains/:id/tvl/chart](https://docs.cryptorank.io/api-reference/blockchains/blockchain-tvl-chart).
# Blockchain TVL Change
Source: https://docs.cryptorank.io/api-reference/blockchains/blockchain-tvl-change
/openapi.json get /v3/blockchains/{id}/tvl/change
Returns the percentage change in TVL for the specified blockchain over the selected period.
Available from: Basic
Cost: 1 credit per request
Fixed interval: 1d. Available periods: 7d, 30d, 6m, 1y, ytd, all (default 30d).
# Blockchain TVL Chart
Source: https://docs.cryptorank.io/api-reference/blockchains/blockchain-tvl-chart
/openapi.json get /v3/blockchains/{id}/tvl/chart
Returns a time series of Total Value Locked (TVL) for the specified blockchain.
Available from: Basic
Cost: 1 credit per request
Available periods: 7d, 30d, 6m, 1y, ytd, all (default 30d).
# Coin Categories
Source: https://docs.cryptorank.io/api-reference/currencies/coin-categories
/openapi.json get /v3/currencies/categories
Returns the full flat list of coin categories. Use it to resolve the categoryId values returned by other endpoints.
Available from: Sandbox
Cost: 1 credit per request
Reference data, updated infrequently — safe to cache on your side. The list is flat (no hierarchy). A coin has at most one category, and may have none — treat a missing category as expected.
# Coin Tags
Source: https://docs.cryptorank.io/api-reference/currencies/coin-tags
/openapi.json get /v3/currencies/tags
Returns the full flat list of coin tags. Use it to resolve the `tags` values returned by [the coin profile](https://docs.cryptorank.io/api-reference/currencies/currency-profile) and to filter the market via the `tagId` parameter of [/currencies/list](https://docs.cryptorank.io/api-reference/currencies/currency-list-with-market-data).
Available from: Sandbox
Cost: 1 credit per request
Reference data, updated infrequently — safe to cache on your side. The list is flat (no hierarchy). A coin may carry several tags, or none.
# Currency Contracts
Source: https://docs.cryptorank.io/api-reference/currencies/currency-contracts
/openapi.json get /v3/currencies/{id}/contracts
Returns a coin's contract addresses across networks.
Available from: Basic
Cost: 1 credit per request
Native coins without a contract address are omitted entirely (no row, not null).
# Currency List with Market Data
Source: https://docs.cryptorank.io/api-reference/currencies/currency-list-with-market-data
/openapi.json get /v3/currencies/list
Returns a paginated market table of cryptocurrencies with key market metrics, with sorting, pagination and filters by coin set, category, market cap and 24h volume.
Available from: Sandbox
Cost: 1 credit per request
Supports conversion via the convert parameter. Market cap and volume filters always apply to USD values.
Pass `currencyIds` to fetch a specific watchlist in one call instead of paging the whole market. Resolve tickers to ids once via [/currencies/search](https://docs.cryptorank.io/api-reference/currencies/currency-search).
Filter to one ecosystem’s projects with `ecosystemId` — get IDs from [/ecosystems/list](https://docs.cryptorank.io/api-reference/ecosystems/ecosystems-map).
# Currency Map (ID Reference)
Source: https://docs.cryptorank.io/api-reference/currencies/currency-map-id-reference
/openapi.json get /v3/currencies/map
Returns a lightweight list of all cryptocurrencies with their IDs.
Available from: Sandbox
Cost: 1 credit per request
# Currency Performance
Source: https://docs.cryptorank.io/api-reference/currencies/currency-performance
/openapi.json get /v3/currencies/{id}/performance
Returns a coin's ATH/ATL and ROI metrics.
Available from: Advanced
Cost: 1 credit per request
ATH/ATL values are in USD and are not affected by the convert parameter.
# Currency Profile
Source: https://docs.cryptorank.io/api-reference/currencies/currency-profile
/openapi.json get /v3/currencies/{id}
Returns a coin's profile: identity, current price snapshot.
Available from: Sandbox
Cost: 1 credit per request
Asset classification:
* coin — native asset of its own blockchain (BTC, ETH, SOL)
* token — asset issued via smart contract on an existing chain (ERC-20, SPL)
* etf — exchange-listed fund tracking underlying asset(s); no chain, no on-chain contract; excluded from ranked coin lists
* leveraged-token — tokenized leveraged product (e.g. BTC3L/BTC3S); has on-chain contract address; issued by exchanges
* fiat — government-issued currency (USD, EUR); price/quote reference only, not tradable crypto
* no-token — tracked project without a launched token yet; no symbol/price
* derivative — primarily a futures instrument; markets page defaults to Futures tab (legacy, rarely used)
# Currency Search
Source: https://docs.cryptorank.io/api-reference/currencies/currency-search
/openapi.json get /v3/currencies/search
Server-side search of coins by name or ticker, ranked by relevance; resolves a query string to an id/slug.
Available from: Basic
Cost: 1 credit per request
Does not return market data — use [/currencies/list](https://docs.cryptorank.io/api-reference/currencies/currency-list-with-market-data) or [/currencies/:id](https://docs.cryptorank.io/api-reference/currencies/currency-profile) for that.
Results are ranked by relevance, so the first hit is usually the right one.
Resolve ids once, then pass them as `currencyIds` to [/currencies/list](https://docs.cryptorank.io/api-reference/currencies/currency-list-with-market-data) to fetch the whole watchlist with market data in one call.
# Global Derivatives Snapshot
Source: https://docs.cryptorank.io/api-reference/currencies/global-derivatives-snapshot
/openapi.json get /v3/currencies/derivatives
Returns an aggregated, market-wide snapshot of crypto derivatives: open interest, derivatives volume, and related metrics across tracked exchanges.
Available from: Advanced
Cost: 1 credit per request
# Historical Market Data
Source: https://docs.cryptorank.io/api-reference/currencies/historical-market-data
/openapi.json get /v3/currencies/historical
Market state of all tracked coins at a given point in time: price, market cap, volume and circulating supply.
Available from: Advanced
Cost: 1 credit per request
`storedTime` is the actual timestamp of the returned values, which may differ slightly from the requested `date`.
A `date` deeper than your plan allows returns `403 PLAN_LIMIT_EXCEEDED` — Advanced 2y, Pro 5y, Business 10y.
For the history of a single coin use [/currencies/:id/sparkline](https://docs.cryptorank.io/api-reference/currencies/price-&-volume-chart).
# Historical OHLCV
Source: https://docs.cryptorank.io/api-reference/currencies/historical-ohlcv
/openapi.json get /v3/currencies/{id}/ohlcv
Aggregated historical candles for a single coin: OHLC price, traded volume, circulating supply and period-over-period changes.
Available from: Advanced
Cost: 1 credit per request
All values are in USD; the `convert` parameter does not apply.
Depth depends on the plan:
Advanced — up to 30d at 1h, up to 2y at 1d/1w/1m;
Pro — up to 90d at 1h, up to 5y at 1d/1w/1m;
Business — up to 1y at 1h, full history at 1d/1w/1m.
A `from`/`to` range reaching deeper than your plan allows returns `403 PLAN_LIMIT_EXCEEDED` — the window is never silently cut.
For a lightweight price line use [/currencies//sparkline](https://docs.cryptorank.io/api-reference/currencies/price-&-volume-chart) instead.
# Periodic Returns
Source: https://docs.cryptorank.io/api-reference/currencies/periodic-returns
/openapi.json get /v3/currencies/{id}/analytics/returns
Closing price and within-period return for each period, all years, including the current incomplete one.
Available from: Advanced
Cost: 1 credit per request
Returns are open→close within each period. The last period may be incomplete.
# Price & Volume Chart
Source: https://docs.cryptorank.io/api-reference/currencies/price-&-volume-chart
/openapi.json get /v3/currencies/{id}/sparkline
Returns data points for a coin's price and volume chart.
Available from: Basic
Cost: 1 credit per request
Depth and granularity depend on the plan:
Basic — up to 30d at 5m/15m/1h, up to 1y at 1d;
Advanced — up to 30d at 5m/15m/1h, up to 2y at 1d;
Pro — up to 90d at 5m/15m/1h, up to 5y at 1d;
Business — up to 1y at 5m/15m/1h, full history at 1d.
With no parameters, returns the last 7 days at 1h.
# Token Holders
Source: https://docs.cryptorank.io/api-reference/currencies/token-holders
/openapi.json get /v3/currencies/{id}/holders
Top 100 token holders for a coin on a single network: address, label, type, balance, share of supply and USD value.
Available from: Advanced
Cost: 1 credit per request
Coverage is limited to the top-1000 coins by market cap and EVM networks only. Coins outside coverage return an empty array, not an error.
Data is a daily snapshot; `meta.snapshotDate` returns its collection time. Holder metrics are per-network and are never summed across networks.
Resolve available networks for a coin via [/currencies//contracts](https://docs.cryptorank.io/api-reference/currencies/currency-contracts) and network ids via [/blockchains/map](https://docs.cryptorank.io/api-reference/blockchains/blockchain-map-id-reference).
# Tokenomics Summary
Source: https://docs.cryptorank.io/api-reference/currencies/tokenomics-summary
/openapi.json get /v3/currencies/{id}/tokenomics
Returns a summary of a coin's supply and unlocks.
Available from: Advanced
Cost: 1 credit per request
nextUnlockValue = tokens × current price.
Per-group breakdown: [/currencies/:id/vesting/allocations](https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/vesting-allocations). Emission chart: [/currencies/:id/vesting/chart](https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/token-emission-chart).
# Top Gainers & Losers
Source: https://docs.cryptorank.io/api-reference/currencies/top-gainers-&-losers
/openapi.json get /v3/currencies/gainers-losers
Returns the top coins by price movement over the selected period.
Available from: Basic
Cost: 1 credit per request
Default filters apply: minMarketCap=500000, minVolume24h=1000000.
Toggle between Gainers and Losers via group (default gainers).
# Trending Currencies
Source: https://docs.cryptorank.io/api-reference/currencies/trending-currencies
/openapi.json get /v3/currencies/trending
Returns coins with elevated interest right now.
Available from: Sandbox
Cost: 1 credit per request
Ranked by CryptoRank's internal Trending Score; reflects the moment of the request and can change quickly.
# Drophunting Activities List
Source: https://docs.cryptorank.io/api-reference/drophunting/drophunting-activities-list
/openapi.json get /v3/drophunting/list
Activities with status, reward type, raised funds and social metrics.
Available from: Advanced
Cost: 1 credit per request
Returns all activities, including those without published tasks.
# Drophunting Activity Profile
Source: https://docs.cryptorank.io/api-reference/drophunting/drophunting-activity-profile
/openapi.json get /v3/drophunting/{id}
Full profile of a single drophunting activity.
Available from: Pro
Cost: 1 credit per request
The task list is served separately via [/drophunting/:id/tasks](https://docs.cryptorank.io/api-reference/drophunting/drophunting-tasks).
# Drophunting Map
Source: https://docs.cryptorank.io/api-reference/drophunting/drophunting-map
/openapi.json get /v3/drophunting/map
Lightweight list of all drophunting activities with their IDs for reference.
Available from: Sandbox
Cost: 1 credit per request
# Drophunting Tasks
Source: https://docs.cryptorank.io/api-reference/drophunting/drophunting-tasks
/openapi.json get /v3/drophunting/{id}/tasks
List of tasks for a drophunting activity.
Available from: Business
Cost: 1 credit per request
# Ecosystem Profile
Source: https://docs.cryptorank.io/api-reference/ecosystems/ecosystem-profile
/openapi.json get /v3/ecosystems/{id}
Full metrics for a single ecosystem.
Available from: Advanced
Cost: 1 credit per request
List this ecosystem’s projects via [/currencies/list](https://docs.cryptorank.io/api-reference/currencies/currency-list-with-market-data) with the `ecosystemId` filter.
# Ecosystems Map
Source: https://docs.cryptorank.io/api-reference/ecosystems/ecosystems-map
/openapi.json get /v3/ecosystems/list
Lightweight list of ecosystems.
Available from: Sandbox
Cost: 1 credit per request
# Ecosystems Tags
Source: https://docs.cryptorank.io/api-reference/ecosystems/ecosystems-tags
/openapi.json get /v3/ecosystems/tags
All ecosystem tags.
Available from: Sandbox
Cost: 1 credit per request
# Exchange Monthly Volume Chart
Source: https://docs.cryptorank.io/api-reference/exchanges/exchange-monthly-volume-chart
/openapi.json get /v3/exchanges/{id}/volume-chart/monthly
Monthly adjusted and reported trading volumes (USD and BTC) over the selected multi-year period. Complements the daily [Exchange Volume Chart](https://docs.cryptorank.io/api-reference/exchanges/exchange-volume-chart).
Available from: Advanced
Cost: 1 credit per request
The current calendar month is partial — it holds the volume accumulated so far and updates daily. Explicit periods deeper than your plan's history limit return `403 PLAN_LIMIT_EXCEEDED`. Use `all` to get the deepest window your plan allows.
# Exchange Profile
Source: https://docs.cryptorank.io/api-reference/exchanges/exchange-profile
/openapi.json get /v3/exchanges/{id}
Full profile of a single exchange.
Available from: Basic
Cost: 1 credit per request
# Exchange Proof of Reserves
Source: https://docs.cryptorank.io/api-reference/exchanges/exchange-proof-of-reserves
/openapi.json get /v3/exchanges/{id}/reserves
Proof-of-Reserves holdings reported for the exchange.
Available from: Advanced
Cost: 1 credit per request
Available only for exchanges that publish Proof-of-Reserves data.
# Exchange Volume Chart
Source: https://docs.cryptorank.io/api-reference/exchanges/exchange-volume-chart
/openapi.json get /v3/exchanges/{id}/volume-chart
Historical adjusted and reported trading volume over the selected period.
Available from: Basic
Cost: 1 credit per request
There is no interval parameter — granularity is selected automatically from the period: intraday — 10-min, up to 14d — hourly, 30d+ — daily.
# Exchanges List with Volume
Source: https://docs.cryptorank.io/api-reference/exchanges/exchanges-list-with-volume
/openapi.json get /v3/exchanges/list
Exchanges with key profile fields and 24h trading volumes.
Available from: Basic
Cost: 1 credit per request
# Exchanges Map
Source: https://docs.cryptorank.io/api-reference/exchanges/exchanges-map
/openapi.json get /v3/exchanges/map
Lightweight list of all tracked exchanges.
Available from: Sandbox
Cost: 1 credit per request
# Supported Fiat Currency List
Source: https://docs.cryptorank.io/api-reference/fiat/supported-fiat-currency-list
/openapi.json get /v3/fiat/list
Returns all fiat currencies supported for price conversion via the convert parameter.
Available from: Sandbox
Cost: 1 credit per request
Pass a currency code from this list to the convert parameter on market-data endpoints.
# Funding Round Detail
Source: https://docs.cryptorank.io/api-reference/funding-rounds/funding-round-detail
/openapi.json get /v3/funding-rounds/{id}
Returns full details for a single funding round, including valuation, round description, source link, and the investor list split into lead and other investors.
Available from: Business
Cost: 1 credit per request
Take round IDs from the [/funding-rounds](https://docs.cryptorank.io/api-reference/funding-rounds/funding-rounds-feed) feed.
# Funding Rounds Feed
Source: https://docs.cryptorank.io/api-reference/funding-rounds/funding-rounds-feed
/openapi.json get /v3/funding-rounds/list
Returns a feed of the latest funding rounds, with filters.
Available from: Pro
Cost: 1 credit per request
from/to select a window within the available depth.
For a single coin's rounds, filter this feed by the `currencyId` query parameter.
# Fundraising Trends (Aggregate)
Source: https://docs.cryptorank.io/api-reference/funding-rounds/fundraising-trends-aggregate
/openapi.json get /v3/funding-rounds/trends
Returns an aggregated time series of funding rounds, bucketed by the selected `interval`: total raised, round count, and average/median round size per bucket.
Available from: Advanced
Cost: 1 credit per request
By default, late-stage / non-VC round types (IPO, Post-IPO, Post-IPO Debt, Debt Financing, M\&A, PIPE) are excluded — override with `excludeStages`.
A `from`/`to` range reaching deeper than your plan allows returns `403 PLAN_LIMIT_EXCEEDED` — the window is never silently cut.
# Most Active Investors
Source: https://docs.cryptorank.io/api-reference/funding-rounds/most-active-investors
/openapi.json get /v3/funding-rounds/most-active-investors
Returns the top investors by activity over the selected period: number of rounds participated in and, of those, how many as lead. Returns up to 50 funds.
Available from: Advanced
Cost: 1 credit per request
Activity is counted within the selected period only.
# Fund Co-Investors
Source: https://docs.cryptorank.io/api-reference/funds/fund-co-investors
/openapi.json get /v3/funds/{id}/co-investors
Returns funds that participated alongside this fund in the same rounds.
Available from: Business
Cost: 1 credit per request
Without from/to — all shared rounds across all time.
With from/to — only rounds within the window; a co-investor with no shared rounds in the window is dropped from the list.
# Fund Focus Area
Source: https://docs.cryptorank.io/api-reference/funds/fund-focus-area
/openapi.json get /v3/funds/{id}/focus-area
Returns the distribution of a fund's investments across categories.
Available from: Pro
Cost: 1 credit per request
# Fund Investments by Country
Source: https://docs.cryptorank.io/api-reference/funds/fund-investments-by-country
/openapi.json get /v3/funds/{id}/country
Returns the distribution of a fund's investments across project countries.
Available from: Pro
Cost: 1 credit per request
# Fund Investments by Stage
Source: https://docs.cryptorank.io/api-reference/funds/fund-investments-by-stage
/openapi.json get /v3/funds/{id}/stages
Returns the distribution of a fund's investments across round stages.
Available from: Pro
Cost: 1 credit per request
# Fund Profile (Summary)
Source: https://docs.cryptorank.io/api-reference/funds/fund-profile-summary
/openapi.json get /v3/funds/{id}
Returns a fund's profile: identity & metrics.
Available from: Advanced
Cost: 1 credit per request
Portfolio breakdowns (top investments, focus areas, stages, countries, co-investors) are served via separate sub-endpoints.
# Fund Top Investments
Source: https://docs.cryptorank.io/api-reference/funds/fund-top-investments
/openapi.json get /v3/funds/{id}/top-investments
Returns the top projects in a fund's portfolio.
Available from: Pro
Cost: 1 credit per request
Attention: totalInvested is the total size of every round the fund participated in - the full round size, not the fund's individual contribution.
# Funds List with Metrics
Source: https://docs.cryptorank.io/api-reference/funds/funds-list-with-metrics
/openapi.json get /v3/funds/list
Returns a list of funds with aggregated portfolio and activity metrics.
Available from: Advanced
Cost: 1 credit per request
# Funds Map (ID Reference)
Source: https://docs.cryptorank.io/api-reference/funds/funds-map-id-reference
/openapi.json get /v3/funds/map
Returns a lightweight list of all available funds with their IDs.
Available from: Sandbox
Cost: 1 credit per request
# Altcoin Season Chart
Source: https://docs.cryptorank.io/api-reference/global/altcoin-season-chart
/openapi.json get /v3/global/altcoin-index/chart
Returns a historical time series of the Altcoin Season Index.
Available from: Basic
Cost: 1 credit per request
Fixed interval: 1d. Available periods: 7d, 30d, 6m, 1y, ytd, all.
# Altcoin Season Index
Source: https://docs.cryptorank.io/api-reference/global/altcoin-season-index
/openapi.json get /v3/global/altcoin-index
Returns the current and previous Altcoin Season Index values with their classification.
Available from: Sandbox
Cost: 1 credit per request
Index ≥ 75 - Altcoin Season; 26–74 - Neutral; ≤ 25 - Bitcoin Season.
# BTC & ETH Dominance
Source: https://docs.cryptorank.io/api-reference/global/btc-&-eth-dominance
/openapi.json get /v3/global/dominance
Returns current market-cap dominance percentages for Bitcoin, Ethereum, and other assets.
Available from: Basic
Cost: 1 credit per request
Values are expressed as a percentage of total crypto market cap.
# Dominance Chart by Group (BTC, ETH, TOP-10 MCap, etc.)
Source: https://docs.cryptorank.io/api-reference/global/dominance-chart-by-group-btc-eth-top-10-mcap-etc
/openapi.json get /v3/global/dominance/chart
Returns a historical dominance time series for the specified asset group over the selected period.
Available from: Basic
Cost: 1 credit per request
Interval adjusts automatically by period:15m for 7d, 2h for 30d, 1d for 6m and 1y.
Available asset groups: btc, eth, sol, usdt, bnb, top10, top50, top100.
# Fear & Greed Chart
Source: https://docs.cryptorank.io/api-reference/global/fear-&-greed-chart
/openapi.json get /v3/global/fear-greed/chart
Returns a historical time series of the Fear & Greed Index.
Available from: Basic
Cost: 1 credit per request
Fixed interval: 1d. Available periods: 7d, 30d, 6m, 1y, ytd, all.
# Fear & Greed Index
Source: https://docs.cryptorank.io/api-reference/global/fear-&-greed-index
/openapi.json get /v3/global/fear-greed
Returns the current Crypto Fear & Greed Index value and its classification.
Available from: Sandbox
Cost: 1 credit per request
Classification bands: 0–25 Extreme Fear, 26–45 Fear, 46–55 Neutral, 56–75 Greed, 76–100 Extreme Greed.
# Global Market Snapshot
Source: https://docs.cryptorank.io/api-reference/global/global-market-snapshot
/openapi.json get /v3/global/market
Returns a real-time snapshot of the overall crypto market.
Available from: Sandbox
Cost: 1 credit per request
For BTC/ETH market share use [/global/dominance](https://docs.cryptorank.io/api-reference/global/btc-&-eth-dominance).
# Launchpad Profile
Source: https://docs.cryptorank.io/api-reference/launchpads/launchpad-profile
/openapi.json get /v3/launchpads/{id}
Full launchpad profile and aggregate metrics.
Available from: Advanced
Cost: 1 credit per request
Per-sale history is served via [/public-sales/list](https://docs.cryptorank.io/api-reference/public-sales/public-sales-list) with the `launchpadIds` filter.
# Launchpads List with Metrics
Source: https://docs.cryptorank.io/api-reference/launchpads/launchpads-list-with-metrics
/openapi.json get /v3/launchpads/list
Paginated list of launchpads with performance metrics over the last year: `rank`, `salesCount`, `avgRoi` (average all-time-high ROI across sales as a multiplier) and `totalRaised`. Optionally filter by launchpad `type` (`IDO` / `IEO` / `ICO`). Sortable by `rank` (default), `salesCount`, `roi`; direction via `sortOrder` (`asc` / `desc`, default `asc`).
Available from: Advanced
Cost: 1 credit per request
# Launchpads Map
Source: https://docs.cryptorank.io/api-reference/launchpads/launchpads-map
/openapi.json get /v3/launchpads/map
Lightweight list of all launchpads with their IDs for reference.
Available from: Sandbox
Cost: 1 credit per request
# News Detail
Source: https://docs.cryptorank.io/api-reference/news/news-detail
/openapi.json get /v3/news/{id}/main-text
Full article body (main text) of a single news article by `id`.
Available from: Advanced
Cost: 1 credit per request
Call only when `hasMainText` is true in the feed — otherwise the article has no separate body and the call wastes a credit.
# News Feed
Source: https://docs.cryptorank.io/api-reference/news/news-feed
/openapi.json get /v3/news/feed
Crypto news feed with title, summary, source, tags and related coins/funds.
Available from: Advanced
Cost: 1 credit per request
Filterable by coin, fund, tag, and date range.
`hasMainText` indicates whether a full article body is available via the [news detail endpoint](https://docs.cryptorank.io/api-reference/news/news-detail) — fetch it there. Check it before spending a credit on the detail call.
# Person Educations
Source: https://docs.cryptorank.io/api-reference/persons/person-educations
/openapi.json get /v3/persons/{id}/education
Education history of a person.
Available from: Business
Cost: 1 credit per request
# Person Positions
Source: https://docs.cryptorank.io/api-reference/persons/person-positions
/openapi.json get /v3/persons/{id}/positions
Current and previous positions of a person across currencies, exchanges, funds and launchpads.
Available from: Business
Cost: 1 credit per request
# Person Profile
Source: https://docs.cryptorank.io/api-reference/persons/person-profile
/openapi.json get /v3/persons/{id}
Profile header of a single person.
Available from: Business
Cost: 1 credit per request
Positions and education are served via separate sub-endpoints.
# Persons List
Source: https://docs.cryptorank.io/api-reference/persons/persons-list
/openapi.json get /v3/persons/list
Persons with category and summary counters for browsing.
Available from: Pro
Cost: 1 credit per request
For full details use [/persons/:id](https://docs.cryptorank.io/api-reference/persons/person-profile) and its sub-endpoints.
# Persons Map
Source: https://docs.cryptorank.io/api-reference/persons/persons-map
/openapi.json get /v3/persons/map
Lightweight list of all persons.
Available from: Sandbox
Cost: 1 credit per request
# Public Sale Detail
Source: https://docs.cryptorank.io/api-reference/public-sales/public-sale-detail
/openapi.json get /v3/public-sales/{id}
Full data on a single public sale (token sale / crowdsale). Includes heavy and privileged fields not returned in the list view: valuation, initial market cap, tokens for sale, ROI / ATH ROI, project backers (`investors`) and the sale description.
Available from: Pro
Cost: 1 credit per request
ROI and ATH ROI are multipliers (×), not percentages.
# Public Sales List
Source: https://docs.cryptorank.io/api-reference/public-sales/public-sales-list
/openapi.json get /v3/public-sales/list
Returns a feed of public sales, with filters.
Available from: Pro
Cost: 1 credit per request
Sale details are available via [/public-sales/:id](https://docs.cryptorank.io/api-reference/public-sales/public-sale-detail).
# Public Sales Trends (Aggregate)
Source: https://docs.cryptorank.io/api-reference/public-sales/public-sales-trends-aggregate
/openapi.json get /v3/public-sales/trends
Aggregated time series of completed token sales (`ICO`, `IDO`, `IEO`). Each bucket includes total raised in USD and sales count by type.
Available from: Advanced
Cost: 1 credit per request
A `from`/`to` range reaching deeper than your plan allows returns `403 PLAN_LIMIT_EXCEEDED` — the window is never silently cut.
# API Health Check
Source: https://docs.cryptorank.io/api-reference/system/api-health-check
/openapi.json get /v3/ping
Returns the current server timestamp.
Available from: Sandbox
Cost: Free
No API key required.
Use it to verify the API is reachable and to measure response latency before sending production requests.
# API Plan & Usage Status
Source: https://docs.cryptorank.io/api-reference/system/api-plan-&-usage-status
/openapi.json get /v3/status
Returns the authenticated user's current plan, rate limit (RPM), and credit usage for the active billing period.
Available from: Sandbox
Cost: Free
Poll it to monitor quota and build adaptive request throttling.
# Tickers
Source: https://docs.cryptorank.io/api-reference/tickers/tickers
/openapi.json get /v3/tickers
Trading pairs filtered by coin, by exchange, or both.
Available from: Basic
Cost: 1 credit per request
currencyId only — all tickers for a coin across exchanges; exchangeId only — all tickers on an exchange; both — tickers for that coin on that exchange.
bid, ask and open24h are reported by the exchange and may be null for pairs where the exchange does not expose order-book data.
# Token Emission Chart
Source: https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/token-emission-chart
/openapi.json get /v3/currencies/{id}/vesting/chart
Returns a time series of token emission for a currency.
Available from: Pro
Cost: 1 credit per request
Untracked allocations are excluded — cumulative values may stay below total supply.
There is no interval parameter — granularity is selected automatically from the range: daily for ranges up to 3 years, weekly beyond.
Per-round release rules behind this chart: [/currencies/:id/vesting/schedule](https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/vesting-schedule-chart). Discrete unlock events: [/currencies/:id/vesting/events](https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/unlock-events).
# Token Unlock Dynamics
Source: https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/token-unlock-dynamics
/openapi.json get /v3/token-unlocks/dynamics
Returns market-wide token unlock dynamics as a time series (history and forecast), with no breakdown.
Available from: Advanced
Cost: 1 credit per request
Untracked allocations are excluded. Unlock value is computed from each token's current price, for both past and upcoming unlocks. Tokens whose price has stopped updating are left out.
Without `from`/`to` the window is skewed towards upcoming unlocks, sized to the selected `interval`. Both bounds snap to `interval` bucket starts. One response carries at most 366 daily, 520 weekly or 1000 monthly points — wider ranges have to be requested in slices.
# Token Unlock Dynamics by Category
Source: https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/token-unlock-dynamics-by-category
/openapi.json get /v3/token-unlocks/dynamics/by-category
Returns market-wide token unlock dynamics as a time series (history and forecast), split by coin primary category.
Available from: Advanced
Cost: 1 credit per request
Untracked allocations are excluded. Unlock value is computed from each token's current price, for both past and upcoming unlocks. Tokens whose price has stopped updating are left out.
Coins without a category are grouped into a single `Uncategorized` entry, always placed last, so the breakdown always adds up to `totalUnlockValue`.
Without `from`/`to` the window is skewed towards upcoming unlocks, sized to the selected `interval`. Both bounds snap to `interval` bucket starts. One response carries at most 366 daily, 520 weekly or 1000 monthly points — wider ranges have to be requested in slices.
# Token Unlock Dynamics by Token
Source: https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/token-unlock-dynamics-by-token
/openapi.json get /v3/token-unlocks/dynamics/by-token
Returns market-wide token unlock dynamics as a time series (history and forecast), split by individual token.
Available from: Pro
Cost: 1 credit per request
Untracked allocations are excluded. Unlock value is computed from each token's current price, for both past and upcoming unlocks. Tokens whose price has stopped updating are left out.
The top `topN` tokens are ranked by unlock value over the whole window, so one set of tokens carries the whole series — though a token with no unlocks in a given bucket is absent from that point. Everything outside the top-N is summed into a single `Others` entry, always placed last, so the breakdown always adds up to `totalUnlockValue`.
Without `from`/`to` the window is skewed towards upcoming unlocks, sized to the selected `interval`. Both bounds snap to `interval` bucket starts. One response carries at most 366 daily, 520 weekly or 1000 monthly points — wider ranges have to be requested in slices.
# Unlock Events
Source: https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/unlock-events
/openapi.json get /v3/currencies/{id}/vesting/events
Chronological list of token unlock events for a currency.
Available from: Pro
Cost: 1 credit per request
Filterable by all / upcoming / past. Amounts are in the project's native token; USD figures use the current price.
# Upcoming Token Unlocks
Source: https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/upcoming-token-unlocks
/openapi.json get /v3/currencies/upcoming-token-unlocks
Returns upcoming unlocks across all coins.
Available from: Pro
Cost: 1 credit per request
For a single coin's full unlock schedule use [/currencies/:id/vesting/events](https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/unlock-events).
# VC Dump Pressure
Source: https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/vc-dump-pressure
/openapi.json get /v3/currencies/{id}/vesting/vc-pressure
VC-induced dump pressure for a single coin: upcoming unlock, VC dominance, investor ROI and the dump-pressure rating.
Available from: Pro
Cost: 1 credit per request
Profit and USD values depend on the current price and are recalculated as it changes.
# Vesting Allocations
Source: https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/vesting-allocations
/openapi.json get /v3/currencies/{id}/vesting/allocations
Returns the unlock breakdown by allocation group (Team, Private Sale, …).
Available from: Pro
Cost: 1 credit per request
Untracked allocations are excluded. groupDominance = % of total locked.
# Vesting Schedule Chart
Source: https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/vesting-schedule-chart
/openapi.json get /v3/currencies/{id}/vesting/schedule
Per-round (allocation) token release schedule over time: cliff/linear/batch phases with dates, share, and token amounts. Data for the vesting schedule chart.
Available from: Pro
Cost: 1 credit per request
Allocations without a tracked schedule are summarized in the untracked block, not listed as rounds. Amounts are in the project's native token.
# Authentication
Source: https://docs.cryptorank.io/authentication
Authenticate every request with the X-Api-Key header.
All v3 requests authenticate with a single header.
| Header | Type | Description |
| ----------- | ----------------- | ---------------------------------------------------------------------------------------------------------- |
| `X-Api-Key` | string · required | Your 60-character hex API key. Generate it in the [dashboard](https://cryptorank.io/public-api/dashboard). |
```bash theme={null}
curl https://api.cryptorank.io/v3/currencies/map \
-H "X-Api-Key: YOUR_API_KEY"
```
## Key facts
* Keys are **shared with v2** — an existing v2 key works on v3.
* **Credits are per user** (shared across all of your keys); **rate limit (RPM) is per key**.
## Errors
Auth failures return `401` (`API_KEY_MISSING` / `API_KEY_INVALID`) or `403 NO_ACTIVE_SUBSCRIPTION`.
See [Errors](/errors) for the full list.
# Errors
Source: https://docs.cryptorank.io/errors
Error response envelope and the full list of error codes.
Every error returns the same JSON envelope; `status` mirrors the HTTP status. Switch on `code`, not
`message` (message text may change).
```json Error envelope theme={null}
{
"error": {
"code": "API_KEY_INVALID",
"message": "API key is invalid",
"status": 401
}
}
```
**Errors don't consume credits** — only successful (`2xx`) responses deduct.
## Error codes
| Status | `code` | When it happens |
| ------ | -------------------------- | -------------------------------------------------------------------------------------------------------- |
| `400` | `VALIDATION_ERROR` | A query or path parameter failed validation (wrong type, out of range, malformed). |
| `401` | `API_KEY_MISSING` | The `X-Api-Key` header was not sent. |
| `401` | `API_KEY_INVALID` | The API key is not recognized. |
| `403` | `NO_ACTIVE_SUBSCRIPTION` | The key's account has no active subscription. |
| `403` | `ENDPOINT_NOT_AVAILABLE` | The endpoint is not included in your plan. |
| `403` | `PLAN_LIMIT_EXCEEDED` | The request goes beyond what your current plan allows (e.g. a time range deeper than your plan permits). |
| `404` | `NOT_FOUND` | The requested resource does not exist. |
| `429` | `RATE_LIMIT_EXCEEDED` | The per-key request rate (RPM) was exceeded. |
| `429` | `DAILY_CREDITS_EXCEEDED` | The daily credit allowance is used up. |
| `429` | `MONTHLY_CREDITS_EXCEEDED` | The monthly credit allowance is used up. |
| `500` | `INTERNAL_ERROR` | An unexpected server error. Retry with backoff; if it persists, contact support. |
## Rate limits and retries
`429` responses carry a `Retry-After` header (seconds) — wait that long before retrying. See
[Pricing page](https://cryptorank.io/public-api/pricing?cta=docs) for per-plan rates and allowances.
Retry only `429` (respect `Retry-After`) and `500`. Other `4xx`
(`400`/`401`/`403`/`404`) just fail again until you fix the input, key, plan,
or resource.
# Introduction
Source: https://docs.cryptorank.io/index
Cryptorank Public API v3 — funding rounds, token unlocks, funds, and market data for B2B clients and partners.
**Primary Server URL:** [https://api.cryptorank.io/v3/](https://api.cryptorank.io/v3/)
Compare daily and monthly quotas and pick the tier that fits.
Moving from v2? See what changed and the full v2 → v3 endpoint mapping.
Generate an API key in the dashboard and pass it in the `X-Api-Key`
header.
Connect Cryptorank data to Claude, Cursor, or any MCP client.
# MCP Server
Source: https://docs.cryptorank.io/mcp-server
Connect Claude, ChatGPT, or any MCP client to CryptoRank data over the Model Context Protocol — plus the full tool catalogue.
The CryptoRank MCP Server is a single, authenticated remote server. There is no keyless tier and no local server — all access goes through your CryptoRank Public API key on the PRO plan or higher.
**Server URL** — `https://api.cryptorank.io/mcp`
## Requirements
| Setup | What you need |
| ------------- | --------------------------------------------------------------------------------------- |
| Web | PRO API Plan · a Claude (Pro & above) or ChatGPT (Plus & above) subscription |
| Desktop / IDE | PRO API Plan · an MCP-compatible client (Claude Desktop, Cursor, Windsurf, Claude Code) |
## Connect
Sign in at claude.ai and open a new conversation.
Click the plus icon in the message toolbar, then **Connectors → Manage Connectors**.
Click the plus icon, then **Add custom connector**, and enter the URL `https://api.cryptorank.io/mcp`. Click **Add**.
Sign in with the CryptoRank account tied to your PRO API plan and approve access. CryptoRank then appears in your connector list.
In a new chat with the connector enabled, ask *"What are the latest crypto funding rounds?"* — you should get live CryptoRank data.
In **Settings → Apps & Connectors → Advanced settings**, turn **Developer mode** ON. It must stay on for MCP connectors to work.
In **Apps & Connectors**, click **Create app**.
Name it `CryptoRank MCP` and set the URL to `https://api.cryptorank.io/mcp`. Save.
Sign in with the CryptoRank account tied to your PRO API plan and approve access.
In a new chat, click the plus icon, select **CryptoRank**, then ask *"What are the latest crypto funding rounds?"* to confirm live data.
Config-file clients connect through `mcp-remote`, passing your API key as an environment variable. After saving and restarting, the CryptoRank tools appear automatically and the model calls them when relevant.
```json mcp config theme={null}
{
"mcpServers": {
"cryptorank_mcp": {
"command": "npx",
"args": ["mcp-remote", "https://api.cryptorank.io/mcp"],
"env": {
"CRYPTORANK_API_KEY": "YOUR_PRO_API_KEY"
}
}
}
}
```
Replace `YOUR_PRO_API_KEY` with your CryptoRank API key, then restart the client. For Claude Code, add the server with `claude mcp add` or drop the same `mcpServers` block into your MCP config.
| Client | Config file path |
| ------------------------ | ----------------------------------------------------------------- |
| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json` |
| Cursor | `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global) |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
Connectors added mid-conversation don't apply retroactively. If you get
generic or stale answers, start a fresh chat and ask explicitly for "latest"
or "current" data.
## Pricing & limits
MCP has no separate price — it's bundled with PRO and higher tiers.
## Troubleshooting
| Problem | Fix |
| ------------------------------------------------ | ----------------------------------------------------------------------------------- |
| Connector added but the agent ignores CryptoRank | Toggle the connector OFF → ON, then start a new chat (OAuth-init quirk). |
| "Connectors" not visible in Claude | Requires a Claude Pro/Max/Team/Enterprise plan. Try another browser or clear cache. |
| "Connectors" not visible in ChatGPT | Enable Developer Mode under Apps & Connectors → Advanced settings. |
| "Unable to connect" | Confirm the URL is exactly `https://api.cryptorank.io/mcp`, then retry. |
| "Rate limit exceeded" | Confirm your plan is PRO or higher; wait, or upgrade for higher limits. |
| OAuth popup blocked | Allow popups for the client domain; try Chrome or Edge; disable ad blockers. |
| Connector listed but no tools | Your key likely lacks PRO access — check your plan. |
## MCP Tools
Every tool the CryptoRank MCP server exposes, what it returns, and the jobs it's built for.\
The tools are designed around research workflows, not as a 1:1 mirror of the REST API.
Tools that need an `id` (`get_*`) expect CryptoRank's internal id. Resolve a
name, symbol or alias to an `id` first — `resolve_entity` handles coins, funds
and funding rounds in one call, or use the matching `search_*` tool (e.g.
`search_currency` → `get_currency_profile`).
## Entity resolution
| Tool | What it returns | Good for |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
| `resolve_entity` | Internal ids for a free-form string — coin, ticker, fund, alias, funding round; narrow with `entityTypes`. Returns no business data | The first step before any `get_*` call |
`resolve_entity` always matches against coin names and tickers or fund names —
never against a person. To reach a project's team, resolve the project, then
pass the currency id to `get_currency_team`.
## Funding rounds
The core fundraising dataset — who raised, how much, from whom, and when.
| Tool | What it returns | Good for |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| `search_funding_round` | Rounds filtered by `investor`, `stage`, `dateRange`, `category`, `raise`, `tags` | *"Recent rounds led by a16z"*, *"AI projects that raised over \$10M in 2026"* |
| `get_funding_round` | One round in full — stage, valuation, source, lead + other investors, project details | Drilling into a single deal |
| `get_currency_funding_rounds` | Every round for one project, with investors and ROI | A project's full investment history |
| `get_funding_trends` | Aggregated time series — total raised, round count, average and median cheque per day/week/month; `categoryId`, `excludeStages` | *"Is fundraising recovering?"*, market-level trend charts |
`get_funding_trends` excludes rounds with an undisclosed raise, and by default
excludes late-stage / non-VC types (IPO, Post-IPO, Post-IPO Debt, Debt
Financing, M\&A, PIPE). It returns no individual rounds — use
`search_funding_round` for those.
## Funds & investors
VC profiles, portfolios, syndicates and activity — built for fund research and sales prospecting.
| Tool | What it returns | Good for |
| --------------------------- | ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| `search_fund` | Funds ranked/filtered by `type`, tier, portfolio, ROI, activity in a `dateRange` | *"Top funds active this quarter"*, discovery and ranking |
| `get_fund_profile` | Fund profile — tier, portfolio size, Retail ROI, top investments, focus narratives/countries, recent rounds | *"a16z's latest deals and focus"* |
| `get_fund_team` | Full fund team — names, roles, social links | Sourcing contacts at a fund |
| `get_fund_co_investors` | Top 20 funds that invested alongside a given fund — tier, shared-round count, last shared round | Mapping syndicates and partnership patterns |
| `get_most_active_investors` | Ranking of funds by rounds joined, rounds led and capital deployed over `30d`–`all` | *"Who is actually deploying right now?"* |
## Coins & market data
Project metadata plus current, historical and screener-style market data.
| Tool | What it returns | Good for |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| `search_currency` | Traded coins with market metrics; filter by `name`, `symbol`, `category`, `tag`, `percentChange`; sort by rank/cap/volume/change | Building coin lists, resolving a symbol to an `id` |
| `get_currency_profile` | Extended profile — metadata, categories/tags, supply, market indicators, contracts, top-3 team | A single coin's full snapshot |
| `get_historical_currency` | OHLC, volume, market cap and supply for one coin over a date range (`day`/`week`/`month`) | *"ETH price in March 2023"*, time-series analysis |
| `search_historical_currency` | Market snapshot for many coins at one point in `time` | Cross-section of the market on a given date |
| `get_gainers_losers` | Top movers over `24h`/`7d`/`30d`, gainers or losers, with market-cap and volume floors to cut illiquid coins | Market overview and screening |
## Tokenomics, vesting & unlocks
From a one-call supply summary down to the individual unlock event.
| Tool | What it returns | Good for |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| `get_tokenomics_summary` | Supply snapshot — total/max/circulating, circulating %, FDV, locked vs unlocked, and the next unlock in tokens and USD | The fastest answer to *"how much is still locked?"* |
| `get_vesting_allocations` | Unlock breakdown per allocation group (Team, Private Sale…) — locked/unlocked, share of supply, dominance, next unlock | *"Who holds the locked TON supply?"* |
| `get_unlock_events` | Chronological unlock events for one coin — `all`/`upcoming`/`past`, sortable by time, USD value or share of market cap | Building an unlock calendar for a single asset |
| `get_currency_vesting` | Full vesting and allocation data for one coin — per-allocation type, frequency, duration, upcoming events | *"How well-designed is TON's vesting?"* |
| `search_unlock` | Coins with upcoming unlocks; filter by `nextUnlockDate`, `nextUnlockValueUSD`, share of supply/mcap; `hideSmallUnlocks` | *"Big unlocks this week"*, market-wide unlock watch |
Start with `get_tokenomics_summary` for a single number, go to
`get_vesting_allocations` for the per-group split, and only then to
`get_unlock_events` for the event list. `get_currency_vesting` returns all of
it at once when you want the raw dump.
## Exchanges
| Tool | What it returns | Good for |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| `search_exchange` | Exchanges with key profile fields and 24h volumes; filter by `type` (`cex-spot`, `cex-derivatives`, `dex-spot`, `dex-derivatives`), sort by volume | Ranking, discovery, resolving an exchange `id` |
| `get_exchange_profile` | Full profile — type, founded, native token, volumes, market share, pairs/coins, open interest, jurisdiction; `detailed` mode adds Proof-of-Reserves | Due diligence on a single venue |
| `get_exchange_volume_chart` | Historical adjusted and reported volume for one exchange over 1–365 days | Trend analysis of exchange activity |
Proof-of-Reserves data appears only in `detailed` mode, only for exchanges
that publish it, and only on plans that include it.
## News
| Tool | What it returns | Good for |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- |
| `search_news` | News feed newest-first — headline, preview, source, tags, mentioned coins and funds; filter by coin, fund, tag, language, `dateRange`; cursor pagination | *"What's the news on Solana this week?"* |
| `get_news_article` | Full article body by `id` from `search_news` | Reading a story in full before summarising it |
`search_news` returns previews only. Check `hasMainText` before calling
`get_news_article` — headline-only items return `null`. Languages: `en`, `ru`,
`es`, `zh`, `tr`, `vi`, `pt`, `ko`.
## Teams & people
| Tool | What it returns | Good for |
| ------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| `get_currency_team` | Complete project team (current + former) with roles, descriptions, social links | *"Contacts for the Solana team"* — fuller than the profile's top-3 |
## Public sales
| Tool | What it returns | Good for |
| -------------------- | ------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
| `search_public_sale` | IDO/ICO/IEO sales; filter by `crowdsaleStatus`, `dateRange`, `launchpadIds`, `raise`, `lifeCycle`, `isTraded` | Discovery of public fundraising activity |
| `get_public_sale` | All public sale rounds for one project — type, dates, price, raise, allocation, ROI, launchpad | Detailed sale history for a project |
## Launchpads
| Tool | What it returns | Good for |
| ----------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------- |
| `search_launchpad` | Launchpads with key metrics (rank, ROI, raised) | Ranking and discovery |
| `get_launchpad_profile` | Launchpad profile — ROI, ATH ROI, total/average raise, top & recent projects, categories (`timeframe`) | Evaluating a launchpad's track record |
| `get_launchpad_team` | Full launchpad team with roles and links | Contacts at a launchpad |
## Global market
| Tool | What it returns | Good for |
| ----------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------- |
| `get_global_data` | Total/active projects, BTC & ETH dominance, Fear & Greed, Altcoin Season Index, total market cap and spot volume | High-level market context |
## Drophunting
| Tool | What it returns | Good for |
| -------------------------- | ------------------------------------------------------------------------------------- | ------------------------------ |
| `search_drophunting` | Activities filtered by `status`, `reward` type; sorted by update/name | Discovering airdrop activities |
| `get_drophunting_activity` | One activity in full — rewards, participating funds, social metrics, tasks and guides | Working a specific airdrop |
## Common workflows
Each maps to one or two tools — no manual chaining:
| Question | Tools |
| ---------------------------------------------- | ----------------------------------------------------------------- |
| *"Find projects a16z invested in"* | `search_funding_round` (investor) → `get_currency_funding_rounds` |
| *"Recent rounds with lead investor a16z"* | `search_funding_round` |
| *"Who invested in SUI?"* | `resolve_entity` → `get_currency_funding_rounds` |
| *"Is crypto fundraising recovering?"* | `get_funding_trends` |
| *"Who deployed the most capital this quarter"* | `get_most_active_investors` |
| *"Who does Paradigm co-invest with?"* | `resolve_entity` → `get_fund_co_investors` |
| *"Funds focused on Privacy"* | `search_fund` |
| *"a16z Crypto's latest deals"* | `resolve_entity` → `get_fund_profile` |
| *"Big unlocks this week"* | `search_unlock` |
| *"How much of TON is still locked?"* | `resolve_entity` → `get_tokenomics_summary` |
| *"Who holds TON's locked supply?"* | `resolve_entity` → `get_vesting_allocations` |
| *"TON's unlock calendar"* | `resolve_entity` → `get_unlock_events` |
| *"Today's top gainers over \$100M cap"* | `get_gainers_losers` |
| *"Bybit's volume trend and reserves"* | `search_exchange` → `get_exchange_profile` (`detailed`) |
| *"Latest news on Solana"* | `resolve_entity` → `search_news` → `get_news_article` |
| *"Contacts for the Solana team"* | `resolve_entity` → `get_currency_team` |
| *"ETH price in March 2023"* | `resolve_entity` → `get_historical_currency` |
# Endpoints Mapping
Source: https://docs.cryptorank.io/migration/endpoints-mapping
Map your v2 calls onto v3: common workflows as before/after recipes, plus a full endpoint reference.
This page maps your existing v2 integration onto v3. Start with the **recipes** if you think in terms of screens and workflows — each shows a typical v2 call and the v3 calls that replace it.
Use the **full endpoint reference** at the bottom as the complete lookup table. End with the **checklist** before you cut over.
There is **no `full-metadata` endpoint in v3**. Where v2 returned an entire entity in one call, v3 splits the data across focused endpoints.
## Migration recipes
Each recipe shows one v2 call and the set of v3 calls that replace it. Request only the slices your screen needs — every call draws credits independently. **Minimum plan** reflects the highest-gated endpoint in the recipe.
### 1. Full coin card
| Was (v2) | Now (v3) |
| ------------------------------- | ---------------------------------------------------------- |
| `/currencies/:id/full-metadata` | `/currencies/:id` — core profile |
| | `/currencies/:id/performance` — performance metrics |
| | `/currencies/:id/sparkline` — price & volume chart |
| | `/currencies/:id/contracts` — contract addresses |
| | `/currencies/:id/tokenomics` — supply & tokenomics summary |
| | `/currencies/:id/analytics/returns` — periodic returns |
| | `/tickers` — markets for the coin |
Minimum plan: **Advanced**.
### 2. Tokenomics & unlocks
| Was (v2) | Now (v3) |
| ------------------------------- | ----------------------------------------------------------- |
| `/currencies/:id/vesting` | `/currencies/:id/tokenomics` — supply overview |
| | `/currencies/:id/vesting/allocations` — allocations |
| | `/currencies/:id/vesting/schedule` — schedule by allocation |
| | `/currencies/:id/vesting/events` — unlock events |
| `/currencies/:id/vesting/chart` | `/currencies/:id/vesting/chart` — emission chart |
| `/currencies/token-unlock` | `/currencies/upcoming-token-unlocks` — across all coins |
`vesting/chart` now returns the **delta unlocked per period**, not a running
cumulative total. A `from`/`to` window returns deltas inside the window only,
without a baseline.
Minimum plan: **Pro**.
### 3. Fund data
| Was (v2) | Now (v3) |
| -------------------------- | ---------------------------------------------- |
| `/funds/:id/full-metadata` | `/funds/:id` — fund profile |
| | `/funds/:id/top-investments` — top investments |
| | `/funds/:id/focus-area` — focus areas |
| | `/funds/:id/stages` — investments by stage |
| | `/funds/:id/country` — investments by country |
| | `/funds/:id/co-investors` — co-investors |
Minimum plan: **Business**.
### 4. Funding rounds
| Was (v2) | Now (v3) |
| -------------------------------- | ---------------------------------------------------------- |
| `/currencies/:id/funding-rounds` | `/funding-rounds/list` — feed of rounds |
| | `/funding-rounds/:id` — round detail, incl. lead investors |
The list feed gives the overview; the detail endpoint adds lead-investor breakdown. Minimum plan: **Business**.
### 5. Drophunting
| Was (v2) | Now (v3) |
| ---------------------------- | ------------------------------------------------- |
| `/drophunting/activity/:id` | `/drophunting/list` — activities list |
| | `/drophunting/:id` — activity profile |
| `/drophunting/.../all-tasks` | `/drophunting/:id/tasks` — tasks for the activity |
Minimum plan: **Business**.
## Full endpoint reference
Complete v2 → v3 lookup by group. For renamed 1:1 endpoints, the v3 path is given directly; follow the reference page for renamed fields.
### Currencies & markets
| v2 | v3 |
| ------------------------------- | -------------------------------------------------------------------------------- |
| `/currencies/map` | `/currencies/map`, `/currencies/list` |
| `/currencies/search` | `/currencies/search` |
| `/currencies/:id` | `/currencies/:id` |
| `/currencies/:id/full-metadata` | `/currencies/:id/performance`, `/contracts`, `/tokenomics`, `/analytics/returns` |
| `/currencies/:id/sparkline` | `/currencies/:id/sparkline` |
| `/markets` | `/tickers` |
| — | `/currencies/trending`, `/currencies/gainers-losers`, `/currencies/derivatives` |
### Vesting & token unlocks
| v2 | v3 |
| ------------------------------- | ----------------------------------------------------------------------------- |
| `/currencies/:id/vesting` | `/currencies/:id/vesting/allocations`, `/vesting/schedule`, `/vesting/events` |
| `/currencies/:id/vesting/chart` | `/currencies/:id/vesting/chart` |
| `/currencies/token-unlock` | `/currencies/upcoming-token-unlocks` |
### Funds
| v2 | v3 |
| -------------------------- | ------------------------------------------------------------------ |
| `/funds`, `/funds/:id` | `/funds/list`, `/funds/:id` |
| `/funds/map` | `/funds/map` |
| `/funds/:id/full-metadata` | `/funds/:id/top-investments`, `/focus-area`, `/stages`, `/country` |
| — | `/funds/:id/co-investors` |
### Funding rounds & public sales
| v2 | v3 |
| -------------------------------------------------------------- | ----------------------------------------------------------------- |
| `/currencies/:id/funding-rounds`, `/currencies/funding-rounds` | `/funding-rounds/list` |
| — | `/funding-rounds/:id` (with lead investors) |
| — | `/funding-rounds/trends`, `/funding-rounds/most-active-investors` |
| `/currencies/public-sales` | `/public-sales/list`, `/public-sales/:id` |
| — | `/public-sales/trends` |
### Team & persons
| v2 | v3 |
| ------------------------------------------ | ------------------------------------------------------------------ |
| ` /funds/:id/team`, `/launchpads/:id/team` | |
| — | `/persons/map`, `/persons/list` |
| — | `/persons/:id`, `/persons/:id/positions`, `/persons/:id/education` |
### Drophunting
| v2 | v3 |
| ---------------------------- | --------------------------------------- |
| `/drophunting/activity/:id` | `/drophunting/:id` |
| `/drophunting/.../all-tasks` | `/drophunting/:id/tasks` |
| — | `/drophunting/list`, `/drophunting/map` |
### Exchanges
| v2 | v3 |
| ------------------------------ | ----------------------------------- |
| `/exchanges`, `/exchanges/:id` | `/exchanges/list`, `/exchanges/:id` |
| `/exchanges/:id/full-metadata` | — |
| — | `/exchanges/:id/reserves` |
| — | `/exchanges/:id/volume-chart` |
| `/exchanges/map` | `/exchanges/map` |
### Launchpads, ecosystems, news
| v2 | v3 |
| --------------------------------------------- | -------------------------------------- |
| `/launchpads`, `/launchpads/:id` | `/launchpads/list`, `/launchpads/:id` |
| `/launchpads/:id/full-metadata` | `/public-sales/list?launchpadIds=:id` |
| `/ecosystems/:id`, `/ecosystems/:id/projects` | `/ecosystems/:id` |
| `/ecosystems/map`, `/ecosystems/tags` | `/ecosystems/list`, `/ecosystems/tags` |
| `/news/feed` | `/news/feed` |
| — | `/news/:id/main-text` |
### Core & global
| v2 | v3 |
| ---------------------- | ------------------------------------------------------ |
| `/global` | `/global/market` |
| `/global` (dominance) | `/global/dominance`, `/global/dominance/chart` |
| — | `/global/fear-greed`, `/global/fear-greed/chart` |
| — | `/global/altcoin-index`, `/global/altcoin-index/chart` |
| `/token-platforms/map` | `/blockchains/map`, `/blockchains/list` |
| `/currencies/fiat` | `/fiat/list` |
Two cross-cutting rules that can break clients silently:
* **`convert`** applies to **fiat conversion only**. It does not convert between cryptocurrencies.
* **ATH / ATL / high24h / low24h are always returned in USD** and are never affected by `convert`.
# Overview
Source: https://docs.cryptorank.io/migration/overview
What changed between Public API v2 and v3, and how to move your integration over.
This guide is a high-level map for teams already integrated on v2 — what moved, what to call instead, and how to recheck your plan. For field-by-field details, follow the links to each endpoint's reference page.
## What changed at a glance
v2 exposed a few **monolithic `full-metadata` endpoints** that returned everything about an entity in one response. Data is split into **granular endpoints**, each returning one focused slice.
This is the core shift to plan around — see [Endpoint mapping](/migration/endpoints-mapping) for the full table.
Per-plan rate limits and credit allowances, and how the new call pattern affects consumption.
Every v2 endpoint and its v3 replacement(s).
## Base conventions
* **Prefix.** All routes live under `/v3`. There is no shared-version mode — a key calls v3 routes directly.
* **Authentication.** Pass your key in the **`X-Api-Key` header**. v3 never accepts the key as a query parameter.
* **Response envelope.** Object responses return `{ data, status }`; list responses return `{ data, meta, status }`. Read your payload from `data`.
## Migration timeline
For several months after v3 ships, v2 and v3 are both live. Integrate and
validate v3 against your real traffic during this window.
After the parallel window, v2 plans can't be purchased or renewed. Active
subscriptions run until their paid period ends, then you'll need v3.
# Plans & limits
Source: https://docs.cryptorank.io/migration/plans-and-limits
v3 rate limits and credit allowances, and how the granular call pattern changes consumption.
## Plans
| Plan | Price / mo | Price / yr | Rate limit (req/min) | Credits / month |
| ---------- | ---------- | ---------- | -------------------- | --------------- |
| Sandbox | \$0 | \$0 | 10 | 10,000 |
| Basic | \$29 | \$290 | 30 | 100,000 |
| Advanced | \$149 | \$1490 | 60 | 600,000 |
| Pro | \$475 | \$4750 | 100 | 2,000,000 |
| Business | \$949 | \$9490 | 200 | 5,000,000 |
| Enterprise | Custom | Custom | Custom | Custom |
See the [pricing page](https://cryptorank.io/public-api/pricing) for the authoritative, current figures.
## What changed from v2
**Monthly credit allowances are unchanged.** If you were on Basic, you still have 100,000/month.
**Rate limit (RPM) changed.** v2 applied a flat 100 req/min on every plan. v3 sets a per-plan RPM, from 10 (Sandbox) to 200 (Business).
The per-minute rate limit is now plan-specific. it may be lower or higher than
before.
## How the new pattern affects consumption
Because a single screen or workflow now maps to several granular calls instead of one `full-metadata` response. You pay for only the info you actually use.
Use [`GET /v3/status`](/api-reference/system/api-plan-&-usage-status) to read
your current plan, RPM, and credit usage for the active billing period. Poll
it to monitor quota and build adaptive throttling.