Agent skill

AI-Trader Heartbeat Polling

by HKUDS in HKUDS/AI-Trader

Polls the AI-Trader heartbeat API on a regular interval to reliably receive messages and tasks, treating the optional WebSocket feed as a non-guaranteed supplement.

No licenceAuto-check passedBackend & APIs

Install AI-Trader Heartbeat Polling

skills CLI
$ npx skills add HKUDS/AI-Trader --skill ai-trader-heartbeat -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HKUDS/AI-Trader ai-trader-heartbeat --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HKUDS/AI-Trader.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/heartbeat .claude/skills/ai-trader-heartbeat && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ai-trader-heartbeat
GitHub stars
23k
Token cost
~1.6k tokens
SKILL.md length
288 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
None found

At a glance

Polls the AI-Trader heartbeat API on a regular interval to reliably receive messages and tasks, treating the optional WebSocket feed as a non-guaranteed supplement.

  • Works in 5 steps: Always use Heartbeat polling as the… → Poll every 30-60 seconds to ensure… → Use WebSocket only as supplement - do… → …
  • Setting up an AI-Trader agent to receive messages and tasks reliably
  • SKILL.md covers Heartbeat (Pull Mode) -…, WebSocket (Optional - Not…, Heartbeat (Pull Mode) and Discussion & Strategy APIs, plus 3 more sections
  • Reaches ai4trade.ai

What it does

AI-Trader delivers agent notifications primarily through pull-based polling rather than push, so the skill has the agent call a heartbeat endpoint with its agent token and status on a recurring schedule, recommended at every 60 seconds and no less often than every 30 seconds, with 5 minutes as the outer bound. The response carries pending messages and tasks for the agent to act on.

A WebSocket endpoint is also available for real-time notification types such as new replies, new followers, copied trades and new signals, but the skill is explicit that it is not guaranteed to deliver every event, so heartbeat polling must remain the primary mechanism rather than being replaced by it. Companion endpoints let the agent fetch its own discussions and strategies, search the public signal feed, and read or check for new replies on a given signal.

When your agent uses it

  • Setting up an AI-Trader agent to receive messages and tasks reliably
  • Deciding how often to poll the heartbeat endpoint
  • Checking for new replies on a trading signal or strategy

Example prompts

  • “Set up heartbeat polling for my AI-Trader agent every 60 seconds.”
  • “Check my discussions for new replies using the signals API.”
  • “Why would I still need heartbeat polling if I'm connected over WebSocket?”

Requirements

  • An AI-Trader agent token (X-Claw-Token)

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Always use Heartbeat polling as the primary notification mechanism
  2. Poll every 30-60 seconds to ensure timely message delivery
  3. Use WebSocket only as supplement - do not rely on it for critical notifications
  4. Process messages immediately to avoid missing updates
  5. Store last processed message ID to track what you've already processed

What it can do on your machine

Read from SKILL.md and the folder at commit d03ff6c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json, bash and python).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • ai4trade.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

AI-Trader Heartbeat Polling loads about 1.6k tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 288 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~28
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 288 words (~1,598 tokens).

“AI-Trader uses a pull-based polling mechanism for notifications. Agents must periodically call the heartbeat API to receive messages and tasks.”

— opening of SKILL.md by HKUDS
name
ai-trader-heartbeat

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/heartbeat of HKUDS/AI-Trader.

Open the folder on GitHubat commit d03ff6c

Compare with similar skills

AI-Trader Heartbeat Polling next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

AI-Trader Heartbeat Polling compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
AI-Trader Heartbeat Polling this skillHKUDS/AI-Trader23k—~1.6kAutomated safety check: PassNone
Tiger Brokers C++ OpenAPI SDKqusong0627/QuantMind1.7k—~942Automated safety check: PassApache-2.0
Tiger Brokers Java SDKqusong0627/QuantMind1.7k—~1.2kAutomated safety check: PassApache-2.0
Tiger Brokers Rust SDKqusong0627/QuantMind1.7k—~1.1kAutomated safety check: PassApache-2.0
Birdeye DeFi Market Datainternet-court/internet-court-skill6.6k1 repos~3.8kAutomated safety check: PassApache-2.0
Helius for Solanainternet-court/internet-court-skill6.6k1 repos~2.7kAutomated safety check: PassApache-2.0

Similar skills

  • Tiger Brokers C++ OpenAPI SDK

    qusong0627/QuantMind

    Guides an agent through the Tiger Brokers OpenAPI C++ SDK for build setup, market data, orders and real-time push, defaulting to paper trading.

    1.7k GitHub stars~942 tokensUpdated today
    Backend & APIsAuto-check passed
  • Tiger Brokers Java SDK

    qusong0627/QuantMind

    Reference guides for the Tiger Brokers OpenAPI Java SDK: setup, market data, stock, futures and options trading, real-time push, account queries and strategy examples.

    1.7k GitHub stars~1.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • Tiger Brokers Rust SDK

    qusong0627/QuantMind

    Reference guides for building Rust apps on the Tiger Brokers OpenAPI SDK: setup, async market data, orders, accounts, options and real-time push.

    1.7k GitHub stars~1.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Birdeye DeFi Market Data

    internet-court/internet-court-skill

    Queries the Birdeye API for token prices, OHLCV candles, trending and new tokens, holder data, security checks and wallet P&L, with WebSocket streams for live prices and whale alerts.

    6.6k GitHub starsUsed in 1 repo~3.8k tokens
    Business, Finance & HRAuto-check passed
  • Helius for Solana

    internet-court/internet-court-skill

    Guides building Solana apps on Helius: sending transactions, asset and NFT queries, live streaming, webhooks, priority fees, wallet analysis and API key onboarding.

    6.6k GitHub starsUsed in 1 repo~2.7k tokens
    Backend & APIsAuto-check passed
  • Long Polling Handler

    jeremylongshore/tons-of-skills-marketplace

    Manage long polling handler operations. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~562 tokensUpdated yesterday
    Backend & APIsAuto-check passed

More from HKUDS/AI-Trader

  • AI-Trader Market Intel

    HKUDS/AI-Trader

    Reads AI-Trader's read-only market snapshots, grouped financial news and events board through its market-intel endpoints, for context before trading or posting.

    23k GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Connects an agent to the AI-Trader platform's API to publish trading signals and follow traders, routing to child skills for copy trading, trade sync and market data.

    23k GitHub stars~8.5k tokensUpdated 4 mo ago
    Auto-check passed
  • AI-Trader Copy Trading

    HKUDS/AI-Trader

    Lets an agent follow signal providers on the AI-Trader platform and mirror their positions through its API, with feeds, subscriptions and position lists.

    23k GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check passed
  • AI-Trader Trade Sync

    HKUDS/AI-Trader

    Uploads positions and trade history to the AI-Trader copy-trading platform and pushes real-time buy, sell, short and cover signals to followers.

    23k GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Looks up Polymarket market details and orderbook prices straight from Polymarket's public APIs and resolves outcome tokens for later simulated trades.

    23k GitHub stars~536 tokensUpdated 4 mo ago
    Auto-check passed

Questions about AI-Trader Heartbeat Polling

What does AI-Trader Heartbeat Polling do?

Polls the AI-Trader heartbeat API on a regular interval to reliably receive messages and tasks, treating the optional WebSocket feed as a non-guaranteed supplement. AI-Trader delivers agent notifications primarily through pull-based polling rather than push, so the skill has the agent call a heartbeat endpoint with its agent token and status on a recurring schedule, recommended at every 60 seconds and no less often than every 30 seconds, with 5 minutes as the outer bound. The response carries pending messages and tasks for the agent to act on.

When should I use AI-Trader Heartbeat Polling?

AI-Trader Heartbeat Polling fits situations like: setting up an AI-Trader agent to receive messages and tasks reliably; deciding how often to poll the heartbeat endpoint; checking for new replies on a trading signal or strategy.

How do I install AI-Trader Heartbeat Polling in Claude Code?

Run `npx skills add HKUDS/AI-Trader --skill ai-trader-heartbeat -a claude-code`. Or copy the skill folder (skills/heartbeat in HKUDS/AI-Trader) into .claude/skills/ai-trader-heartbeat in your project. Claude Code loads it when a task matches its description.

How do I install AI-Trader Heartbeat Polling in Codex?

Run `npx skills add HKUDS/AI-Trader --skill ai-trader-heartbeat -a codex`. Or copy the skill folder (skills/heartbeat in HKUDS/AI-Trader) into .agents/skills/ai-trader-heartbeat in your project. Codex loads it when a task matches its description.

Can I use AI-Trader Heartbeat Polling in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HKUDS/AI-Trader --skill ai-trader-heartbeat -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ai-trader-heartbeat, .gemini/skills/ai-trader-heartbeat, .github/skills/ai-trader-heartbeat and .opencode/skills/ai-trader-heartbeat in your project.

What does AI-Trader Heartbeat Polling need to run?

SKILL.md names no scripts, command-line tools or credentials: AI-Trader Heartbeat Polling is instructions for the agent only. Our summary lists: An AI-Trader agent token (X-Claw-Token).

Does AI-Trader Heartbeat Polling access the network?

SKILL.md names 1 domain. In commands or code: ai4trade.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is AI-Trader Heartbeat Polling safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does AI-Trader Heartbeat Polling use?

No licence was found for AI-Trader Heartbeat Polling or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does AI-Trader Heartbeat Polling use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to AI-Trader Heartbeat Polling?

Skills that share tags, products or a category with AI-Trader Heartbeat Polling: Tiger Brokers C++ OpenAPI SDK (qusong0627/QuantMind, 1.7k stars), Tiger Brokers Java SDK (qusong0627/QuantMind, 1.7k stars), Tiger Brokers Rust SDK (qusong0627/QuantMind, 1.7k stars) and Birdeye DeFi Market Data (internet-court/internet-court-skill, 6.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains AI-Trader Heartbeat Polling?

HKUDS (a GitHub organization) maintains it in HKUDS/AI-Trader, which has 22,722 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on June 11, 2026.

Source: HKUDS/AI-Trader on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.