Agent Skills

Agent Skills are self-contained Markdown files that teach AI agents how to use the toobit CLI to perform specific categories of tasks. Each skill provides contextual instructions, command examples, and operation flows.

Available Skills

Skill	Description	Auth Required
toobit-cex-market	Public market data: prices, order books, candles, funding rates, open interest, mark price, index price	No
toobit-cex-trade	Order management: spot and USDT-M perpetual futures, leverage, margin, TP/SL, flash close	Yes
toobit-cex-portfolio	Account operations: balances, sub-accounts, balance flow, deposit/withdraw, API key check	Yes

Installation

Install skills via the Skills protocol CLI:

npx skills add toobit-docs/agent-skills

This downloads the skill files from the GitHub repository and makes them available to your AI agent.

Prerequisites

• toobit CLI installed:

npm install -g toobit-trade-cli

• For toobit-cex-trade and toobit-cex-portfolio: Toobit API credentials configured in ~/.toobit/config.toml

How Skills Work

1. The AI agent receives a user request (e.g., "What's the price of BTC?")
2. Based on the skill's description field, the agent routes the request to the appropriate skill
3. The agent reads the skill document and follows the command examples
4. Commands are executed via the toobit CLI and results are returned to the user

Skill Format

Each skill is a Markdown file with a YAML frontmatter header:

---
name: skill-name
description: "Trigger description for the AI agent routing system."
license: MIT
metadata:
  author: toobit
  version: "1.0.0"
  agent:
    requires:
      bins: ["toobit"]
---

The description field enumerates natural-language phrases and scenarios that the skill handles, enabling accurate routing by the AI agent.

Skill Details

toobit-cex-market

Read-only market data queries. No API credentials required.

Capabilities:

• Real-time ticker prices (spot & futures)
• Order book / market depth
• Candlestick (OHLCV) data
• Funding rates
• Open interest
• Mark price / index price
• Recent trades
• Long/short ratio
• Exchange info & available symbols

toobit-cex-trade

Order management for spot and USDT-M perpetual futures. Requires API credentials with trading permissions.

Capabilities:

• Place / cancel / amend spot orders (limit, market)
• Place / cancel / amend futures orders
• Set leverage and margin type
• Take profit / stop loss
• Flash close / reverse position
• Query order status, fill history

toobit-cex-portfolio

Account and asset management. Requires API credentials.

Capabilities:

• Account balances (spot & futures)
• Sub-account management
• Balance flow / transaction history
• Deposit address & history
• Withdrawal history
• API key permission check

Related Links

• GitHub: toobit-docs/agent-skills
• npm: toobit-trade-cli