{
  "markdown": "# surf-skills — Agent Skills for the Surf Data Platform\n\nGive your AI coding agent direct access to crypto market data, wallet intelligence, prediction markets, and on-chain data — across 40+ blockchains and 200+ data sources.\n\n> **[Full Documentation →](https://agents.asksurf.ai/docs)**\n\n## Install\n\n```bash\nnpx skills add asksurf-ai/surf-skills --skill surf\n```\n\nWorks with any agent that supports the [skills protocol](https://skills.sh) — Claude Code, Codex, and more.\n\n### Prerequisites\n\nInstall the Surf CLI following the guide at [agents.asksurf.ai/docs/cli/introduction](https://agents.asksurf.ai/docs/cli/introduction)\n\nNo API key required to start — you get 30 free credits daily. For full access, sign up at [agents.asksurf.ai](https://agents.asksurf.ai) and run:\n\n```bash\nsurf auth --api-key $API_KEY\n```\n\n## What It Does\n\nOnce installed, your agent can fetch live crypto data just by you asking for it — no endpoints to memorize.\n\n**Example prompts your agent will handle:**\n\n- \"What's the price of ETH?\"\n- \"Show me the top 10 wallets holding AAVE\"\n- \"Get Polymarket odds for the next US election\"\n- \"What's the TVL of Uniswap on Arbitrum?\"\n- \"Show me BTC funding rates across exchanges\"\n\nThe skill teaches the agent to discover endpoints, use correct parameters, and return structured data — automatically.\n\n## Data Coverage\n\n| Domain | What You Can Query |\n|--------|-------------------|\n| **Market** | Prices, rankings, technical indicators (RSI, MACD, Bollinger), fear & greed, liquidations, futures, options, ETFs |\n| **Exchange** | Order books, candlesticks, funding rates, long/short ratios, perpetual contracts |\n| **Matching** | CEX-DEX matching, market matching |\n| **Wallet** | Balances, transfers, DeFi positions, net worth, wallet labels |\n| **Token** | Holders, DEX trades, transfers, unlock schedules, tokenomics |\n| **Project** | Profiles, DeFi TVL, protocol metrics, DeFi rankings |\n| **Prediction Markets** | Polymarket & Kalshi — markets, trades, prices, volume, open interest, rankings |\n| **On-chain** | Transaction lookup, SQL queries, gas prices, bridge rankings, yield rankings |\n| **News & Search** | Cross-domain entity search, news feed, web fetch |\n| **Fund** | VC fund profiles, portfolios, rankings |\n\n## CLI Quick Reference\n\nThe skill uses the `surf` CLI under the hood. You can also use it directly:\n\n```bash\n# Discovery\nsurf sync                                    # Refresh API spec cache\nsurf list-operations                         # All available commands\nsurf list-operations | grep market           # Filter by domain\nsurf market-price --help                     # Full params and enums\n\n# Fetch data\nsurf market-price --symbol BTC -o json -f body.data\nsurf wallet-detail --address 0x... -o json -f body.data\nsurf project-detail --q uniswap -o json -f body.data\n\n# On-chain SQL\necho '{\"sql\":\"SELECT project, sum(amount_usd) FROM agent.ethereum_dex_trades WHERE block_date = today() - 1 GROUP BY project ORDER BY 2 DESC LIMIT 10\"}' | surf onchain-sql\n\n# Robinhood Chain catalog and historical coverage\nsurf catalog search robinhood\necho '{\"sql\":\"SELECT dataset, coverage_state, complete_through_block, semantic_coverage FROM agent.robinhood_dataset_coverage ORDER BY dataset\"}' | surf onchain-sql\n```\n\n## Documentation\n\n| Resource | Link |\n|----------|------|\n| **Full Docs** | [agents.asksurf.ai/docs](https://agents.asksurf.ai/docs) |\n| **CLI & Skills Guide** | [agents.asksurf.ai/docs/cli/introduction](https://agents.asksurf.ai/docs/cli/introduction) |\n| **Data API (100+ endpoints)** | [agents.asksurf.ai/docs/data-api/overview](https://agents.asksurf.ai/docs/data-api/overview) |\n| **Onchain SQL (cataloged tables)** | [agents.asksurf.ai/docs/data-catalog/overview](https://agents.asksurf.ai/docs/data-catalog/overview) |\n\n## How It Works\n\nThe skill (`skills/surf/SKILL.md`) is an instruction file that teaches your AI agent to:\n\n1. Run `surf sync` to refresh the API spec cache\n2. Use `surf list-operations` and `surf <command> --help` to discover the right endpoint\n3. Use `-o json -f body.data` for structured output\n4. Map natural language requests to the correct domain and parameters\n5. Handle pagination, chain name conventions, and common gotchas\n\nNo code generation needed — the agent calls the CLI directly and returns the data.\n\n## Adding New Endpoints\n\nNo changes needed in this repo. When a new API endpoint is added upstream:\n\n1. The OpenAPI spec updates automatically\n2. `surf list-operations` shows the new command\n3. `surf <new-command> --help` shows its parameters\n",
  "bytes": 4541,
  "sha": "398710749f8b6507b7a646a2ea3029b4fdbef984845dea0267ebda471026d2b7",
  "repo_slug": "asksurf-ai/surf-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_asksurf_ai_surf_skills_surf_84035d9d/readme"
}