Skip to Content

Connect Surf to Your AI Agent

Investigate assets, wallets and market events in one workflow.

128 toolsAPI key

20,000 free app calls every month(paid services billed separately)

Try a Surf Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo SkillSurf

Research an asset

Combine market prices, company information and a cited research report.

/oo Surf: Research [asset] with Surf, compare its recent market data and relevant news, and prepare a report with sources.

Start Working with Surf

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Surf

    Generate an API key in the Dashboard at https://agents.asksurf.ai.

    Connect Surf→
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →
  • A Surf API key and enough credits for the selected operations.
  • Connecting checks your credit balance.
  • Data availability and credit costs depend on the endpoint.

Surf Tools

Compare exchange and DEX prices, company financials and ETF holdings. Inspect wallets, trading activity and blockchain data, follow news and prediction markets, and produce source-backed research reports.

Markets and equities

Compare crypto markets, US equities, financial statements and fund holdings.

Wallets and on-chain analysis

Read wallet activity, blockchain records and query results.

News and market intelligence

Track projects, signals, social activity, prediction markets and sources.

Research and account balance

Generate cited research and check remaining credits.

128 tools

Dex Token Price

DEX Token OHLCV Price.

surf.dex_token_price

Exchange Candles

Exchange Historical Candles.

surf.exchange_candles

Exchange Coverage

Exchange Market Coverage.

surf.exchange_coverage

Exchange Depth

Exchange Order Book Depth.

surf.exchange_depth

Exchange Funding History

Exchange Funding Rate History.

surf.exchange_funding_history

Exchange Klines

Exchange OHLCV Candlesticks.

surf.exchange_klines

Exchange Long Short Ratio

Exchange Long/Short Ratio History.

surf.exchange_long_short_ratio

Exchange Markets

Exchange Trading Pairs.

surf.exchange_markets

Exchange Perp

Exchange Perpetual Contract Snapshot.

surf.exchange_perp

Exchange Price

Exchange Ticker Price.

surf.exchange_price

Market Etf

ETF Flow History.

surf.market_etf

Market Exchange Flow Exchanges

Exchange Flow Exchanges.

surf.market_exchange_flow_exchanges

Market Fear Greed

Fear & Greed Index History.

surf.market_fear_greed

Market Futures

Futures Market Overview.

surf.market_futures

Market Liquidation Chart

Liquidation Chart.

surf.market_liquidation_chart

Market Liquidation Exchange List

Liquidation by Exchange.

surf.market_liquidation_exchange_list

Market Liquidation Order

Large Liquidation Orders.

surf.market_liquidation_order

Listing

Exchange Listing Events.

surf.listing

Market Onchain Indicator

On-Chain Indicator.

surf.market_onchain_indicator

Market Options

Options Market Data.

surf.market_options

Market Price

Token Price History.

surf.market_price

Market Price Indicator

Technical Indicator.

surf.market_price_indicator

Market Public Sale

Public Sale / Crowdsale.

surf.market_public_sale

Market Ranking

Token Rankings.

surf.market_ranking

Market Tge

Token Generation Event.

surf.market_tge

Equity Balance Sheet

Equity Balance Sheet.

surf.equity_balance_sheet

Equity Candles

Equity Price Candles.

surf.equity_candles

Equity Cash Flow

Equity Cash Flow.

surf.equity_cash_flow

Equity Etf Holdings

ETF Holdings.

surf.equity_etf_holdings

Equity Filings

Equity SEC Filings.

surf.equity_filings

Equity Income Statement

Equity Income Statement.

surf.equity_income_statement

Equity Latest Filings

Latest Equity Filings.

surf.equity_latest_filings

Equity Latest Financials

Latest Equity Financials.

surf.equity_latest_financials

Equity Listings

Equity Listings.

surf.equity_listings

Equity Meta

Equity Metadata.

surf.equity_meta

Equity Financial Metrics

Equity Financial Metrics.

surf.equity_financial_metrics

Equity Overview

Equity Financial Overview.

surf.equity_overview

Equity Company Profile

Equity Profile.

surf.equity_company_profile

Equity Segments

Equity Segment Financials.

surf.equity_segments

Fund Detail

Fund Profile Detail.

surf.fund_detail

Fund Portfolio

Fund Portfolio.

surf.fund_portfolio

Fund Ranking

Fund Ranking.

surf.fund_ranking

Signal Detail

Signal Detail.

surf.signal_detail

Signal Projects

Signal Projects.

surf.signal_projects

Signal Token Of The Day

Signal Token Of The Day.

surf.signal_token_of_the_day

Signal Token Of Week

Signal Token Of The Week.

surf.signal_token_of_week

News Detail

News Article Detail.

surf.news_detail

News Feed

Crypto News Feed.

surf.news_feed

Project Ai News

Project AI News.

surf.project_ai_news

Project Defi Metrics

Project DeFi Metrics.

surf.project_defi_metrics

Project Defi Ranking

DeFi Protocol Ranking.

surf.project_defi_ranking

Project Detail

Aggregated Project Detail.

surf.project_detail

Project Pulse

Project Pulse [Deprecated].

surf.project_pulse

Search Airdrop

Airdrop Search.

surf.search_airdrop

Search Airdrop Activities

Airdrop Activities.

surf.search_airdrop_activities

Search Events

Project Event Search.

surf.search_events

Search Fund

Fund Search.

surf.search_fund

Search Fundraising

Fundraising Event Search.

surf.search_fundraising

Search News

News Article Search.

surf.search_news

Search Prediction Market

Search Prediction Markets.

surf.search_prediction_market

Search Project

Project Search.

surf.search_project

Search Token

Token Symbol Resolution.

surf.search_token

Search Wallet

Wallet Search.

surf.search_wallet

Search Web

Web Search.

surf.search_web

Social Mindshare

Project Mindshare Time Series.

surf.social_mindshare

Web Fetch

Web Page Fetch.

surf.web_fetch

X Tweets

X Tweets by IDs.

surf.x_tweets

Research

Research crypto and equity markets with Surf Research 2.0 and return non-streaming Responses JSON. Use previous_response_id to continue a response chain. surf-2.0-instant favors latency; surf-2.0 supports optional nested reasoning.effort for deeper analysis, with higher latency and credit cost.

surf.research

Credit Balance

Read the current API account credit balance.

surf.credit_balance

Hyperliquid Account

Account Portfolio.

surf.hyperliquid_account

Hyperliquid Candles

Market Candles.

surf.hyperliquid_candles

Hyperliquid Fills

Fills.

surf.hyperliquid_fills

Hyperliquid Leaderboard

Trader Leaderboard.

surf.hyperliquid_leaderboard

Hyperliquid Orders

Open & Recent Orders.

surf.hyperliquid_orders

Hyperliquid Performance

Trading Performance.

surf.hyperliquid_performance

Hyperliquid Positions

Open Positions.

surf.hyperliquid_positions

Hyperliquid Trades

Closed Trades.

surf.hyperliquid_trades

Hyperliquid Trades Aggregate

Closed Trades Aggregate.

surf.hyperliquid_trades_aggregate

Hyperliquid Trade Context

Closed Trade Funding and Leverage.

surf.hyperliquid_trade_context

Onchain Bridge Ranking

Bridge Protocol Ranking.

surf.onchain_bridge_ranking

Onchain Dex Activity

DEX Protocol Activity.

surf.onchain_dex_activity

Onchain Gas Price

Current Gas Price.

surf.onchain_gas_price

Onchain Structured Query

Query blockchain data with structured column, filter, and sort clauses. Discover agent.<table> sources with onchain_schema; always filter large tables by block_date. Resolve token symbols using search_token rather than filtering unindexed symbol columns. Transfer amount is decimal-adjusted, while amount_raw is in base units.

surf.onchain_structured_query

Onchain Schema

On-Chain Table Schema.

surf.onchain_schema

Onchain Sql

Execute a read-only ClickHouse SELECT/WITH query against agent.<table> blockchain data. Discover tables with onchain_schema and filter large tables by block_date or block_number. Normalize address literals to lowercase without wrapping indexed address columns in lower(); use separate UNION ALL branches instead of OR for transfer from/to predicates. Resolve token symbols with search_token before querying contracts. The synchronous budget is 30 seconds; use prefer=respond-async and a stable idempotency_key for long queries. Do not automatically retry synchronous timeouts; submit an asynchronous job instead.

surf.onchain_sql

Onchain Sql Job Create

Submit a read-only ClickHouse SELECT/WITH query as a durable asynchronous job. Use agent.<table> names, partition filters, and resolved contract addresses as for onchain_sql. A retained job is reused for the same idempotency key or equivalent normalized SQL and max_rows. Poll onchain_sql_job_get, then read onchain_sql_job_results; results are retained for 24 hours.

surf.onchain_sql_job_create

Onchain Sql Job Cancel

Cancel Asynchronous Blockchain SQL Job.

surf.onchain_sql_job_cancel

Onchain Sql Job Get

Get Asynchronous Blockchain SQL Job.

surf.onchain_sql_job_get

Onchain Sql Job Results

Download Asynchronous Blockchain SQL Results.

surf.onchain_sql_job_results

Onchain Sql Preflight

Preflight Blockchain SQL Query.

surf.onchain_sql_preflight

Onchain Tx

Transaction Details by Hash.

surf.onchain_tx

Onchain Yield Ranking

Yield Pool Ranking.

surf.onchain_yield_ranking

Portfolio Wallets

Current User Portfolio Wallets.

surf.portfolio_wallets

Token Dex Trades

Token DEX Trade History.

surf.token_dex_trades

Token Holders

Token Holders.

surf.token_holders

Token Tokenomics

Token Unlock Schedule.

surf.token_tokenomics

Token Transfer Counterparties

Top Transfer Counterparties.

surf.token_transfer_counterparties

Token Transfer Stats

Token Transfer Activity Summary.

surf.token_transfer_stats

Token Transfers

Token Transfer History.

surf.token_transfers

Wallet Detail

Aggregated Wallet Detail.

surf.wallet_detail

Wallet History

Wallet Transaction History.

surf.wallet_history

Wallet Labels Batch

Wallet Labels (Batch).

surf.wallet_labels_batch

Wallet Net Worth

Wallet Net Worth History.

surf.wallet_net_worth

Wallet Protocols

Wallet DeFi Protocol Positions.

surf.wallet_protocols

Wallet Transfers

Wallet Transfer History.

surf.wallet_transfers

Prediction Market Analytics

Prediction Market Analytics.

surf.prediction_market_analytics

Prediction Market Correlations

Market Correlations.

surf.prediction_market_correlations

Kalshi Events

Kalshi Events.

surf.kalshi_events

Kalshi Markets

Kalshi Markets.

surf.kalshi_markets

Kalshi Open Interest

Kalshi Open Interest History.

surf.kalshi_open_interest

Kalshi Orderbooks

Kalshi Orderbook History.

surf.kalshi_orderbooks

Kalshi Prices

Kalshi Price History.

surf.kalshi_prices

Kalshi Trades

Kalshi Trades.

surf.kalshi_trades

Kalshi Volumes

Kalshi Volume History.

surf.kalshi_volumes

Matching Market Daily

Cross-Platform Daily Comparison (Polymarket <> Kalshi).

surf.matching_market_daily

Matching Market Pairs

Cross-Platform Prediction Market Matcher (Polymarket <> Kalshi).

surf.matching_market_pairs

Polymarket Events

Polymarket Events.

surf.polymarket_events

Polymarket Leaderboard

Polymarket Leaderboard.

surf.polymarket_leaderboard

Polymarket Markets

Polymarket Markets.

surf.polymarket_markets

Polymarket Open Interest

Polymarket Open Interest History.

surf.polymarket_open_interest

Polymarket Orderbooks

Polymarket Orderbook History.

surf.polymarket_orderbooks

Polymarket Positions

Polymarket Wallet Positions.

surf.polymarket_positions

Polymarket Price Ohlcv

Polymarket OHLCV Candlesticks.

surf.polymarket_price_ohlcv

Polymarket Prices

Polymarket Price History.

surf.polymarket_prices

Polymarket Smart Money

Polymarket Smart Money.

surf.polymarket_smart_money

Polymarket Trades

Polymarket Trades.

surf.polymarket_trades

Polymarket Volume Split

Polymarket Volume Split (YES/NO).

surf.polymarket_volume_split

Polymarket Volumes

Polymarket Volume History.

surf.polymarket_volumes

Frequently Asked Questions

Does Surf cover US stocks as well as crypto?

Yes. Equity data includes company profiles, financial statements, filings, candles and ETF holdings alongside crypto and on-chain data.