Equity Data API

About

The Surf Equity Data API brings US-listed stocks and ETFs into the same typed gateway as Surf's crypto market, on-chain, wallet, and prediction-market data.

Use it to power agent research, cross-asset dashboards, screening workflows, and financial-data products without stitching together separate market, fundamentals, and filing providers.

Base URL: https://api.asksurf.ai/gateway

What you can query

• Market context — symbol metadata, company and ETF profiles, latest prices, and historical OHLCV candles.
• Company fundamentals — financial overview, income statement, balance sheet, cash flow, ratios, growth measures, per-share values, and valuation metrics.
• ETF intelligence — current and previous holdings snapshots for ETFs and index funds.
• Company context — issuer listings, profiles, standardized statements, and valuation context.

Example

curl "https://api.asksurf.ai/gateway/v1/equity/overview?symbol=AAPL" \
  -H "Authorization: Bearer $SURF_API_KEY"

Responses preserve explicit missing values as null and include the credit usage in meta.credits_used.

Coverage and freshness

Equity identity and company profile data are cached independently from prices. Historical financial periods reflect the current serving publication; the API does not synthesize missing periods or financial values. See each endpoint's description for its freshness and pagination behavior.

Endpoints