Bybit Exchange Bybit V5 API
★ Only Publicly Available OpenAPI DocumentFinanceBankingapiKey8 EndpointsREST
For Agents
Read Bybit market data, place and cancel orders, and query wallet balances. Authenticate with an X-BAPI-API-KEY plus signed X-BAPI-SIGN header.
Use for: Get the latest kline data for BTCUSDT on the 1-hour interval, Fetch the current orderbook for ETHUSDT on derivatives, Retrieve the 24-hour ticker for the top 20 spot pairs, Place a market buy order for 0.1 BTC
Not supported: Does not handle on-chain transfers, fiat on-ramp KYC, or tax reporting — use for Bybit V5 market data, order placement, and wallet balance queries only.
Jentic publishes the only available OpenAPI specification for Bybit V5 API, keeping it validated and agent-ready. Bybit is a cryptocurrency derivatives and spot exchange. The V5 API exposes market data — klines, orderbook, tickers, instrument info — plus trading operations and account wallet queries. This curated spec covers the most commonly used endpoints; the bybit.com main spec adds position management, asset withdrawals, and order amends. Authentication uses an API key plus HMAC-SHA256 signature header.
Install Jentic One Beta
Connect the Bybit V5 API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Bybit V5 API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Bybit V5 API.
Read kline (candlestick) data for any tradable instrument
Fetch the live orderbook and 24-hour ticker stats
Look up instrument metadata such as tick size and contract details
Place and cancel orders against spot or derivatives markets
List the trader's currently active orders
Query the wallet balance across account types
Use Cases
Patterns agents use Bybit V5 API for, with concrete tasks.
★ Algorithmic Trading Loop
Drive a live trading loop that reads market data via /v5/market/kline and /v5/market/orderbook, computes a signal, and submits orders through /v5/order/create. Quantitative traders use this for systematic spot or perpetual futures strategies. The V5 surface is unified across product types so the same loop can target spot or derivatives.
Pull 1-minute klines for BTCUSDT, compute a moving-average crossover, and submit a market order via POST /v5/order/create when the signal flips
Market Data Capture
Capture historical and live market data for backtesting, research, or analytics dashboards. Researchers use /v5/market/kline for historical bars, /v5/market/orderbook for snapshots, and /v5/market/tickers for cross-section pricing. All four market endpoints are unauthenticated for read-only access.
For each of 50 tracked symbols, fetch 1-day klines for the last 365 days and write to a parquet file for backtesting
Portfolio Monitoring
Monitor open orders and wallet balances continuously by polling /v5/order/realtime and /v5/account/wallet-balance. Useful for risk dashboards or alerting when positions or balances deviate from expected ranges. Polling at a moderate interval keeps within rate-limit budgets.
Every 30 seconds, fetch /v5/account/wallet-balance and post an alert when total equity drops more than 5% inside an hour
AI Agent Trading Operations
Through Jentic, an AI agent can execute Bybit market and trading operations using natural language intent, with the API key kept out of the agent context. Useful for assistants that monitor positions, hedge exposure, or rebalance on a trader's behalf under guarded conditions.
Search Jentic for 'place a bybit order', load the schema for POST /v5/order/create, and execute with category, symbol, side, orderType, and qty
Key Endpoints
8 endpoints — jentic publishes the only available openapi specification for bybit v5 api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/v5/market/kline
Read kline (candlestick) data
GET
/v5/market/orderbook
Read the live orderbook
GET
/v5/market/tickers
Read 24h ticker stats
GET
/v5/market/instruments-info
Read instrument metadata
POST
/v5/order/create
Place a new order
POST
/v5/order/cancel
Cancel an open order
GET
/v5/order/realtime
List active orders
GET
/v5/account/wallet-balance
Query wallet balance
GET
/v5/market/kline
Read kline (candlestick) data
GET
/v5/market/orderbook
Read the live orderbook
GET
/v5/market/tickers
Read 24h ticker stats
GET
/v5/market/instruments-info
Read instrument metadata
POST
/v5/order/create
Place a new order
POST
/v5/order/cancel
Cancel an open order
GET
/v5/order/realtime
List active orders
GET
/v5/account/wallet-balance
Query wallet balance
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Bybit API keys are stored encrypted in the Jentic vault. The X-BAPI-SIGN HMAC signature is computed at execution time so raw secrets never enter the agent's context window.
Intent-based discovery
Agents search by intent (e.g., 'place a bybit order') and Jentic returns the matching operation with its input schema.
Time to first call
Direct Bybit V5 integration: 1-2 days for auth, signature handling, and error mapping. Through Jentic: under 1 hour for the first working call.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Bybit V5 API through Jentic.
Why is there no official OpenAPI spec for Bybit V5 API?
Bybit does not publish a single OpenAPI specification covering the V5 API. Jentic generates and maintains this spec so that AI agents and developers can call Bybit V5 API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Bybit V5 API use?
Authenticated endpoints require an API key in the X-BAPI-API-KEY header plus a request signature in the X-BAPI-SIGN header (HMAC-SHA256). Through Jentic, the secret is held in the encrypted vault and the signature is computed at execution time so raw secrets never enter the agent's context.
Can I place orders with this API?
Yes. POST /v5/order/create places a new order on spot or derivatives markets; POST /v5/order/cancel cancels an open order. The category and symbol parameters select the product type and instrument.
What are the rate limits for the Bybit V5 API?
Rate limits vary by endpoint and account tier and are not enumerated in the spec. Public market endpoints have looser limits than authenticated trade endpoints. Watch for 10006 / 429 responses and back off rather than retrying immediately.
How do I read the orderbook through Jentic?
Run pip install jentic, then search Jentic with the query 'read bybit orderbook', load the schema for GET /v5/market/orderbook, and execute with the category and symbol parameters set to your target market.
How does this spec differ from the bybit.com main spec?
Both target the live Bybit V5 API. This spec covers 8 commonly used endpoints across market, trade, and account. The bybit.com main spec adds position listing, order amends, and asset withdrawals for broader account operations.
GET STARTED