Surf (asksurf.ai) is a crypto-focused AI research and execution platform that exposes its intelligence as a developer API. The Surf Data API ("Hermod" gateway) provides 119 typed REST endpoints across 14 domains — exchange and market data, tokens, DeFi projects, wallets, on-chain SQL, social signals, news, funds, prediction markets (Polymarket/Kalshi), Hyperliquid perps, search, and web fetch — covering 40+ blockchains and 200+ data sources. A separate OpenAI-style Chat API (surf-2.0 / surf-2.0-instant models) answers natural-language crypto research questions with citations. Access is via a single Bearer API key with credit-based billing (30 free credits/day, no signup), and the platform ships a Go CLI, an MCP server, an Agent Skill, and a TypeScript SDK. Surf is backed by Pantera Capital.
Surf publishes 16 API contracts indexed on the APIs.io network, including DEX API, Exchange API, Fund API, and 13 more. Tagged areas include Company, Cryptocurrency, Blockchain, Market Data, and On-Chain Analytics.
The Surf catalog on APIs.io includes 1 Spectral governance ruleset.
Surf’s developer surface includes engineering blog, documentation, API reference, getting-started guide, pricing, signup flow, authentication, and 17 more developer resources.
Regulatory Posture applies to this provider. Its tags matched the
Securities & Market Data regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it
carries 10 points of the composite. It is scored from the published contracts
themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already
holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in
front of it, and the first time that check is skipped a duplicate record is created.
Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet,
not penalised by it.
The six quality facets above are damped to 75 points between them,
because the conditional facet above carries the other
25. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 75% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/surf/"><img src="https://apis.io/badge/surf/card.svg" alt="Surf on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
Idempotency+9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented) Ask about this →
Rate-Limit Signaling+7 pts — OpenAPI responses document X-RateLimit-* / RateLimit headers (verified), else a rate_limits artifact or RateLimits link (documented) Ask about this →
Each check links to what satisfies it. Publish the artifact, or tell us where it already lives, and the score moves on the next scoring run.
Not sure how this applies to your stack? Ask about any one item. Kin Lane reads every question, looks at your profile and your situation, and replies with what a fix would take — scoped to that one area, priced up front, yours whether you ship it or not. Ask a question →
The Kin Score Market layer reads a provider inside its market:
its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted:
not part of the Kin Score or agent readiness.
Registered MCP server and declares compatibility are report only — not weighted.
Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
OpenAI-style Chat/Research API. POST /responses with a surf-2.0 or surf-2.0-instant model and a natural-language crypto question; returns synthesized answers with inline citatio...
Access real-time trading data from major exchanges including Binance, OKX, Bybit, and more. Query live ticker prices, order book depth, OHLCV candlestick charts, and perpetual c...
Explore crypto venture capital. Look up fund profiles with team info and social links, browse their full investment portfolio with round details, and rank funds by tier or portf...
Get a high-level view of the crypto market. Browse token rankings by market cap or volume, track derivatives across all exchanges, monitor spot ETF fund flows, view liquidation ...
Stay up to date with crypto news. Browse the latest articles from major crypto media outlets, read full article content, and search across all sources by keyword.
Track prediction markets on Polymarket and Kalshi. Browse events and markets, view live prices and odds, analyze trading volume and open interest history, inspect individual tra...
Find anything across Surf's data universe. Search for crypto projects, X (Twitter) accounts and posts, news articles, wallet addresses, web pages, investment funds, airdrop oppo...
Monitor crypto social activity on X (Twitter). Look up user profiles and their posts, track project sentiment scores and follower geography, discover smart followers, and analyz...
Analyze individual tokens on-chain. Look up top holders and their share of supply, track ERC-20/SPL token transfers, browse DEX swap history, and view upcoming token unlock sche...
Inspect any wallet on Ethereum, Base, Solana, and other chains. View token balances, NFT holdings, entity labels, transfer history, full transaction logs, DeFi protocol position...
Fetch and search web content. Retrieve any URL and convert it to clean, LLM-friendly markdown, or search the internet for crypto-related articles, reports, and resources.
Query blockchain data directly. Look up transaction details by hash, check gas prices, and run structured or raw SQL queries against indexed blockchain datasets spanning Ethereu...
Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.
x-enrichment:
date: '2026-07-21'
status: enriched
artifacts_added: 19
pass: local-v1
aid: surf
name: Surf
description: Surf (asksurf.ai) is a crypto-focused AI research and execution platform that exposes its intelligence as a developer
API. The Surf Data API ("Hermod" gateway) provides 119 typed REST endpoints across 14 domains — exchange and market data,
tokens, DeFi projects, wallets, on-chain SQL, social signals, news, funds, prediction markets (Polymarket/Kalshi), Hyperliquid
perps, search, and web fetch — covering 40+ blockchains and 200+ data sources. A separate OpenAI-style Chat API (surf-2.0
/ surf-2.0-instant models) answers natural-language crypto research questions with citations. Access is via a single Bearer
API key with credit-based billing (30 free credits/day, no signup), and the platform ships a Go CLI, an MCP server, an Agent
Skill, and a TypeScript SDK. Surf is backed by Pantera Capital.
url: https://raw.githubusercontent.com/api-evangelist/surf/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- pantera-capital
x-tier: stub
x-tier-reason: portfolio-lead
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: false
label: Hosted service · you call their endpoint
confidence: medium
source:
- openapi
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: paid
onboarding: open
trial: false
try_now: false
public: true
gated: none
gated_source:
- onboarding
label: Paid · Open access
confidence: high
source:
- plans
- authentication
- security
- sandbox
generated: '2026-11-13'
method: derived
specificationVersion: '0.23'
created: '2026-07-17'
modified: '2026-10-06'
tags:
- Company
- Cryptocurrency
- Blockchain
- Market Data
- On-Chain Analytics
- Wallet Intelligence
- Artificial Intelligence
- DeFi
- Prediction Markets
- Developer API
tags_raw:
- Company
- Crypto
- Blockchain
- Market Data
- On-Chain Analytics
- Wallet Intelligence
- AI
- DeFi
- Prediction Markets
- Developer API
image: https://asksurf.ai/favicon.ico
apis:
- name: Surf Chat API
description: OpenAI-style Chat/Research API. POST /responses with a surf-2.0 or surf-2.0-instant model and a natural-language
crypto question; returns synthesized answers with inline citations drawn from live market, on-chain, and social data.
Streaming supported.
humanURL: https://agents.asksurf.ai/docs/chat/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- Cryptocurrency
- Artificial Intelligence
- LLM
tags_raw:
- Crypto
- AI
- LLM
- aid: surf:surf-dex-api
name: Surf DEX API
description: The DEX API from Surf — 1 operation(s) for dex.
humanURL: https://agents.asksurf.ai/docs/data-api/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- Decentralized Exchange
tags_raw:
- DEX
properties:
- type: OpenAPI
url: openapi/surf-dex-api-openapi.yml
- type: Documentation
url: https://agents.asksurf.ai/docs/data-api/overview
- aid: surf:surf-exchange-api
name: Surf Exchange API
description: Access real-time trading data from major exchanges including Binance, OKX, Bybit, and more. Query live ticker
prices, order book depth, OHLCV candlestick charts, and perpetual contract data such as funding rates, open interest,
and long/short ratios.
humanURL: https://agents.asksurf.ai/docs/data-api/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- Exchange
properties:
- type: OpenAPI
url: openapi/surf-exchange-api-openapi.yml
- type: Documentation
url: https://agents.asksurf.ai/docs/data-api/overview
- aid: surf:surf-fund-api
name: Surf Fund API
description: Explore crypto venture capital. Look up fund profiles with team info and social links, browse their full investment
portfolio with round details, and rank funds by tier or portfolio size.
humanURL: https://agents.asksurf.ai/docs/data-api/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- Fund
properties:
- type: OpenAPI
url: openapi/surf-fund-api-openapi.yml
- type: Documentation
url: https://agents.asksurf.ai/docs/data-api/overview
- aid: surf:surf-hyperliquid-api
name: Surf Hyperliquid API
description: The Hyperliquid API from Surf — 9 operation(s) for hyperliquid.
humanURL: https://agents.asksurf.ai/docs/data-api/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- Hyperliquid
properties:
- type: OpenAPI
url: openapi/surf-hyperliquid-api-openapi.yml
- type: Documentation
url: https://agents.asksurf.ai/docs/data-api/overview
- aid: surf:surf-market-api
name: Surf Market API
description: Get a high-level view of the crypto market. Browse token rankings by market cap or volume, track derivatives
across all exchanges, monitor spot ETF fund flows, view liquidation events, compute technical indicators (RSI, MACD, Bollinger
Bands, and more), explore on-chain valuation metrics (NUPL, MVRV, SOPR), and check the Fear & Greed Index.
humanURL: https://agents.asksurf.ai/docs/data-api/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- Markets
tags_raw:
- Market
properties:
- type: OpenAPI
url: openapi/surf-market-api-openapi.yml
- type: Documentation
url: https://agents.asksurf.ai/docs/data-api/overview
- aid: surf:surf-news-api
name: Surf News API
description: Stay up to date with crypto news. Browse the latest articles from major crypto media outlets, read full article
content, and search across all sources by keyword.
humanURL: https://agents.asksurf.ai/docs/data-api/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- News
properties:
- type: OpenAPI
url: openapi/surf-news-api-openapi.yml
- type: Documentation
url: https://agents.asksurf.ai/docs/data-api/overview
- aid: surf:surf-prediction-market-api
name: Surf Prediction Market API
description: Track prediction markets on Polymarket and Kalshi. Browse events and markets, view live prices and odds, analyze
trading volume and open interest history, inspect individual trades, and discover top-ranked markets by activity.
humanURL: https://agents.asksurf.ai/docs/data-api/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- Prediction-Market
tags_raw:
- Prediction Market
properties:
- type: OpenAPI
url: openapi/surf-prediction-market-api-openapi.yml
- type: Documentation
url: https://agents.asksurf.ai/docs/data-api/overview
- aid: surf:surf-project-api
name: Surf Project API
description: Research crypto projects in depth. Retrieve aggregated project profiles covering overview, team, funding rounds,
tokenomics, social links, and TGE status. Track DeFi protocol metrics like TVL, fees, revenue, trading volume, and active
users over time.
humanURL: https://agents.asksurf.ai/docs/data-api/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- Project
properties:
- type: OpenAPI
url: openapi/surf-project-api-openapi.yml
- type: Documentation
url: https://agents.asksurf.ai/docs/data-api/overview
- aid: surf:surf-search-api
name: Surf Search API
description: Find anything across Surf's data universe. Search for crypto projects, X (Twitter) accounts and posts, news
articles, wallet addresses, web pages, investment funds, airdrop opportunities, and prediction market events — all from
a single unified search interface.
humanURL: https://agents.asksurf.ai/docs/data-api/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- Search
properties:
- type: OpenAPI
url: openapi/surf-search-api-openapi.yml
- type: Documentation
url: https://agents.asksurf.ai/docs/data-api/overview
- aid: surf:surf-signal-api
name: Surf Signal API
description: Explore ranked project signal score snapshots, token-of-day/week highlights, and project-level signal cards
with latest price, price-change, dimension scores, compact signals, and AI summaries.
humanURL: https://agents.asksurf.ai/docs/data-api/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- Signal
properties:
- type: OpenAPI
url: openapi/surf-signal-api-openapi.yml
- type: Documentation
url: https://agents.asksurf.ai/docs/data-api/overview
- aid: surf:surf-social-api
name: Surf Social API
description: Monitor crypto social activity on X (Twitter). Look up user profiles and their posts, track project sentiment
scores and follower geography, discover smart followers, and analyze mindshare trends over time to gauge social momentum.
humanURL: https://agents.asksurf.ai/docs/data-api/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- Social
properties:
- type: OpenAPI
url: openapi/surf-social-api-openapi.yml
- type: Documentation
url: https://agents.asksurf.ai/docs/data-api/overview
- aid: surf:surf-token-api
name: Surf Token API
description: Analyze individual tokens on-chain. Look up top holders and their share of supply, track ERC-20/SPL token transfers,
browse DEX swap history, and view upcoming token unlock schedules with allocation breakdowns.
humanURL: https://agents.asksurf.ai/docs/data-api/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- Tokens
tags_raw:
- Token
properties:
- type: OpenAPI
url: openapi/surf-token-api-openapi.yml
- type: Documentation
url: https://agents.asksurf.ai/docs/data-api/overview
- aid: surf:surf-wallet-api
name: Surf Wallet API
description: Inspect any wallet on Ethereum, Base, Solana, and other chains. View token balances, NFT holdings, entity labels,
transfer history, full transaction logs, DeFi protocol positions (lending, staking, LP), and net worth trends over time.
humanURL: https://agents.asksurf.ai/docs/data-api/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- Wallets
tags_raw:
- Wallet
properties:
- type: OpenAPI
url: openapi/surf-wallet-api-openapi.yml
- type: Documentation
url: https://agents.asksurf.ai/docs/data-api/overview
- aid: surf:surf-web-api
name: Surf Web API
description: Fetch and search web content. Retrieve any URL and convert it to clean, LLM-friendly markdown, or search the
internet for crypto-related articles, reports, and resources.
humanURL: https://agents.asksurf.ai/docs/data-api/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- Web
properties:
- type: OpenAPI
url: openapi/surf-web-api-openapi.yml
- type: Documentation
url: https://agents.asksurf.ai/docs/data-api/overview
- aid: surf:surf-on-chain-api
name: Surf On Chain API
description: Query blockchain data directly. Look up transaction details by hash, check gas prices, and run structured or
raw SQL queries against indexed blockchain datasets spanning Ethereum, Base, Solana, and more.
humanURL: https://agents.asksurf.ai/docs/chat/overview
baseURL: https://api.asksurf.ai/gateway/v1
tags:
- Onchain
tags_raw:
- On Chain
properties:
- type: OpenAPI
url: openapi/surf-on-chain-api-openapi.yml
- type: Documentation
url: https://agents.asksurf.ai/docs/data-api/overview
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com
- FN: APIs.json
email: info@apis.io
common:
- type: Plans
url: plans/surf-plans-pricing.yml
- url: https://asksurf.ai/blog
type: Blog
- type: Overlay
url: overlays/surf-data-api-overlay.yaml
- type: Website
url: https://asksurf.ai/
- type: DeveloperPortal
url: https://agents.asksurf.ai/
- type: Documentation
url: https://agents.asksurf.ai/docs
- type: APIReference
url: https://agents.asksurf.ai/docs/data-api/overview
- type: GettingStarted
url: https://agents.asksurf.ai/docs/overview
- type: Pricing
url: https://agents.asksurf.ai/docs/pricing
- type: SignUp
url: https://agents.asksurf.ai/
- type: GitHubOrganization
url: https://github.com/asksurf-ai
- type: LLMsTxt
url: llms/surf-llms.txt
- type: Authentication
url: authentication/surf-authentication.yml
- type: Conventions
url: conventions/surf-conventions.yml
- type: ErrorCatalog
url: errors/surf-error-codes.yml
- type: DataModel
url: data-model/surf-data-model.yml
- type: Conformance
url: conformance/surf-conformance.yml
- type: Lifecycle
url: lifecycle/surf-lifecycle.yml
- type: MCPServer
url: mcp/surf-mcp.yml
- type: AgentSkill
url: skills/_index.yml
- type: CLI
url: cli/surf-cli.yml
- type: Packages
url: packages/surf-packages.yml
- type: SDKs
url: packages/surf-packages.yml
- type: DomainSecurity
url: security/surf-domain-security.yml
Surf API — frequently asked questions
Does Surf have an API?
Yes. APIs.io lists 16 APIs from Surf, including Surf Chat API, Surf DEX API and Surf Exchange API, and 13 more.
Is there an OpenAPI specification for the Surf API?
Yes. APIs.io indexes 15 OpenAPI specifications for Surf, each linked for download from this page.
How do I authenticate with the Surf API?
Surf uses bearer-token authentication (http/apiKey · 3 schemes). The details are profiled on APIs.io as Surf Authentication.
How much does the Surf API cost?
Surf publishes its prices; its Pay-as-you-go (list rate) plan is $0.006 per credit as of 2026-10-07. APIs.io lists 15 pricing plans for Surf, with each plan's price, limits and inclusions under Pricing on this page.
Does Surf have an MCP server?
Yes. APIs.io lists 1 MCP server for Surf: Local (stdio) MCP server; 12 tools listed.
Is the Surf API ready for AI agents?
Surf has a Kin Score of 45.3 out of 100 (developing) and an Agent Readiness score of 27.0 (agent-aware), scored by API Evangelist on 2026-11-13.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.