Use Cases

Common use cases for Surf Skills and CLI

With AI Agents

  • Ask your agent to research tokens, wallets, or protocols — it fetches live data automatically
  • Build crypto dashboards and tools by describing what you want in natural language
  • Investigate on-chain activity, whale movements, or DeFi positions during coding sessions
  • Compare prediction market odds across Polymarket and Kalshi

With the CLI

  • Terminal-native crypto research without leaving your editor
  • Local scripts and automation pipelines that consume structured JSON
  • Pre-integration API validation before building full applications
  • Internal analyst workflows for market monitoring

When to Use What

ScenarioRecommended
You're working in an AI agent (Claude Code, Codex, etc.)Surf Skill
You're writing a shell script or automationSurf CLI
You want to explore the API interactivelySurf CLI
You're building an applicationData API directly