# serialized.data ## Docs - [Serialized Data API](https://docs.serialized.xyz/introduction.md): On-chain data for trading apps - tokens, candles, token filters. Built on our own indexers. 18 EVM chains + Solana, live. - [Authentication](https://docs.serialized.xyz/authentication.md): API keys and rate limits - [Conventions](https://docs.serialized.xyz/conventions.md): The contract every endpoint follows - [Errors](https://docs.serialized.xyz/errors.md): Machine-readable error contract - [Migrate from another provider](https://docs.serialized.xyz/migrate.md): Endpoint-by-endpoint mappings from Mobula, Codex and Birdeye, REST and streams - [Token Details](https://docs.serialized.xyz/endpoints/token-details.md): Full token snapshot: price (native + USD), market cap & FDV (sanity-capped), liquidity (+ATH), best pool (canonical priority ranking), launchpad state (bonding progress, graduation), deployer, 24h stats, metadata & socials. - [Token Details: batch](https://docs.serialized.xyz/endpoints/token-details-batch.md): Full-detail batch twin: up to 25 `{chain, address}` items (EVM and Solana can be mixed in one call), response array in input order with per-item `{error}` slots. Billed per item. - [Token Price](https://docs.serialized.xyz/endpoints/token-price-lean.md): Cheap price tier for bots and tickers: price, market cap, liquidity. Nothing else. - [Token Price: batch](https://docs.serialized.xyz/endpoints/token-price-batch.md): Batch twin - up to 100 tokens in one call, one SQL round-trip. Response in input order; missing tokens come back as per-item `{error}` slots. - [Token Stats](https://docs.serialized.xyz/endpoints/token-stats-windowed.md): Windowed volume, buy/sell counts and volumes, price change - 5m/1h/6h/24h in one call. - [Token Metadata](https://docs.serialized.xyz/endpoints/token-metadata.md): Socials, description, images, dex-paid status. POST twin on the same path for batches (≤100, billed per item). - [Token Holders](https://docs.serialized.xyz/endpoints/token-holders.md): Top holders with position size, share of supply, full PnL (realized + unrealized), buy/sell volumes, behavioral labels and named entities (exchanges, funds - the "Coinbase" signal). EVM and Solana. - [Token Security](https://docs.serialized.xyz/endpoints/token-security.md): Mint & freeze authority state for Solana tokens - the rug-risk primitives. Tri-state, never faked: `mintRevoked`/`freezeRevoked` true = revoked (safe), false = AUTHORITY ACTIVE (token is mintable/freezable - the risk signal), null = not yet observed (treat as unknown, NOT safe). Live tokens are cove… - [Token Security: batch](https://docs.serialized.xyz/endpoints/token-security-batch.md): Mint & freeze authority state for Solana tokens - the rug-risk primitives. Tri-state, never faked: `mintRevoked`/`freezeRevoked` true = revoked (safe), false = AUTHORITY ACTIVE (token is mintable/freezable - the risk signal), null = not yet observed (treat as unknown, NOT safe). Live tokens are cove… - [Token Audit](https://docs.serialized.xyz/endpoints/token-audit.md): Full smart-contract security audit of a token, by our sister product **Serialized Audit**: submit a contract, get a safety verdict (`isSafe`), a human-readable summary and the detected vulnerabilities (honeypots, hidden mint, owner privileges, proxy tricks). Verified source is audited directly; clos… - [Wallet Positions](https://docs.serialized.xyz/endpoints/wallet-positions.md): Every position of a wallet with entry price and PnL: amount held, USD value, average entry, realized + unrealized + total PnL, trade counts and first/last trade timestamps. EVM and Solana. - [Wallet Trades](https://docs.serialized.xyz/endpoints/wallet-trades.md): Trade history of a wallet, newest first - multihop-deduplicated (one event per transaction, token and side; never doubled volumes). Keyset pagination on EVM via `beforeAt` (strictly older than the cursor, `meta.oldestAt` feeds the next page). - [Wallet PnL](https://docs.serialized.xyz/endpoints/wallet-pnl.md): Realized PnL of a wallet: daily curve plus summary (total realized, win rate, trades, wins/losses). Omit `chain` to combine every EVM chain; `chain=solana` for Solana. - [Wallet Profile](https://docs.serialized.xyz/endpoints/wallet-profile.md): Who is behind an address: display name, avatar, ENS / Basename / .sol, bio, social accounts (Twitter, Farcaster, GitHub…), follower counts, sources, pro-trader flag - plus `linkedWallets`, other addresses of the same person (cross-wallet identity clusters). Built on our identity graph of 7.6M+ label… - [Wallet Profile: batch](https://docs.serialized.xyz/endpoints/wallet-profile-batch.md): Batch twin: up to 100 addresses per call, response array in input order, `null` slots for wallets without a known identity (identities are harvested continuously - retry later, never assume permanent). - [Wallet Funding](https://docs.serialized.xyz/endpoints/wallet-funding.md): Where a wallet got its first funds: the earliest native transfer that funded it - funder address, timestamp, transaction and amount, with an entity tag (exchange, bridge…) when the funder is known. The primitive behind insider and sybil heuristics. - [Token Pools](https://docs.serialized.xyz/endpoints/token-pools.md): Every market of a token, ranked by our canonical pool priority - rank 1 is the exact pool the token endpoint prices from. - [Candles (OHLCV)](https://docs.serialized.xyz/endpoints/candles-ohlcv.md): Chart-ready candles from 1s to 1d, multi-pool aggregation (≤50 pools), wick-outlier clamping and candle connecting included. On Base, the forming candle includes preconfirmed (flashblocks) swaps ~2.5s before block commit. - [Trades Tape](https://docs.serialized.xyz/endpoints/trades-tape.md): Real-time trade tape. `maker` is the REAL trader (relay/solver-resolved), with isProTrader/isSniper badges on every row. On Base, preconfirmed (flashblocks) trades appear ~2.5s before block commit, flagged per row. Filters: tradeType, USD/native/token amount ranges, date range, makers (POST twin, ≤2… - [Sparklines](https://docs.serialized.xyz/endpoints/sparklines-batch.md): Small native-price arrays for list rows - one call for up to 100 pools. Timeframes 1m|5m|30m|1h|24h|7d. Missing pools return [] - we never invent data. - [Native Prices](https://docs.serialized.xyz/endpoints/native-prices.md): Live USD prices of every chain's native coin, with per-symbol freshness (`updatedAt`, `stale`) - you always know how fresh a price is. - [Chains](https://docs.serialized.xyz/endpoints/chains.md): Supported chains with status. Free. - [Token Search](https://docs.serialized.xyz/endpoints/token-search.md): Low-latency token search: exact address (EVM hex, Solana base58, pool addresses) or free-text name/symbol (trigram). Covers BOTH families: `chain=solana` or `chain=evm:` restricts; no chain searches EVM and Solana in parallel and merges by USD liquidity. Results carry price, liquidity, market ca… - [Token Filters](https://docs.serialized.xyz/endpoints/pulse.md): Axiom-style launchpad lifecycle columns: `new` (created under 24h), `bonding` (active curves, sorted by bonding %), `graduated` (migrated or virtually-graduated, last 7 days). ~90 launchpads tracked natively across 18 EVM chains, bonding thresholds per factory. - [Streams overview](https://docs.serialized.xyz/streams/overview.md): Real-time push over a single WebSocket connection: live trades, candles, token updates and token filter views. Event payloads reuse the exact same shapes as their REST twins - anything you built against REST parses stream events unchanged. - [Trades Stream](https://docs.serialized.xyz/streams/trades-stream.md): Every new trade for a token - all pools by default, or a pool subset - pushed as it lands. Events are the exact REST trades-tape shape, one event per trade. - [Live Candles](https://docs.serialized.xyz/streams/live-candles-ohlcv.md): The current candle of a token, re-pushed on every trade - same candle shape as REST `/v1/token/ohlcv` (`time` in unix seconds, TradingView-style), plus `tradeAt` (ms of the last folded trade). When a bucket rolls over, the first event of the new bucket closes the previous one. - [Token Updates Stream](https://docs.serialized.xyz/streams/token-updates-stream.md): Live refresh of the mutable Token Details fields - price, market cap, liquidity, bonding progress, 24h stats. Throttled to at most one event per second per token; fields you already parse from `/v1/token`. - [Token Filters Stream](https://docs.serialized.xyz/streams/pulse-stream-view.md): A live token filter view: the server maintains the filtered, sorted launchpad view and pushes it - a full `snapshot` on subscribe, then `enter`/`update`/`leave` deltas as tokens move through the lifecycle. Cards are the exact REST `/v1/pulse` shape. ## Optional - [Serialized Audit](https://docs.serializedaudit.io)