# CoinStats PublicAPI

- [On-Demand Crypto Data via x402](https://coinstats.app/api-docs/ai-agents/x402.md): Pay-per-request access to CoinStats market data, wallet balances, news, and portfolio reads — no API key required. Built on Coinbase's x402 open payment protocol.
- [API Reference](https://coinstats.app/api-docs/api-reference/introduction.md): Every CoinStats API endpoint, grouped by what it does. Base URL, authentication, and where to find each section.
- [Authentication](https://coinstats.app/api-docs/authentication.md): Learn how to authenticate with the CoinStats API
- [Changelog](https://coinstats.app/api-docs/changelog.md): Product updates and announcements
- [ConnectKit Tutorial](https://coinstats.app/api-docs/connectkit.md): Create a ConnectKit flow and open the hosted CoinStats connection popup from your app.
- [Errors](https://coinstats.app/api-docs/errors.md): Common error responses and troubleshooting
- [CoinStats Crypto API](https://coinstats.app/api-docs/index.md): Best free crypto API for prices, wallet data, and DeFi. 120+ blockchains, 200+ exchanges, 10,000+ DeFi protocols, and MCP server.
- [Connect to CoinStats MCP](https://coinstats.app/api-docs/mcp/connecting.md): Hook AI agents into your CoinStats account through the Model Context Protocol — coin prices, portfolios, wallets, exchanges and news on tap.
- [MCP Tools for Crypto Data](https://coinstats.app/api-docs/mcp/tools.md): The best MCP server for crypto. 20+ tools for real-time prices, wallet balances, DeFi positions, exchange data, news, and portfolios.
- [Credit Multipliers](https://coinstats.app/api-docs/multipliers.md): Understanding how API credit multipliers work with dynamic pricing
- [Add Portfolio Transaction](https://coinstats.app/api-docs/openapi/add-portfolio-transaction.md): Add a new transaction to your manual portfolio
- [Analytics Market Signals](https://coinstats.app/api-docs/openapi/analytics-market-signals.md): Composite whale + smart-money signals (top 50 active markets)
- [Analytics Overview](https://coinstats.app/api-docs/openapi/analytics-overview.md): Platform overview stats
- [Btc Dominance](https://coinstats.app/api-docs/openapi/btc-dominance.md): Get Bitcoin market dominance data showing BTC's percentage share of the total cryptocurrency market capitalization over a specified time period
- [Connect Portfolio Exchange](https://coinstats.app/api-docs/openapi/connect-portfolio-exchange.md): Connect an exchange account to your account and create a tracked portfolio
- [Connect Portfolio Wallet](https://coinstats.app/api-docs/openapi/connect-portfolio-wallet.md): Connect a wallet to your account and create a tracked portfolio
- [Delete Portfolio](https://coinstats.app/api-docs/openapi/delete-portfolio.md): Delete Portfolio
- [Event Cross Venue](https://coinstats.app/api-docs/openapi/event-cross-venue.md): Matched markets on the other venue (Kalshi <-> Polymarket)
- [Exchange Sync Status](https://coinstats.app/api-docs/openapi/exchange-sync-status.md): Initiate syncing process for the given exchange portfolio by portfolioId.
- [Fear And Greed](https://coinstats.app/api-docs/openapi/fear-and-greed.md): Get the Crypto Fear & Greed Index
- [Fear And Greed Chart](https://coinstats.app/api-docs/openapi/fear-and-greed-chart.md): Get historical data for the Crypto Fear & Greed Index
- [Get Api Status](https://coinstats.app/api-docs/openapi/get-api-status.md): Get API status
- [Get Blockchains](https://coinstats.app/api-docs/openapi/get-blockchains.md): Get the list of blockchains supported by CoinStats
- [Get Coin Avg Price](https://coinstats.app/api-docs/openapi/get-coin-avg-price.md): Get the historical average price of a specific cryptocurrency for a given date.
- [Get Coin By Id](https://coinstats.app/api-docs/openapi/get-coin-by-id.md): Get detailed information about a specific cryptocurrency using coinId.
- [Get Coin Chart By Id](https://coinstats.app/api-docs/openapi/get-coin-chart-by-id.md): Get historical chart data for a specific cryptocurrency using coinId.
- [Get Coin Exchange Price](https://coinstats.app/api-docs/openapi/get-coin-exchange-price.md): Get historical price data for a specific cryptocurrency on a selected exchange.
- [Get Coins](https://coinstats.app/api-docs/openapi/get-coins.md): Get comprehensive data about all cryptocurrencies
- [Get Coins Charts](https://coinstats.app/api-docs/openapi/get-coins-charts.md): Get historical chart data for multiple cryptocurrencies
- [Get Credit Usage](https://coinstats.app/api-docs/openapi/get-credit-usage.md): Get your current credit usage and remaining limit
- [Get Currencies](https://coinstats.app/api-docs/openapi/get-currencies.md): Get the complete list of supported fiat currencies
- [Get Event](https://coinstats.app/api-docs/openapi/get-event.md): Get an event with its child markets
- [Get Exchange Balance](https://coinstats.app/api-docs/openapi/get-exchange-balance.md): Get your cryptocurrency exchange balances
- [Get Exchange Chart](https://coinstats.app/api-docs/openapi/get-exchange-chart.md): Get exchange chart data for specific time ranges displayed on the CoinStats website.
- [Get Exchange PnL](https://coinstats.app/api-docs/openapi/get-exchange-pl.md): Get exchange PnL holdings data
- [Get Exchange PnL History](https://coinstats.app/api-docs/openapi/get-exchange-pl-history.md): Get a cash-flow-adjusted historical exchange P&L chart
- [Get Exchange Sync Status](https://coinstats.app/api-docs/openapi/get-exchange-sync-status.md): Get syncing status of the exchange portfolio, indicating whether the portfolio is fully synced with the exchange or still in progress.
- [Get Exchange Transaction Types](https://coinstats.app/api-docs/openapi/get-exchange-transaction-types.md): Get all supported transaction types
- [Get Exchange Transactions](https://coinstats.app/api-docs/openapi/get-exchange-transactions.md): Get transaction data for a specific exchange by portfolioId.
- [Get Exchanges](https://coinstats.app/api-docs/openapi/get-exchanges.md): Get the list of exchange portfolio connections supported by CoinStats.
- [Get Fiat Currencies](https://coinstats.app/api-docs/openapi/get-fiat-currencies.md): Get detailed information about fiat currencies
- [Get Market](https://coinstats.app/api-docs/openapi/get-market.md): Get a prediction market by slug
- [Get Market Cap](https://coinstats.app/api-docs/openapi/get-market-cap.md): Get current global cryptocurrency market data
- [Get News](https://coinstats.app/api-docs/openapi/get-news.md): Get the list of cryptocurrency news articles with pagination.
- [Get News By Id](https://coinstats.app/api-docs/openapi/get-news-by-id.md): Get a news article by id.
- [Get News By Type](https://coinstats.app/api-docs/openapi/get-news-by-type.md): Get cryptocurrency news articles based on a specific type.
- [Get News Sources](https://coinstats.app/api-docs/openapi/get-news-sources.md): Get the list of news sources.
- [Get NFT Collection Asset By Token ID](https://coinstats.app/api-docs/openapi/get-nft-collection-asset-by-tokenid.md): Get detailed information about a specific NFT asset.
- [Get NFT Collection Assets By Address](https://coinstats.app/api-docs/openapi/get-nft-collection-assets-by-address.md): Get the list of NFT assets associated with NFT Collection by collectionAddress.
- [Get NFT Collection By Address](https://coinstats.app/api-docs/openapi/get-nft-collection-by-address.md): Get detailed information about an NFT collection using collectionAddress.
- [Get NFT Collection Owners](https://coinstats.app/api-docs/openapi/get-nft-collection-owners.md): Get the holders of an NFT collection, largest first.
- [Get NFT Tokens Batch](https://coinstats.app/api-docs/openapi/get-nft-tokens-batch.md): Get up to 100 NFTs across chains in one request.
- [Get Ohlcv Candles](https://coinstats.app/api-docs/openapi/get-ohlcv-candles.md): Get historical OHLCV candles for an exchange market
- [Get Perpetual Positions](https://coinstats.app/api-docs/openapi/get-perpetual-positions.md): Get open perpetual and futures positions
- [Get Perpetual Trades](https://coinstats.app/api-docs/openapi/get-perpetual-trades.md): Get perpetual trade history
- [Get Portfolio Chart](https://coinstats.app/api-docs/openapi/get-portfolio-chart.md): Get historical performance data to visualize your portfolio's growth over time
- [Get Portfolio Coins](https://coinstats.app/api-docs/openapi/get-portfolio-coins.md): Get detailed information about all coins in your portfolio
- [Get Portfolio Defi](https://coinstats.app/api-docs/openapi/get-portfolio-defi.md): Retrieve comprehensive DeFi portfolio data, including staking, liquidity pool (LP), and yield farming activities
- [Get Portfolio List](https://coinstats.app/api-docs/openapi/get-portfolio-list.md): Get a list of your own portfolios
- [Get Portfolio PnL History](https://coinstats.app/api-docs/openapi/get-portfolio-pl-history.md): Get a cash-flow-adjusted historical portfolio P&L chart
- [Get Portfolio Snapshot Items](https://coinstats.app/api-docs/openapi/get-portfolio-snapshot-items.md): Get historical portfolio snapshot data with normalized coin balances and portfolio metrics
- [Get Portfolio Sync Status](https://coinstats.app/api-docs/openapi/get-portfolio-sync-status.md): Get Portfolio Sync Status
- [Get Portfolio Transaction Types](https://coinstats.app/api-docs/openapi/get-portfolio-transaction-types.md): Get all supported transaction types
- [Get Portfolio Transactions](https://coinstats.app/api-docs/openapi/get-portfolio-transactions.md): Get a detailed history of all transactions in your portfolio
- [Get Portfolio Value](https://coinstats.app/api-docs/openapi/get-portfolio-value.md): Get detailed information about portfolio profit/loss
- [Get Rwa Asset](https://coinstats.app/api-docs/openapi/get-rwa-asset.md): Get a real-world asset and its section availability
- [Get Rwa Asset History](https://coinstats.app/api-docs/openapi/get-rwa-asset-history.md): Get price, market cap, or volume history for a real-world asset
- [Get Rwa Assets](https://coinstats.app/api-docs/openapi/get-rwa-assets.md): List tokenized real-world assets
- [Get Rwa History](https://coinstats.app/api-docs/openapi/get-rwa-history.md): Get aggregate RWA market history
- [Get Rwa Markets](https://coinstats.app/api-docs/openapi/get-rwa-markets.md): List trading markets for a real-world asset
- [Get Rwa Overview](https://coinstats.app/api-docs/openapi/get-rwa-overview.md): Get the real-world asset market overview
- [Get Rwa Tokens](https://coinstats.app/api-docs/openapi/get-rwa-tokens.md): List tokens representing a real-world asset
- [Get Ticker Exchanges](https://coinstats.app/api-docs/openapi/get-ticker-exchanges.md): Provides a comprehensive list of cryptocurrency exchanges supported by CoinStats.
- [Get Ticker Markets](https://coinstats.app/api-docs/openapi/get-ticker-markets.md): Returns a list of tickers for a specific cryptocurrency across multiple exchanges.
- [Get Trader](https://coinstats.app/api-docs/openapi/get-trader.md): Trader profile (enriched with live PnL, cash balance, rank)
- [Get Trending NFTs](https://coinstats.app/api-docs/openapi/get-trending-nfts.md): Get the most popular NFT collections right now
- [Get Wallet Balance](https://coinstats.app/api-docs/openapi/get-wallet-balance.md): Get cryptocurrency balances for any blockchain wallet
- [Get Wallet Balance Many](https://coinstats.app/api-docs/openapi/get-wallet-balance-many.md): Get cryptocurrency balances for multiple wallets
- [Get Wallet Defi](https://coinstats.app/api-docs/openapi/get-wallet-defi.md): Retrieve comprehensive DeFi portfolio data, including staking, liquidity pool (LP), and yield farming activities
- [Get Wallet NFT Activity](https://coinstats.app/api-docs/openapi/get-wallet-nft-activity.md): Get NFT mints, receives, sends and burns of a wallet.
- [Get Wallet NFT Collections](https://coinstats.app/api-docs/openapi/get-wallet-nft-collections.md): Get the NFT collections a wallet holds, one row per collection, on one chain or across chains.
- [Get Wallet NFT Holds](https://coinstats.app/api-docs/openapi/get-wallet-nft-holds.md): Check whether a wallet holds NFTs from given collections.
- [Get Wallet NFT Summary](https://coinstats.app/api-docs/openapi/get-wallet-nft-summary.md): Get the total floor value of a wallet's NFTs per chain.
- [Get Wallet NFTs](https://coinstats.app/api-docs/openapi/get-wallet-nfts.md): Get every NFT a wallet holds as individual tokens, across all chains in one call.
- [get wallet profit & loss](https://coinstats.app/api-docs/openapi/get-wallet-pl.md): get wallet profit & loss
- [Get Wallet PnL History](https://coinstats.app/api-docs/openapi/get-wallet-pl-history.md): Get a cash-flow-adjusted historical wallet P&L chart
- [Get Wallet Sync Status](https://coinstats.app/api-docs/openapi/get-wallet-sync-status.md): Get the syncing status of the provided wallet address with the blockchain network.
- [Get Wallet Transaction Types](https://coinstats.app/api-docs/openapi/get-wallet-transaction-types.md): Get all supported transaction types
- [Get Wallet Transactions](https://coinstats.app/api-docs/openapi/get-wallet-transactions.md): Get transaction data for wallet addresses
- [List Events](https://coinstats.app/api-docs/openapi/list-events.md): List prediction-market events
- [List Markets](https://coinstats.app/api-docs/openapi/list-markets.md): List prediction markets
- [List Traders](https://coinstats.app/api-docs/openapi/list-traders.md): Trader leaderboard
- [Market Bars](https://coinstats.app/api-docs/openapi/market-bars.md): OHLC candles for the yes outcome
- [Market Cross Venue](https://coinstats.app/api-docs/openapi/market-cross-venue.md): Matched market on the other venue (Kalshi <-> Polymarket)
- [Market Orderbook](https://coinstats.app/api-docs/openapi/market-orderbook.md): Full CLOB order-book depth for both outcomes
- [Market Price At](https://coinstats.app/api-docs/openapi/market-price-at.md): Yes price as of a point in time
- [Market Price History](https://coinstats.app/api-docs/openapi/market-price-history.md): Yes-price time series for a market
- [Market Prices](https://coinstats.app/api-docs/openapi/market-prices.md): Current prices (live from the CLOB order book)
- [Rainbow Chart](https://coinstats.app/api-docs/openapi/rainbow-chart.md): Get Rainbow Chart data
- [Refresh NFT Asset Metadata](https://coinstats.app/api-docs/openapi/refresh-nft-asset-metadata.md): Re-read an NFT's metadata from its token URI.
- [Search](https://coinstats.app/api-docs/openapi/search.md): Search events, markets, and traders
- [Sync Portfolio](https://coinstats.app/api-docs/openapi/sync-portfolio.md): Sync Portfolio
- [Token Risks](https://coinstats.app/api-docs/openapi/token-risks.md): Get smart-contract risk analysis for a token (honeypot, mint/blacklist authority, hidden fees, upgradeable proxy, and more) — powered by Hexens
- [Top Traders](https://coinstats.app/api-docs/openapi/top-traders.md): Top traders (tier <= 2)
- [Trader Activity](https://coinstats.app/api-docs/openapi/trader-activity.md): On-chain activity feed
- [Trader Category Stats](https://coinstats.app/api-docs/openapi/trader-category-stats.md): Per-category analytics + best/worst positions
- [Trader Pnl History](https://coinstats.app/api-docs/openapi/trader-pnl-history.md): Daily cumulative-PnL series
- [Trader Positions](https://coinstats.app/api-docs/openapi/trader-positions.md): Open positions
- [Trader Score](https://coinstats.app/api-docs/openapi/trader-score.md): Composite trader score
- [Trader Trade Stats](https://coinstats.app/api-docs/openapi/trader-trade-stats.md): Aggregate trade statistics
- [Trader Trades](https://coinstats.app/api-docs/openapi/trader-trades.md): Trade history (newest first)
- [Transactions Sync](https://coinstats.app/api-docs/openapi/transactions-sync.md): Initiate syncing process to update transaction data.
- [Trending Events](https://coinstats.app/api-docs/openapi/trending-events.md): Trending events
- [Trending Markets](https://coinstats.app/api-docs/openapi/trending-markets.md): Trending prediction markets (top by 24h volume)
- [Wallet Chart](https://coinstats.app/api-docs/openapi/wallet-chart.md): Get wallet chart data for specific time ranges
- [Wallet Chart Many](https://coinstats.app/api-docs/openapi/wallet-chart-many.md): Get chart data for multiple wallet addresses across various networks.
- [Perpetuals](https://coinstats.app/api-docs/perpetuals.md): Open positions and trade history for connected exchanges, including Hyperliquid.
- [Get Portfolio Chart](https://coinstats.app/api-docs/portfolio/portfolio-chart.md): Get historical portfolio performance data for visualizing value changes over time
- [Get Portfolio Coins](https://coinstats.app/api-docs/portfolio/portfolio-coins.md): Get detailed information about all coins in your portfolio with profit/loss data and performance metrics
- [Markets & Events](https://coinstats.app/api-docs/prediction/markets-and-events.md): List, filter, price, and cross-match Polymarket, Kalshi and Polymarket US markets and events.
- [Prediction Markets](https://coinstats.app/api-docs/prediction/overview.md): Read-only analytics for Polymarket, Kalshi and Polymarket US prediction markets — markets, events, cross-venue matching, traders, per-trader PnL, search, and platform analytics. One API key, one integration.
- [Traders & Analytics](https://coinstats.app/api-docs/prediction/traders-and-analytics.md): Trader leaderboards and deep per-trader analytics — positions, PnL, category stats, score — plus platform-wide market signals.
- [Rate Limits](https://coinstats.app/api-docs/rate-limits.md): Understanding the credit-based rate limiting system
- [Real-world assets](https://coinstats.app/api-docs/rwa.md): Tokenized stocks, commodities, and ETFs: overview, asset data, tokens, trading markets, and history.
- [Share Token Authentication](https://coinstats.app/api-docs/sharetoken.md): Learn how to use share tokens to access portfolio data through the CoinStats API
- [Token Security](https://coinstats.app/api-docs/token-risks.md): Token security API for any token — honeypot, mint/blacklist, hidden-fee and upgradeable-proxy detection. Powered by Hexens. Risk score plus severity-ranked findings.
- [Bitcoin Wallet API with xpub Support](https://coinstats.app/api-docs/wallet/bitcoin.md): The best free Bitcoin wallet API with xpub/ypub/zpub support. Track balances, transactions, derived addresses, and portfolio performance.
- [Ethereum API & EVM Wallet Balances](https://coinstats.app/api-docs/wallet/ethereum-evm.md): The best free Ethereum API with EVM wallet tracking. Balances, transactions, DeFi, and gas data for Polygon, Arbitrum, Base, and more.
- [Multi-Chain Crypto Wallet API](https://coinstats.app/api-docs/wallet/other-chains.md): The best crypto wallet API for 120+ blockchains: Cardano, Tron, Litecoin, Cosmos, and Layer 2 networks. One integration for all chains.
- [Solana API: Wallet Balances & Transactions](https://coinstats.app/api-docs/wallet/solana.md): The best free Solana API for wallet balances, SPL token holdings, and complete transaction history. DeFi position tracking included.

## OpenAPI Specs

- [openapi](/api-docs/api-reference/openapi.json)

## Optional

- [Api Keys](https://openapi.coinstats.app)
- [CoinStats](https://coinstats.app)
- [Telegram API Support](https://t.me/+JPUMD1QAMTNmNGQy)
- [X](https://x.com/coinstats)


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