# Surf API Documentation ## Docs - [POST /v1/responses](https://docs.asksurf.ai/chat/responses.md): OpenAI-compatible Responses API for Research 2.0, with `surf-2.0` and `surf-2.0-instant` model variants, effort-based pricing, streaming, and status codes - [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 - [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) - [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 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) - [Kalshi Orderbook History](https://docs.asksurf.ai/data-api/prediction-market/kalshi-orderbooks.md) - [Search Prediction Markets](https://docs.asksurf.ai/data-api/search/prediction-market.md) - [Market Correlations](https://docs.asksurf.ai/data-api/prediction-market/correlations.md) - [Matched Market Pairs](https://docs.asksurf.ai/data-api/prediction-market/matching-pairs.md) - [Matched Market Daily Comparison](https://docs.asksurf.ai/data-api/prediction-market/matching-daily.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 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) - [Polymarket OHLCV Candlesticks](https://docs.asksurf.ai/data-api/prediction-market/polymarket-ohlcv.md) - [Polymarket Volume Split](https://docs.asksurf.ai/data-api/prediction-market/polymarket-volume-split.md) - [Polymarket Orderbook History](https://docs.asksurf.ai/data-api/prediction-market/polymarket-orderbooks.md) - [Polymarket Leaderboard](https://docs.asksurf.ai/data-api/prediction-market/polymarket-leaderboard.md) - [Polymarket Smart Money](https://docs.asksurf.ai/data-api/prediction-market/polymarket-smart-money.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) - [Wallet Search](https://docs.asksurf.ai/data-api/search/wallet.md) - [Web Search](https://docs.asksurf.ai/data-api/search/web.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. - [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. - [Onchain SQL](https://docs.asksurf.ai/data-catalog/overview.md): 84 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)