surf-skills
A skill giving an agent live crypto data: prices, wallets, TVL, on-chain SQL and Polymarket and Kalshi prediction markets.
- 78 ★ on the repository
- Last commit
Extended access
Why this level
- Wallet and token queries go to the Surf service under an API key
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/surf-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Wallet and token queries go to the Surf service under an API key
This is third-party code. Review the repository files before installing.
What it does
The `surf` skill teaches an agent to use the Surf platform CLI: find the right operation, choose parameters and return structured data. Coverage: markets (prices, RSI and MACD indicators, liquidations, futures), exchanges (order books, candles, funding rates), wallets, tokens, projects and DeFi TVL, Polymarket and Kalshi prediction markets, on-chain data and SQL, news and funds. The user asks in plain words, for example the top 10 AAVE holders, and the agent runs commands such as `surf market-price --symbol BTC`. Heavy SQL queries go as an async job through `--prefer respond-async`.
Who it is for. Crypto analysts and developers who need fresh prices, wallet and protocol data inside an agent conversation without browsing documentation.
Good fit when
- The current price and indicators of a token are needed without opening exchanges or sites.
- The largest token holders and wallet movements must be examined.
- Protocol TVL in DeFi and bridge or yield rankings are being researched.
- An on-chain SQL query over DEX trade tables is required.
Not a fit when
- Trading or moving funds is needed: the skill only reads data.
- An investment decision is to be made from the agent answer with no own checking.
- Data must not leave for an external service: queries go to the Surf platform.
Example request
Show the ETH price, BTC funding rates and the top 10 AAVE holders.Limitations
The `surf` CLI and platform access are required. 30 credits are free per day, beyond that an API key is needed and entered with `surf auth --api-key`. Wallet and token queries go to the Surf service and answers come from its sources, so accuracy and completeness depend on them. An agent answer is not a substitute for checking and is not investment advice. The repository does not state a license and detailed documentation lives on the Surf site.
How to disable. Remove the `surf` skill from the agent skills directory and, if wanted, the `surf` CLI. Revoke the API key in the platform dashboard.
FAQ
Is an API key needed?
Not to start: 30 free credits are available per day. Full access needs a key from the dashboard set with `surf auth --api-key`.
Which prediction markets are covered?
Polymarket and Kalshi: markets, trades, prices, volume, open interest and rankings.
How do I run heavy SQL?
Pipe the query to `surf onchain-sql --prefer respond-async`. Sync mode has a 30 second budget.
Can the skill trade?
No, it reads market, wallet and on-chain data and does not sign transactions.
Which agents does it work with?
Any agent that supports the skills protocol: Claude Code, Codex and others.
Discussion
No questions or reviews yet.
Related
SkillsLive data from 78 platforms as JSON through one key: skills teach an agent to call the Scavio API for Amazon, Airbnb and more
A data visualization skill for agents: turns data into polished interactive HTML charts and full reports with one visual language
Skills for Claude Code and Cursor: search apps, log and trace analytics and OpenSearch deployment in the cloud.
High-Stakes Analytics Lab
High-Stakes Analytics & Decision Lab
An evidence-gated analytics skill for high-stakes decisions: profiles data, picks a method the evidence supports, can answer with a data request
A template for data scientists: AGENTS.md, CLAUDE.md and skills for Python, SQL, Polars and model diagnostics.
A skill that configures the DatI gateway over its HTTP API: data sources, terms and MCP services, with no web UI work.
README in short
The README covers installation, prerequisites and API key, example prompts, a data coverage table and a quick reference of `surf` commands.