Bybit Exchange AI Trading Skill
Bybit AI Trading Skill — Trade on Bybit using natural language. Covers spot, derivatives, earn, and more. Works with Claude, ChatGPT, OpenClaw, and any AI assistant.
Rank
62
Safety
84
Downloads
1.3k
Updated
Oct 10, 2026
Version
1.5.3
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.3K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.5.3release · observed Aug 7, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17021y052qfqsndcp0pk3trws85r2hz:bybit-exchange-trading-skill- Install using `clawhub skill install s17021y052qfqsndcp0pk3trws85r2hz:bybit-exchange-trading-skill` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/victorwu-bybit/bybit-exchange-trading-skill before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-victorwu-bybit-bybit-exchange-trading-skill/snapshot"
Documentation
CLAWHUB
148,011 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: bybit-trading
description: Bybit AI Trading Skill — Trade on Bybit using natural language. Covers spot, derivatives, earn, and more. Works with Claude, ChatGPT, OpenClaw, and any AI assistant.
metadata:
version: 1.5.8 # Modular Architecture + Security Baseline
author: Bybit
updated: 2026-08-07
license: MIT
---
# Bybit Trading Skill
Trade on Bybit using natural language. Supports spot, linear perpetuals (USDT/USDC), inverse contracts, options, and earn products.
### Rule Priority
When rules in this skill conflict, follow this order: **Safety > User Responsiveness > Convenience**. For example, never skip confirmation to be faster; never block the user's first request to run an auto-update check.
### Auto Update (MUST follow at session start)
This skill supports self-update with integrity verification. At the start of each new session, launch the update check as a **background sub-agent** so it never blocks the user's first request:
```
FOREGROUND (main agent — immediate):
1. Respond to the user's request using the current local version. Do NOT wait for the update check.
BACKGROUND (sub-agent — parallel):
1. LOCAL_VERSION = metadata.version (from YAML frontmatter above)
2. SKILL_DIR = directory where this SKILL.md is located
3. MANIFEST = curl -sf -H "User-Agent: bybit-skill/1.5.8" https://api.bybit.com/skill/manifest
(returns JSON: {"version":"x.y.z", "files":{"SKILL.md":"sha256:...","modules/market.md":"sha256:...",...}})
4. If fetch fails: return {status: "error", reason: "fetch_failed"}
5. Path validation: For each file in manifest.files, reject the entire update if ANY path:
- Does not match `SKILL.md`, `modules/<name>.md`, or `modules/<name>.js` (where <name> is [a-z0-9-]+)
- Contains `..`, starts with `/` or `~`, contains backslashes, or has an extension other than `.md` or `.js`
If any path is invalid: return {status: "error", reason: "invalid_path", path: "<rejected>"}
6. Version comparison (semver): split by ".", compare major → minor → patch numerically.
If manifest.version > LOCAL_VERSION:
a. For each file in manifest.files:
- Download: curl -sf -H "User-Agent: bybit-skill/1.5.8" https://raw.githubusercontent.com/bybit-exchange/skills/main/<file>
- Save content to temp file, then compute SHA256: shasum -a 256 <temp_file> | awk '{print $1}'
- Compare with manifest checksum (strip "sha256:" prefix)
- If mismatch: ABORT entire update. return {status: "error", reason: "checksum_mismatch", file: "<file>"}
- If file extension is `.js` AND the local file already exists at SKILL_DIR/<file>:
→ Show to user: "⚠️ Code module update: <file> (LOCAL_VERSION → manifest.version). Allow? [Y/n]"
→ If user declines: skip this file, continue with remaining files
- If match: save to SKILL_DIR/.skill-update-tmp/<file>
b. ALL files verified → move from temp to SKILL_DIR:
- For each file: mkdir -p parent dir, then mv .skill-update-tmp/<file> SKILL_DIR/<file>README.md
# Bybit AI Trading Skill Trade on Bybit using natural language. Tell any AI assistant one sentence, and it can execute trades, check markets, manage positions, and more — zero installation required. **Version:** 1.5.8 | **License:** MIT ## How It Works Copy the following line and send it to your AI assistant: ``` Please read https://raw.githubusercontent.com/bybit-exchange/skills/main/SKILL.md, save it as a skill, and help me trade on Bybit. ``` The AI will download and install the skill automatically — then you can start trading in natural language. No npm packages, no CLI tools, no config files. ## Supported AI Platforms Works with any AI assistant that can read files or URLs: - OpenClaw - Claude (Code, Desktop, API) - ChatGPT - Gemini - Cursor / Windsurf - Codex ## Capabilities | Module | What Users Can Do | |--------|-------------------| | **Market** | Real-time prices, klines (13 intervals), orderbook (500 levels), funding rates, open interest, volatility | | **Spot** | Market/limit orders, batch orders (20/batch), cancel, amend, spot margin | | **Derivatives** | Long/short, leverage, TP/SL, trailing stop, conditional orders, hedge mode, margin adjustment | | **Earn** | Flexible saving, on-chain staking, dual assets (structured products with BuyLow/SellHigh) | | **Account** | Balances, internal transfers, deposit addresses, fee rates, sub-accounts, asset conversion | | **Advanced** | WebSocket streams, crypto loans, RFQ block trades, spread trading, broker management | | **Strategy** | TWAP, iceberg orders, chase orders, algorithmic execution | | **Trading Bot** | Spot/futures grid bots, DCA bots, martingale, combo bots | | **Copy Trading** | Follow top traders, classic and TradFi copy trading | | **Alpha Trade** | On-chain DEX token swaps, meme coins, quote-then-execute model | | **Pay** | QR payments, refunds, recurring agreement billing | | **Fiat** | Fiat-to-crypto OTC, P2P ads and order management | ## Quick Start ### 1. Get an API Key 1. Log in to [Bybit](https://www.bybit.com) → API Management → Create New Key 2. Enable **Read + Trade** permissions only (never enable Withdraw for AI use) 3. Recommended: bind your IP and use a dedicated sub-account with limited balance ### 2. Configure Credentials **Local CLI** (Claude Code, Cursor, etc.): ```bash export BYBIT_API_KEY="your_api_key" export BYBIT_API_SECRET="your_secret_key" export BYBIT_ENV="mainnet" # or "testnet" ``` **OpenClaw** — use `.env` file: ```bash # ~/.openclaw/.env BYBIT_API_KEY=your_api_key BYBIT_API_SECRET=your_secret_key BYBIT_ENV=mainnet ``` **Cloud AI** (ChatGPT, Gemini) — the AI will ask for credentials interactively and keep them in memory for the session only. ### 3. Start Trading Just tell the AI what you want in natural language. The skill handles the rest. ## Security | Feature | Description | |---------|-------------| | **Mainnet by default** | Users start on mainnet with full trade confirmation; can switch to testnet for practice | | *
_meta.json
{
"ownerId": "kn73qn0ns1g1ppjrwhxry7r81582v7v1",
"slug": "bybit-exchange-trading-skill",
"version": "1.5.3",
"publishedAt": 1786097291966
}modules/account.md
# Module: Account & Asset Management
> This module is loaded on-demand by the Bybit Trading Skill. Authentication required.
## Scenario: Account & Asset Management
User might say: "Check my balance", "Transfer from spot to derivatives", "Show today's trade history"
**View wallet balance**
```
GET /v5/account/wallet-balance?accountType=UNIFIED
```
**View fee rate**
```
GET /v5/account/fee-rate?category=linear&symbol=BTCUSDT
```
**Internal transfer (spot <-> derivatives <-> funding account)**
```
POST /v5/asset/transfer/inter-transfer
{"transferId":"uuid","coin":"USDT","amount":"1000","fromAccountType":"UNIFIED","toAccountType":"FUND"}
```
**View trade history**
```
GET /v5/execution/list?category=linear&symbol=BTCUSDT
```
**View realized PnL**
```
GET /v5/position/closed-pnl?category=linear&symbol=BTCUSDT
```
**Fixed-rate borrow (borrow USDT at fixed rate for 7 days)**
```
POST /v5/spot-margin-trade/fixedborrow
{"orderCurrency":"USDT","orderAmount":"1000","annualRate":"0.02","term":"7","repayType":"1","strategyType":"PARTIAL"}
```
**Query borrow liability breakdown**
```
GET /v5/spot-margin-trade/liability?currency=USDT
```
**Repay with repayment type (fixed-rate liabilities only)**
```
POST /v5/account/repay
{"coin":"USDT","amount":"100","repaymentType":"FIXED"}
```
---
## Insufficient Balance — Transfer Guide
When an operation fails due to insufficient balance, assist the user by checking if funds are available elsewhere.
### Behavior
```
Operation fails: insufficient balance
|
v
Step 1: Check sub-account funding account
├── Has enough → inform user and ask if they want to transfer
└── Not enough → continue
|
v
Step 2: Check master funding account
├── Has enough → inform user and ask if they want to transfer
└── Not available → continue
|
v
Step 3: No available source found
→ Report insufficient balance only. No further guidance.
```
### Rules
1. Only check sub-account internal balance and master funding account.
2. If funds are found: inform user, wait for explicit transfer request before executing.
3. If no funds found or unable to determine: report "insufficient balance" only — no suggestions, no app links.
4. This guide does not modify existing transfer execution behavior. User-initiated transfers execute as normal regardless of source.
### Permission Error Handling
When a transfer fails due to permission restrictions, the permission name can be identified from the error response:
| retCode | Blocked Permission |
|---------|--------------------|
| 131234 | Transfer In |
| 131235 | Transfer Out |
Guide the user to enable the corresponding permission in App settings.
---
## API Reference
### Account (authentication required)
| Endpoint | Path | Method | Required Params | Optional Params | Categories |
|----------|------|--------|----------------|-----------------|------------|
| Wallet Balance | `/v5/account/wallet-balance` | GET | accountType | coin | — |
| Asset Overvmodules/activity.md
# Module: Spot-X Activities (Launchpool, Puzzle, Token Splash) > This module is loaded on-demand by the Bybit Trading Skill. Spot-X campaign activities: **Launchpool** (stake coins to earn new-token rewards), **Puzzle**, and **Token Splash** (deposit / trade tasks for rewards). Project-list endpoints are public (no authentication); user-specific endpoints require API key authentication. All endpoints here are **read-only queries** — this module browses activities and reports a user's participation; it does not register, stake, or redeem. ## API Reference ### Launchpool (`/v5/spot-x/launchpool/`) | Endpoint | Path | Method | Required Params | Optional Params | Categories | |----------|------|--------|----------------|-----------------|------------| | Project List | `/v5/spot-x/launchpool/project/list` | GET | status | activityCoin, projectId, cursor, limit | — | | User Current Staking | `/v5/spot-x/launchpool/user/current-staking` | GET | — | — | — | | User Activity Log | `/v5/spot-x/launchpool/user/activity-log` | POST | — | stakeCoin, type, status, startTime, endTime, pageSize, current | — | | User History | `/v5/spot-x/launchpool/user/history` | POST | — | stakeCoin, rewardCoin, startTime, endTime, pageSize, current | — | ### Puzzle (`/v5/spot-x/puzzle/`) | Endpoint | Path | Method | Required Params | Optional Params | Categories | |----------|------|--------|----------------|-----------------|------------| | Project List | `/v5/spot-x/puzzle/project/list` | GET | status | projectId, activityCoin, cursor, limit | — | ### Token Splash (`/v5/spot-x/token-splash/`) | Endpoint | Path | Method | Required Params | Optional Params | Categories | |----------|------|--------|----------------|-----------------|------------| | Project List | `/v5/spot-x/token-splash/project/list` | GET | status | projectId, activityCoin, cursor, limit | — | | User Activity Params | `/v5/spot-x/token-splash/user/activity-params` | GET | — | projectId, activityCoin | — | ## Endpoint Notes ### Authentication - **Public (no auth)**: all three `project/list` endpoints. - **API key required**: `launchpool/user/*` and `token-splash/user/activity-params` (user identity injected by the gateway). ### Project List endpoints (Launchpool / Puzzle / Token Splash) - `status` is **required**: `0` Upcoming, `1` Ongoing, `2` Ended. Results sorted newest-first. - Cursor-based pagination: pass the previous response's `nextPageCursor` as `cursor`. Empty-string `nextPageCursor` means last page. `limit` default `10`, max `10`. - Only online/released main-site public activities are returned. - Launchpool items include a `pools[]` array (per-pool `stakeCoin`, `apr`, `totalStakedAmount`, `participantCount`). - Token Splash: `registrationStartTime` = min(non-zero `signUpBeginTime`, `tradeSignUpBeginTime`); `activityEndTime` = max(`announceTime`, `tradeAnnounceTime`). ### Launchpool User Current Staking (`/v5/spot-x/launchpool/user/current-staking`) - No parameters. Returns a USD portfo
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/victorwu-bybit/skills/bybit-exchange-trading-skill",
"sourceUrl": "https://clawhub.ai/victorwu-bybit/skills/bybit-exchange-trading-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T16:18:23.617Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-victorwu-bybit-bybit-exchange-trading-skill/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-victorwu-bybit-bybit-exchange-trading-skill/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T16:18:23.617Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.3K downloads",
"href": "https://clawhub.ai/victorwu-bybit/bybit-exchange-trading-skill",
"sourceUrl": "https://clawhub.ai/victorwu-bybit/bybit-exchange-trading-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T16:18:23.617Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.5.3",
"href": "https://clawhub.ai/victorwu-bybit/bybit-exchange-trading-skill",
"sourceUrl": "https://clawhub.ai/victorwu-bybit/bybit-exchange-trading-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-07T10:08:11.966Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-victorwu-bybit-bybit-exchange-trading-skill/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-victorwu-bybit-bybit-exchange-trading-skill/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.5.3",
"description": "**Version 1.5.3 Changelog** - Added new module files: modules/activity.md and modules/oauth.js. - Removed outdated or deprecated files: modules/aurora.md and skill-card.md. - Bumped skill version, metadata, and manifest references from 1.5.2 to 1.5.8. - Updated documentation to reflect recent changes and improvements in modular structure.",
"href": "https://clawhub.ai/victorwu-bybit/bybit-exchange-trading-skill",
"sourceUrl": "https://clawhub.ai/victorwu-bybit/bybit-exchange-trading-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-07T10:08:11.966Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
