# Surf API Documentation ## Docs - [POST /v1/chat/completions](https://docs.asksurf.ai/chat-completions.md): OpenAI-compatible Chat Completions API (with field-level annotations and streaming SSE details) - [AI Prompts](https://docs.asksurf.ai/cli/ai-prompts.md): Pre-built prompts to integrate Surf into your AI coding workflow — Claude Code, Cursor, Copilot, Codex, and more - [CLI](https://docs.asksurf.ai/cli/cli.md): Install, authenticate, and use the Surf CLI - [Introduction](https://docs.asksurf.ai/cli/introduction.md): Introduction to Surf Skills and CLI - [MCP Server](https://docs.asksurf.ai/cli/mcp.md): Connect any MCP-compatible AI client to Surf's crypto data API — 12 tools, 86 endpoints, zero code - [Skills](https://docs.asksurf.ai/cli/skills.md): Agent skills that teach AI coding agents how to use the Surf CLI - [Use Cases](https://docs.asksurf.ai/cli/use-cases-and-positioning.md): Common use cases for Surf Skills and CLI - [Order Book Depth](https://docs.asksurf.ai/data-api/exchange/depth.md) - [Funding Rate History](https://docs.asksurf.ai/data-api/exchange/funding-history.md) - [OHLCV Candlesticks](https://docs.asksurf.ai/data-api/exchange/klines.md) - [Long/Short Ratio History](https://docs.asksurf.ai/data-api/exchange/long-short-ratio.md) - [Trading Pairs](https://docs.asksurf.ai/data-api/exchange/markets.md) - [Perpetual Contract Snapshot](https://docs.asksurf.ai/data-api/exchange/perp.md) - [Ticker Price](https://docs.asksurf.ai/data-api/exchange/price.md) - [Fund Profile](https://docs.asksurf.ai/data-api/fund/detail.md) - [Fund Portfolio](https://docs.asksurf.ai/data-api/fund/portfolio.md) - [Fund Ranking](https://docs.asksurf.ai/data-api/fund/ranking.md) - [ETF Flow History](https://docs.asksurf.ai/data-api/market/etf.md) - [Fear & Greed Index](https://docs.asksurf.ai/data-api/market/fear-greed.md) - [Futures Market Overview](https://docs.asksurf.ai/data-api/market/futures.md) - [Liquidation Chart](https://docs.asksurf.ai/data-api/market/liquidation-chart.md) - [Liquidation by Exchange](https://docs.asksurf.ai/data-api/market/liquidation-exchange-list.md) - [Large Liquidation Orders](https://docs.asksurf.ai/data-api/market/liquidation-order.md) - [On-Chain Indicator](https://docs.asksurf.ai/data-api/market/onchain-indicator.md) - [Options Market Data](https://docs.asksurf.ai/data-api/market/options.md) - [Token Price History](https://docs.asksurf.ai/data-api/market/price.md) - [Technical Indicator](https://docs.asksurf.ai/data-api/market/price-indicator.md) - [Token Rankings](https://docs.asksurf.ai/data-api/market/ranking.md) - [News Article Detail](https://docs.asksurf.ai/data-api/news/detail.md) - [News Feed](https://docs.asksurf.ai/data-api/news/feed.md) - [Bridge Protocol Ranking](https://docs.asksurf.ai/data-api/onchain/bridge-ranking.md) - [Current Gas Price](https://docs.asksurf.ai/data-api/onchain/gas-price.md) - [Structured Query](https://docs.asksurf.ai/data-api/onchain/query.md) - [Table Schema](https://docs.asksurf.ai/data-api/onchain/schema.md) - [SQL Query](https://docs.asksurf.ai/data-api/onchain/sql.md) - [Transaction Details](https://docs.asksurf.ai/data-api/onchain/tx.md) - [Yield Pool Ranking](https://docs.asksurf.ai/data-api/onchain/yield-ranking.md) - [Data API Overview](https://docs.asksurf.ai/data-api/overview.md): Surf Data API — crypto market data, on-chain analytics, social signals, and more - [Category Metrics](https://docs.asksurf.ai/data-api/prediction-market/category-metrics.md) - [Kalshi Events](https://docs.asksurf.ai/data-api/prediction-market/kalshi-events.md) - [Kalshi Markets](https://docs.asksurf.ai/data-api/prediction-market/kalshi-markets.md) - [Kalshi Open Interest](https://docs.asksurf.ai/data-api/prediction-market/kalshi-open-interest.md) - [Kalshi Price History](https://docs.asksurf.ai/data-api/prediction-market/kalshi-prices.md) - [Kalshi Ranking](https://docs.asksurf.ai/data-api/prediction-market/kalshi-ranking.md) - [Kalshi Trades](https://docs.asksurf.ai/data-api/prediction-market/kalshi-trades.md) - [Kalshi Volume History](https://docs.asksurf.ai/data-api/prediction-market/kalshi-volumes.md) - [Polymarket Wallet Activity](https://docs.asksurf.ai/data-api/prediction-market/polymarket-activity.md) - [Polymarket Events](https://docs.asksurf.ai/data-api/prediction-market/polymarket-events.md) - [Polymarket Markets](https://docs.asksurf.ai/data-api/prediction-market/polymarket-markets.md) - [Polymarket Open Interest](https://docs.asksurf.ai/data-api/prediction-market/polymarket-open-interest.md) - [Polymarket Positions](https://docs.asksurf.ai/data-api/prediction-market/polymarket-positions.md) - [Polymarket Price History](https://docs.asksurf.ai/data-api/prediction-market/polymarket-prices.md) - [Polymarket Ranking](https://docs.asksurf.ai/data-api/prediction-market/polymarket-ranking.md) - [Polymarket Trades](https://docs.asksurf.ai/data-api/prediction-market/polymarket-trades.md) - [Polymarket Volume History](https://docs.asksurf.ai/data-api/prediction-market/polymarket-volumes.md) - [DeFi Metrics](https://docs.asksurf.ai/data-api/project/defi-metrics.md) - [DeFi Protocol Ranking](https://docs.asksurf.ai/data-api/project/defi-ranking.md) - [Project Detail](https://docs.asksurf.ai/data-api/project/detail.md) - [Airdrop Search](https://docs.asksurf.ai/data-api/search/airdrop.md) - [Project Event Search](https://docs.asksurf.ai/data-api/search/events.md) - [Fund Search](https://docs.asksurf.ai/data-api/search/fund.md) - [Kalshi Event Search](https://docs.asksurf.ai/data-api/search/kalshi.md) - [News Search](https://docs.asksurf.ai/data-api/search/news.md) - [Polymarket Event Search](https://docs.asksurf.ai/data-api/search/polymarket.md) - [Project Search](https://docs.asksurf.ai/data-api/search/project.md) - [Social User Search](https://docs.asksurf.ai/data-api/search/social-people.md) - [Social Post Search](https://docs.asksurf.ai/data-api/search/social-posts.md) - [Wallet Search](https://docs.asksurf.ai/data-api/search/wallet.md) - [Web Search](https://docs.asksurf.ai/data-api/search/web.md) - [Social Analytics](https://docs.asksurf.ai/data-api/social/detail.md) - [Project Mindshare](https://docs.asksurf.ai/data-api/social/mindshare.md) - [Mindshare Ranking](https://docs.asksurf.ai/data-api/social/ranking.md) - [Smart Follower History](https://docs.asksurf.ai/data-api/social/smart-followers-history.md) - [Tweet Replies](https://docs.asksurf.ai/data-api/social/tweet-replies.md) - [Social Posts by IDs](https://docs.asksurf.ai/data-api/social/tweets.md) - [Social User Profile](https://docs.asksurf.ai/data-api/social/user.md) - [User Followers](https://docs.asksurf.ai/data-api/social/user-followers.md) - [User Following](https://docs.asksurf.ai/data-api/social/user-following.md) - [User Posts](https://docs.asksurf.ai/data-api/social/user-posts.md) - [User Replies](https://docs.asksurf.ai/data-api/social/user-replies.md) - [DEX Trade History](https://docs.asksurf.ai/data-api/token/dex-trades.md) - [Token Holders](https://docs.asksurf.ai/data-api/token/holders.md) - [Token Unlock Schedule](https://docs.asksurf.ai/data-api/token/tokenomics.md) - [Token Transfer History](https://docs.asksurf.ai/data-api/token/transfers.md) - [Wallet Detail](https://docs.asksurf.ai/data-api/wallet/detail.md) - [Transaction History](https://docs.asksurf.ai/data-api/wallet/history.md) - [Wallet Labels (Batch)](https://docs.asksurf.ai/data-api/wallet/labels-batch.md) - [Net Worth History](https://docs.asksurf.ai/data-api/wallet/net-worth.md) - [DeFi Protocol Positions](https://docs.asksurf.ai/data-api/wallet/protocols.md) - [Wallet Transfers](https://docs.asksurf.ai/data-api/wallet/transfers.md) - [Web Page Fetch](https://docs.asksurf.ai/data-api/web/fetch.md) - [Bridges](https://docs.asksurf.ai/data-catalog/bridges.md): Cross-chain bridge volume aggregated daily. - [Chain Metrics](https://docs.asksurf.ai/data-catalog/chain-metrics.md): Daily chain-level aggregates including transaction counts, active addresses, gas usage, and contract deployments. - [Common Patterns](https://docs.asksurf.ai/data-catalog/common-patterns.md): Practical SQL query patterns for the most frequent on-chain data analysis tasks. - [Curated Analytics](https://docs.asksurf.ai/data-catalog/curated-analytics.md): Dashboard-ready pre-computed analytics — whale trades, hot markets, leaderboards, and daily reports. - [DEX Trades](https://docs.asksurf.ai/data-catalog/dex-trades.md): Enriched swap events across 6 chains with token symbols, USD amounts, and protocol attribution. - [Hyperliquid](https://docs.asksurf.ai/data-catalog/hyperliquid.md): Perpetual futures market data, funding rates, and contract metadata from Hyperliquid L1. - [Lending & Staking](https://docs.asksurf.ai/data-catalog/lending-staking.md): Protocol-level daily activity aggregates for lending and staking protocols. - [Data Catalog](https://docs.asksurf.ai/data-catalog/overview.md): 58 analyst-ready ClickHouse tables for crypto data analysis - [Prediction Markets](https://docs.asksurf.ai/data-catalog/prediction-markets.md): Polymarket, Kalshi, and cross-platform prediction market data — trades, market details, prices, volume, and open interest. - [Prices](https://docs.asksurf.ai/data-catalog/prices.md): Daily token prices combining CoinGecko data and DEX VWAP calculations. - [Token Metadata](https://docs.asksurf.ai/data-catalog/token-metadata.md): ERC-20 contract registry mapping addresses to symbols, names, and decimals. - [Transfers](https://docs.asksurf.ai/data-catalog/transfers.md): ERC-20 and native token transfers enriched with symbols and USD pricing. - [TVL / Fees / Yields](https://docs.asksurf.ai/data-catalog/tvl-fees-yields.md): Protocol-level daily aggregates for total value locked, fee revenue, and yield rates. - [Overview](https://docs.asksurf.ai/overview.md): Surf — AI-powered crypto intelligence for agents and developers ## OpenAPI Specs - [openapi](https://docs.asksurf.ai/openapi.json) - [hermod-openapi](https://docs.asksurf.ai/hermod-openapi.json)