> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asksurf.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

| Scenario                                                 | Recommended                                 |
| -------------------------------------------------------- | ------------------------------------------- |
| You're working in an AI agent (Claude Code, Codex, etc.) | **Surf Skill**                              |
| You're writing a shell script or automation              | **Surf CLI**                                |
| You want to explore the API interactively                | **Surf CLI**                                |
| You're building an application                           | **[Data API](/data-api/overview)** directly |

## Related Docs

* [Chat API](/chat-completions)
* [Data API Overview](/data-api/overview)
* [Data Catalog](/data-catalog/overview)