{"id":48877042,"url":"https://github.com/asksurf-ai/surf-skills","last_synced_at":"2026-04-16T01:01:13.539Z","repository":{"id":348604930,"uuid":"1166415802","full_name":"asksurf-ai/surf-skills","owner":"asksurf-ai","description":"Give your AI agent access to all crypto data — prices, wallets, social, on-chain, prediction markets. One skill, 83+ endpoints.","archived":false,"fork":false,"pushed_at":"2026-04-14T01:56:49.000Z","size":368,"stargazers_count":30,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-14T03:05:25.536Z","etag":null,"topics":["ai-agent","blockchain","claude-code","crypto","crypto-api","defi","mcp","onchain","skills","social-analytics","wallet-tracker","web3"],"latest_commit_sha":null,"homepage":"https://skills.sh/asksurf-ai/surf-skills/surf","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/asksurf-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-25T07:44:36.000Z","updated_at":"2026-04-14T01:02:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/asksurf-ai/surf-skills","commit_stats":null,"previous_names":["cyberconnecthq/surf-skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/asksurf-ai/surf-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asksurf-ai%2Fsurf-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asksurf-ai%2Fsurf-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asksurf-ai%2Fsurf-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asksurf-ai%2Fsurf-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/asksurf-ai","download_url":"https://codeload.github.com/asksurf-ai/surf-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asksurf-ai%2Fsurf-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31866357,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","blockchain","claude-code","crypto","crypto-api","defi","mcp","onchain","skills","social-analytics","wallet-tracker","web3"],"created_at":"2026-04-16T01:00:51.122Z","updated_at":"2026-04-16T01:01:13.526Z","avatar_url":"https://github.com/asksurf-ai.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# surf-skills — Agent Skills for the Surf Data Platform\n\nGive your AI coding agent direct access to crypto market data, wallet intelligence, social analytics, prediction markets, and on-chain data — across 40+ blockchains and 200+ data sources.\n\n\u003e **[Full Documentation →](https://docs.asksurf.ai)**\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- \"Find trending crypto projects on Twitter\"\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 \u0026 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| **Social** | Twitter/X profiles, posts, followers, mindshare, sentiment, smart followers |\n| **Token** | Holders, DEX trades, transfers, unlock schedules, tokenomics |\n| **Project** | Profiles, DeFi TVL, protocol metrics, DeFi rankings |\n| **Prediction Markets** | Polymarket \u0026 Kalshi — markets, trades, prices, volume, open interest, rankings |\n| **On-chain** | Transaction lookup, SQL queries, gas prices, bridge rankings, yield rankings |\n| **News \u0026 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 social-user --handle vitalikbuterin -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\n## Documentation\n\n| Resource | Link |\n|----------|------|\n| **Full Docs** | [docs.asksurf.ai](https://docs.asksurf.ai) |\n| **CLI \u0026 Skills Guide** | [docs.asksurf.ai/cli/introduction](https://docs.asksurf.ai/cli/introduction) |\n| **Data API (83 endpoints)** | [docs.asksurf.ai/data-api/overview](https://docs.asksurf.ai/data-api/overview) |\n| **Onchain SQL (58 tables)** | [docs.asksurf.ai/data-catalog/overview](https://docs.asksurf.ai/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 \u003ccommand\u003e --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 \u003cnew-command\u003e --help` shows its parameters\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasksurf-ai%2Fsurf-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasksurf-ai%2Fsurf-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasksurf-ai%2Fsurf-skills/lists"}