Repolode
Submit
asksurf-ai

asksurf-ai/surf-skills

Agent skill that gives AI coding agents live access to crypto prices, wallets, prediction markets and on-chain data via the Surf CLI.

View on GitHubWebsite
Stars
77
Forks
7
Open issues
4
Last commit
5 days ago

Repolode describes open-source projects and does not give investment advice. Trading and investing can lose money: assess the risk yourself and follow the laws where you live before using this project.

What is it?

surf-skills is an agent skill package for the Surf data platform. Once installed into an agent that supports the skills protocol, such as Claude Code or Codex, the agent can answer questions about crypto markets by calling the Surf CLI. Typical requests include token prices, top wallet holders, DeFi TVL, funding rates and Polymarket odds.

The skill covers market, exchange, wallet, token, project, prediction market, on-chain, news and fund domains, with 83+ endpoints in the bundled data API. The agent discovers the right command through the CLI's list and help options instead of relying on hardcoded endpoints. Arbitrary read-only SQL queries against cataloged on-chain tables are also supported.

No API key is needed to start, with 30 free credits per day. A key can be added with the surf auth command for full access.

Key features

  • 01Query prices, rankings, technical indicators and liquidations across crypto markets.
  • 02Look up wallet balances, transfers, DeFi positions and labels.
  • 03Access Polymarket and Kalshi markets, trades and volume.
  • 04Run read-only SQL against on-chain tables.
  • 05Discover commands through the surf CLI without memorizing endpoints.

Use cases

  • Asking an coding agent for live token prices or market data while working.
  • Tracking which wallets hold a given token and how their positions change.
  • Pulling DeFi TVL or protocol metrics for research on a specific chain.

Quick start

  1. 1

    Install the skill for your agent

    npx skills add asksurf-ai/surf-skills --skill surf
  2. 2

    Install the Surf CLI from the official guide

  3. 3

    Optionally add your API key for full access

    surf auth --api-key $API_KEY

Things to know

  • Requires the separate Surf CLI and the hosted Surf data platform to return any data.
  • The free tier is limited to 30 credits per day; full access needs an API key from asksurf.ai.
  • The metadata lists no license, so reuse terms are unclear.

In collections

Claude Code tools, skills & pluginsOpen-source AI agent frameworks & appsMCP servers

Topics

#ai-agent#crypto#blockchain#onchain#defi#web3#claude-code#prediction-markets#crypto-api#mcp

FAQ

What is surf-skills?
Agent skill that gives AI coding agents live access to crypto prices, wallets, prediction markets and on-chain data via the Surf CLI. surf-skills is an agent skill package for the Surf data platform. Once installed into an agent that supports the skills protocol, such as Claude Code or Codex, the agent can answer questions about crypto markets by calling the Surf CLI. Typical requests include token prices, top wallet holders, DeFi TVL, funding rates and Polymarket odds.
Is surf-skills free to use? What license does it have?
surf-skills has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
Is surf-skills still maintained?
Actively maintained. The last commit to surf-skills was on Nov 2, 2026.
What can I use surf-skills for?
Asking an coding agent for live token prices or market data while working. Tracking which wallets hold a given token and how their positions change. Pulling DeFi TVL or protocol metrics for research on a specific chain.
How do I install surf-skills?
Install the skill for your agent: npx skills add asksurf-ai/surf-skills --skill surf Install the Surf CLI from the official guide Optionally add your API key for full access: surf auth --api-key $API_KEY
Where can I get surf-skills?
The source code and installation instructions are on GitHub: https://github.com/asksurf-ai/surf-skills

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects