← Back to Skills Marketplace
jolestar

Bybit OpenAPI Skill

by jolestar · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
224
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install bybit-openapi-skill
Description
Operate Bybit V5 public market APIs through UXC with a curated OpenAPI schema, market-first discovery, and explicit private-auth boundary notes.
README (SKILL.md)

Bybit V5 Skill

Use this skill to run Bybit V5 market-data operations through uxc + OpenAPI.

Reuse the uxc skill for shared execution, auth, and error-handling guidance.

Prerequisites

  • uxc is installed and available in PATH.
  • Network access to:
    • https://api.bybit.com
    • optionally https://api-testnet.bybit.com
  • Access to the curated OpenAPI schema URL:
    • https://raw.githubusercontent.com/holon-run/uxc/main/skills/bybit-openapi-skill/references/bybit-v5.openapi.json

Scope

This skill covers a curated Bybit V5 public market surface for:

  • server time
  • instruments metadata
  • tickers
  • order book snapshots
  • kline reads

This skill does not cover:

  • private account endpoints in v1
  • private order placement or cancellation in v1
  • copy trading, earn, broker, or asset management product families

Authentication

Public market endpoints in this skill do not require credentials.

Bybit private APIs use provider-specific header signing that is not yet packaged as a generic uxc signer flow. Keep this v1 skill public-data-only until a reusable Bybit signer path exists.

Region Guardrail

Bybit's official docs note region and IP restrictions. If requests fail unexpectedly, verify that the current execution environment is permitted for Bybit API access before debugging the schema or parameters.

Core Workflow

  1. Use the fixed link command by default:

    • command -v bybit-openapi-cli
    • If missing, create it: uxc link bybit-openapi-cli https://api.bybit.com --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/bybit-openapi-skill/references/bybit-v5.openapi.json
    • bybit-openapi-cli -h

  2. Inspect operation help before execution:

    • bybit-openapi-cli get:/v5/market/time -h
    • bybit-openapi-cli get:/v5/market/instruments-info -h
    • bybit-openapi-cli get:/v5/market/tickers -h

  3. Prefer narrow spot reads first:

    • bybit-openapi-cli get:/v5/market/tickers category=spot symbol=BTCUSDT
    • bybit-openapi-cli get:/v5/market/orderbook category=spot symbol=BTCUSDT limit=20

Operations

  • get:/v5/market/time
  • get:/v5/market/instruments-info
  • get:/v5/market/tickers
  • get:/v5/market/orderbook
  • get:/v5/market/kline

Guardrails

  • Keep automation on the JSON output envelope; do not use --text.
  • Parse stable fields first: ok, kind, protocol, data, error.
  • Treat this v1 skill as read-only.
  • Use category=spot unless the user explicitly needs another market family and has checked the symbol format.
  • bybit-openapi-cli \x3Coperation> ... is equivalent to uxc https://api.bybit.com --schema-url \x3Cbybit_v5_openapi_schema> \x3Coperation> ....

References

Usage Guidance
This skill appears coherent and limited to public read-only Bybit market APIs, but check a few practical things before installing/using: (1) Make sure you have the 'uxc' CLI installed and understand what 'uxc link' will create on your system (it may add a local bybit-openapi-cli wrapper). (2) The included validate.sh is optional but requires jq and ripgrep if you want to run it locally. (3) The skill intentionally avoids private/auth endpoints — do not provide Bybit API keys to this skill unless a vetted signer flow is added later. (4) Confirm you allow network access to api.bybit.com and raw.githubusercontent.com. If any of these points are unexpected, pause and review 'uxc' documentation and the local schema file before proceeding.
Capability Analysis
Type: OpenClaw Skill Name: bybit-openapi-skill Version: 1.0.0 The Bybit V5 skill bundle is a well-structured tool for accessing public cryptocurrency market data. It includes explicit safety guardrails in SKILL.md and references/usage-patterns.md that restrict the agent to read-only public endpoints and warn against attempting private authenticated operations. The validation script (scripts/validate.sh) reinforces these security boundaries by ensuring the presence of 'read-only' and 'public-data-only' documentation before the skill is considered valid.
Capability Assessment
ℹ Purpose & Capability
The skill's name, description, OpenAPI schema, usage examples, and SKILL.md all consistently describe read-only Bybit V5 public market access. One inconsistency: SKILL.md requires the 'uxc' CLI to be installed and on PATH, but the registry metadata lists no required binaries. The included validation script also depends on jq and rg (ripgrep) for local validation. These missing declarations look like bookkeeping omissions rather than functional mismatches, but you should ensure those tools are present before running.
✓ Instruction Scope
Runtime instructions are narrowly scoped to public GET/read operations against Bybit's market endpoints and to creating/using a local 'bybit-openapi-cli' via 'uxc link'. The SKILL.md explicitly forbids private-auth operations and urges read-only behavior. It does not instruct reading unrelated files or exfiltrating data to non-Bybit endpoints.
✓ Install Mechanism
There is no install spec (instruction-only skill), which minimizes risk. The only external URL referenced is a raw.githubusercontent.com link hosting the curated OpenAPI schema — a standard, transparent location. The included validate.sh is a local helper that requires jq and rg if you run it; it does not perform any network installs itself.
✓ Credentials
The skill declares no environment variables or credentials and the SKILL.md clearly states public market endpoints do not require auth. No unrelated credential or secret access is requested. The guidance to keep this v1 skill public-data-only is explicit.
ℹ Persistence & Privilege
The skill is not always-enabled and can be invoked by users. It does instruct using 'uxc link' to create a local 'bybit-openapi-cli' command — that will create a local CLI wrapper via the user's uxc installation (i.e., it can add a command to the environment). This is expected for a CLI-centered workflow but you should confirm what 'uxc link' does on your system before running it.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install bybit-openapi-skill
  3. After installation, invoke the skill by name or use /bybit-openapi-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Bybit OpenAPI Skill v1.0.0 – initial release - Enables access to Bybit V5 public market data via UXC and a curated OpenAPI schema. - Supports server time, instruments info, tickers, order book, and kline reads. - Public-data-only: private/account/order endpoints are not included in this version. - Clear guidance on setup, region restrictions, and recommended workflows provided in documentation. - Authentication not required for supported endpoints; private endpoint access is planned for future versions.
Metadata
Slug bybit-openapi-skill
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Bybit OpenAPI Skill?

Operate Bybit V5 public market APIs through UXC with a curated OpenAPI schema, market-first discovery, and explicit private-auth boundary notes. It is an AI Agent Skill for Claude Code / OpenClaw, with 224 downloads so far.

How do I install Bybit OpenAPI Skill?

Run "/install bybit-openapi-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Bybit OpenAPI Skill free?

Yes, Bybit OpenAPI Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Bybit OpenAPI Skill support?

Bybit OpenAPI Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Bybit OpenAPI Skill?

It is built and maintained by jolestar (@jolestar); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments