Surf

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 1 API on the APIs.io network: Data API. Tagged areas include Company, Crypto, Blockchain, Market Data, and On-Chain Analytics.

Surf’s developer surface includes documentation, API reference, getting-started guide, pricing, signup flow, authentication, CLI, and 14 more developer resources.

38.9/100 thin Agent 51/100 agent ready Full breakdown ↓
scored 2026-07-21 · rubric v0.4
2 APIs 1 MCP Servers 0 Features
CompanyCryptoBlockchainMarket DataOn-Chain AnalyticsWallet IntelligenceAIDeFiPrediction MarketsDeveloper API

API Rating

API Evangelist API Evangelist Rating How this is scored →
scored 2026-07-21 · rubric v0.4
Composite quality — 38.9/100 · thin
Contract Quality 9.4 / 25
Developer Ergonomics 14.8 / 20
Commercial Clarity 4.7 / 20
Operational Transparency 0.7 / 13
Governance 0.0 / 12
Discoverability 9.3 / 10
Agent readiness — 51/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 0 / 15
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 0 / 6
Agent Skills 5 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/surf: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs

Surf Data API

The Surf Data API (internally "Hermod") is a credit-billed REST gateway of 119 typed endpoints across 14 domains: Exchange, Market, Token, Project, Social, News, Wallet, Onchain...

Surf Chat API

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...

MCP Servers

surf-mcp.yml

MCP SERVER

Resources

Get Started 3

Portal, sign-up, and the first successful call

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Build 4

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Commercial 1

Pricing, plans, and the legal terms of use

Company 1

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
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
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-21'
tags:
- 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 Data API
  description: 'The Surf Data API (internally "Hermod") is a credit-billed REST gateway of 119 typed endpoints across 14 domains:
    Exchange, Market, Token, Project, Social, News, Wallet, Onchain, Web, Search, Fund, Signal, Prediction Market, Hyperliquid,
    and DEX. Bearer API-key auth, limit/offset pagination, and a { error: { code, message } } envelope.'
  humanURL: https://agents.asksurf.ai/docs/data-api/overview
  baseURL: https://api.asksurf.ai/gateway/v1
  tags:
  - Crypto
  - Market Data
  - On-Chain Analytics
  properties:
  - type: OpenAPI
    url: openapi/surf-openapi-original.json
  - type: Overlay
    url: overlays/surf-data-api-overlay.yaml
  - type: Documentation
    url: https://agents.asksurf.ai/docs/data-api/overview
- 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:
  - Crypto
  - AI
  - LLM
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- 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