New: every message picks a fast or a slow model

Surf

Surf provides AI-ready financial, crypto, prediction-market, equity, on-chain, news, search, and web data through a unified API.

What agents can do

Actions122

  • Cancel onchain sql job

    Durably request cancellation of an asynchronous blockchain SQL job and return its current state.

  • Create onchain sql job

    Submit a read-only ClickHouse SQL query for durable background execution and return its stable job and query identifiers immediately.

  • Get dex token price

    Return USD DEX-pool-weighted OHLCV bars for one token identified by chain and contract address.

  • Get equity balance sheet

    Return standardized balance-sheet periods for a US-listed equity.

  • Get equity candles

    Return historical OHLCV candles and the latest traded price for a US-listed equity.

  • Get equity cash flow

    Return paginated standardized cash-flow periods for a US-listed equity.

  • Get equity company profile

    Return a standardized stock company profile or ETF product profile, including its business description and source-update metadata.

  • Get equity financial metrics

    Return paginated standardized financial ratios, growth measures, per-share values, and valuation metrics for a US-listed equity.

52 more
  • Get equity income statement

    Return standardized income-statement periods for a US-listed equity.

  • Get equity latest filings

    Return the most recently accepted periodic SEC filings across US equities.

  • Get equity latest financials

    Return the most recently published current-serving TTM financials across US equities, optionally filtered by a minimum current market capitalization.

  • Get equity meta

    Return lightweight identity, logo, and latest USD price metadata for one or more US-listed stocks or ETFs.

  • Get equity overview

    Return a paginated financial overview for a US-listed equity.

  • Get exchange depth

    Return bid and ask order-book levels for an exchange market, including spread, spread percentage, mid-price, and total bid and ask depth.

  • Get exchange funding history

    Return historical funding rate records for a perpetual contract.

  • Get exchange klines

    Return exchange OHLCV candlesticks with high, low, and total-volume statistics for the returned period.

  • Get exchange long short ratio

    Return historical long/short ratios for a perpetual contract.

  • Get exchange markets

    Return trading pairs available on an exchange, including base and quote currencies, market type, active status, and default fee rates.

  • Get exchange perp

    Return a perpetual futures snapshot for a trading pair, including current funding, open interest, mark price, and index price data.

  • Get exchange price

    Return the real-time ticker for an exchange trading pair, including the last price, best bid and ask, 24-hour high, low, volume, and price change.

  • Get fund detail

    Return a crypto VC fund's full profile, including its description, jurisdiction, unique invested-project count, links, X accounts, team members, and recent research.

  • Get hyperliquid account

    Return a Hyperliquid wallet's point-in-time portfolio across perpetuals, spot, vaults, and HYPE staking.

  • Get hyperliquid candles

    Return Hyperliquid market OHLCV candles ordered by open time ascending for a required half-open [from_, to) window.

  • Get hyperliquid orders

    Return a wallet's live resting orders and recent terminal orders.

  • Get hyperliquid performance

    Return a wallet's lifetime funding-excluded realized trading performance, live open positions, unrealized PnL, and perpetual clearinghouse equity.

  • Get hyperliquid positions

    Return a wallet's open Hyperliquid perpetual positions with leverage, unrealized PnL, ROE, funding, liquidation risk, and its cross-margin summary.

  • Get hyperliquid trade context

    Return immutable funding and leverage context for one closed Hyperliquid trade using the composite key from the trades action.

  • Get hyperliquid trades aggregate

    Aggregate a wallet's closed Hyperliquid trades by UTC day, symbol, direction, notional-size tier, or holding-time tier.

  • Get kalshi open interest

    Return daily open-interest history for one Kalshi market over a selected time window.

  • Get kalshi prices

    Return hourly or daily OHLC price history for one Kalshi market, or the latest price from recent trades.

  • Get kalshi volumes

    Return daily notional trading-volume history for one Kalshi market over a selected time window.

  • Get market etf

    Return daily spot ETF flow history for BTC, ETH, XRP, SOL, or HYPE, including net USD flow, closing token price, settlement status, and per-ticker flow breakdowns.

  • Get market fear greed

    Return Bitcoin Fear and Greed Index history, including each 0-100 index value, its classification, and the Bitcoin price at that time.

  • Get market futures

    Return a single ranked snapshot of futures market data across all tracked tokens, including open interest, funding rate, long/short ratio, and 24-hour volume.

  • Get market liquidation chart

    Return time-bucketed aggregate long- and short-side liquidation volumes for a token on a specific exchange and interval.

  • Get market liquidation exchange list

    Return a single ranked snapshot of total, long-side, and short-side liquidation volumes by exchange for a token and aggregation window.

  • Get market onchain indicator

    Return daily on-chain indicator history for BTC or ETH, including NUPL, SOPR, MVRV, Puell Multiple, NVM, NVT, NVT Golden Cross, and exchange-flow metrics.

  • Get market options

    Return options market data for one supported token, including open interest, 24-hour volume, put/call ratio, and max pain price by exchange.

  • Get market price

    Return historical prices for one listed token in a selected quote currency.

  • Get market price indicator

    Return a technical indicator for a trading pair on a given exchange and candlestick interval.

  • Get market public sale

    Return public sale information for a project resolved by Surf UUID, name, or token symbol, including sale type, status, dates, token price, funds raised, supply allocation, launchpad, and…

  • Get market tge

    Return Token Generation Event status for a project resolved by Surf UUID, name, or token symbol, including the current status, last status-change time, and launch exchanges.

  • Get news detail

    Return the full content and metadata of one news article by an ID obtained from Surf news feed or search results.

  • Get onchain dex activity

    Return active traders, trade count, and USD volume for one DEX protocol or router contract as either a total aggregate or a newest-first daily series.

  • Get onchain gas price

    Return the current gas price for one supported EVM chain in both wei and Gwei.

  • Get onchain schema

    Discover logical on-chain tables and columns before writing SQL or structured queries.

  • Get onchain sql job

    Return durable job status, elapsed time, ClickHouse progress counters, retry semantics, and result links for an asynchronous blockchain SQL job.

  • Get onchain sql job results

    Return a completed asynchronous blockchain SQL job's retained results as structured JSON or a downloadable CSV.

  • Get onchain tx

    Look up one EVM transaction by chain and hash.

  • Get polymarket open interest

    Return daily open-interest history in USD for one Polymarket market over a selected time window.

  • Get polymarket price ohlcv

    Return OHLCV candlesticks for a Polymarket market for price-chart and bar visualizations.

  • Get polymarket prices

    Return hourly or daily outcome-price history for one Polymarket market, or its latest price snapshot.

  • Get polymarket volumes

    Return aggregate Polymarket trading volume in USD and trade count as a time series for volume-trend analysis.

  • Get polymarket volume split

    Return Polymarket trading volume split into YES and NO outcome sides for hourly, daily, or weekly intervals, including total volume and trade count.

  • Get project detail

    Return a crypto project's profile with selectable overview, token market, legacy tokenomics, funding, team, contract, social, and token-generation sections.

  • Get signal detail

    Return one project signal card by Surf token UUID or project slug, including its score, classified state, score dimensions, market data, and summaries.

  • Get token transfer stats

    Return aggregate transfer activity for a token contract over a selected window, including transfer count, approximate unique senders and receivers, token amount, activity bounds, and USD-enrichment…

  • Get token unlock schedule

    Return token unlock time-series with cumulative amounts, allocation breakdowns, total supply denominator, and unlocked-supply percentage.

  • Get wallet detail

    Return a wallet's cross-chain portfolio with selectable balance, token, label, NFT, and approval sub-resources, plus its per-chain USD breakdown.

  • Get wallet labels batch

    Return entity names, entity types, and labels for up to 100 wallet addresses in one request.

And 62 more in Definable.

How it connects

You paste an API key from Surf on a page Composio hosts, so the key never passes through Definable.

Keep the connection to yourself or share it with your workspace. Any action that writes or sends can wait for your approval.