# Metastreams API

> Real-time and historical spot market data: tokens, OHLCV candles, trades, discovery boards and live streams.

- [Introduction](https://docs.metastreams.io/index.md): Spot market data for Solana, Base, BNB Smart Chain, Robinhood Chain and Arc: tokens, candles, trades, discovery boards and live streams.
- [Get an API key](https://docs.metastreams.io/get-started/api-keys.md): How to request a key, how evaluation and production keys differ, and how to rotate or revoke one.
- [Quickstart](https://docs.metastreams.io/get-started/quickstart.md): Make your first REST request and open your first stream in a few minutes.
- [Authentication](https://docs.metastreams.io/get-started/authentication.md): Send your key as a bearer token on every REST request and on the stream handshake.
- [Reading responses](https://docs.metastreams.io/concepts/reading-responses.md): Field names, timestamps, prices, decimals and percentages.
- [Chains](https://docs.metastreams.io/concepts/chains.md): The chain slugs the API accepts, and what each chain's native unit is.
- [Errors, limits and retries](https://docs.metastreams.io/concepts/errors.md): The shape of every error, every error code, the limits a key meets, and which errors to retry.
- [Connecting to streams](https://docs.metastreams.io/streams/overview.md): Open a WebSocket, subscribe to channels, and reconnect after a close.
- [Build a token page](https://docs.metastreams.io/recipes/token-page.md): Show a token's price, stats, holders, security and live trades, kept current by streams.
- [Render a live chart](https://docs.metastreams.io/recipes/live-chart.md): Load candle history, then keep the last candle moving with the candles stream.
- [Build a discovery board](https://docs.metastreams.io/recipes/discovery-board.md): Show new, graduating and graduated launchpad tokens in three filtered, ranked columns.
- [Overview](https://docs.metastreams.io/migrate/overview.md): Move an integration from another spot data provider to Metastreams.
- [Mobula to Metastreams](https://docs.metastreams.io/migrate/mobula.md): Map Mobula's spot endpoints, streams and token fields to their Metastreams equivalents.
- [Glossary](https://docs.metastreams.io/resources/glossary.md): What each wallet classification, holder group and launchpad term means.
- [Changelog](https://docs.metastreams.io/resources/changelog.md): Changes to the API, newest first.
- [Support](https://docs.metastreams.io/resources/support.md): How to reach us, and what to include so we can help fast.
- [Token details](https://docs.metastreams.io/reference/rest/token-details.md): Read one token's price, market cap, liquidity, trailing stats, holders, security and launch data.
- [OHLCV candles](https://docs.metastreams.io/reference/rest/token-ohlcv.md): Read one token's candle series at any timeframe, priced or by market cap.
- [Token trades](https://docs.metastreams.io/reference/rest/token-trades.md): Page through one token's executed trades, newest first, narrowed by trader or wallet classification.
- [Identity trades](https://docs.metastreams.io/reference/rest/identity-trades.md): Page through trades by notable wallets across every chain and token.
- [Discovery boards](https://docs.metastreams.io/reference/rest/discovery.md): Rank launchpad tokens by launch stage, across one or more chains, in a single request.
- [The discovery boards.](https://docs.metastreams.io/api-reference/discovery/the-discovery-boards.md): One request names the chains and the columns it wants. Each column is ranked and filtered on its own, and answers with its whole ranked set.
- [Token details.](https://docs.metastreams.io/api-reference/tokens/token-details.md): One object holding the token's identity, launch, price, market cap and liquidity. It also carries the trailing-window stats and the holder, security and metadata readings. An unknown token answers `404`.
- [OHLCV candles at one timeframe, oldest first.](https://docs.metastreams.io/api-reference/ohlcv/ohlcv-candles-at-one-timeframe-oldest-first.md): The series follows the `TradingView` contract: `countBack` asks for a bar count and supersedes `from`; `to` and `timeframe` still bind. A window with more candles than the cap keeps the newest. To read older candles, repeat the request with `to` set to the earliest `time` received.
- [Recent trades on the token, newest first, optionally narrowed to wallet classifications.](https://docs.metastreams.io/api-reference/trades/recent-trades-on-the-token-newest-first-optionally-narrowed-to-wallet-classifications.md): `flags` keeps trades whose trader carries any of the named classifications, and `trader` keeps one wallet's. Page with `cursor` until `hasMore` is false. An unknown token answers an empty page rather than `404`.
- [Recent trades by a notable identity, across every chain and token.](https://docs.metastreams.io/api-reference/trades/recent-trades-by-a-notable-identity-across-every-chain-and-token.md): `identity` names the feed: `kol` for curated wallets, `fomoscan` for wallets resolved to a fomo.family identity. `chains` narrows the scope, and every spot chain is read when it is absent. Page with `cursor` until `hasMore` is false.
- [spot.trades](https://docs.metastreams.io/reference/streams/spot-trades.md): Every trade on a token, by a wallet, or by a notable identity, as it happens.
- [spot.candles](https://docs.metastreams.io/reference/streams/spot-candles.md): One token's candles at one timeframe, metric and denomination, as they form.
- [spot.tokens](https://docs.metastreams.io/reference/streams/spot-tokens.md): The full token object, every time it changes.

## OpenAPI Specs

- [openapi](/specs/openapi.json)

## AsyncAPI Specs

- [asyncapi](/specs/asyncapi.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.