For Agents
Trade on Bybit V5: read market data, place, amend, and cancel orders, list positions, query wallet balances, and initiate asset withdrawals. Authenticate with X-BAPI-API-KEY plus signed X-BAPI-SIGN and X-BAPI-TIMESTAMP headers.
Get started with Bybit V5 API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"amend a bybit order"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Bybit V5 API API.
Read klines, orderbook, tickers, and instrument metadata across spot and derivatives
Place new orders with full Bybit V5 parameter support
Amend an existing open order's price or quantity
Cancel open orders and list currently active orders
List open positions across account types
GET STARTED
Use for: I need to place a limit order on BTCUSDT perpetual, Amend an open order's limit price, List all open positions in my unified account, Cancel an order by orderId
Not supported: Does not handle on-chain transfers outside the withdraw flow, fiat on-ramp KYC, or tax reporting — use for Bybit V5 trading, position, wallet, and withdrawal operations only.
Jentic publishes the only available OpenAPI document for Bybit V5 API, keeping it validated and agent-ready.
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. This spec covers the V5 API across market data, order placement and amendment, position listing, account wallet queries, and asset withdrawals — broader than the bybit-exchange.github.io main slice. Authentication uses an API key plus HMAC-SHA256 signature and timestamp headers.
Query wallet balances across unified, contract, and spot accounts
Initiate asset withdrawals to whitelisted addresses
Patterns agents use Bybit V5 API API for, with concrete tasks.
★ Programmatic Trading and Position Management
Run a full trading lifecycle through one spec — place, amend, and cancel orders, then track resulting positions via /v5/position/list. Quant teams use this when they need order amendment without cancel-and-replace and a unified view across spot and derivatives. Initial integration takes 1-2 days including signature handling.
Place a limit buy on BTCUSDT, watch /v5/position/list for fill, then amend the take-profit price via POST /v5/order/amend
Treasury and Withdrawal Automation
Automate periodic sweeps of stablecoin balances from the exchange to a custodial address using /v5/asset/withdraw/create. Treasury teams use this to enforce balance caps on the exchange and reduce custodial risk. Withdrawals require a whitelisted address configured in the Bybit account.
When USDT spot balance exceeds 100,000, POST /v5/asset/withdraw/create to move the excess to the whitelisted treasury address
Risk and Margin Monitoring
Combine /v5/account/wallet-balance, /v5/position/list, and /v5/order/realtime to feed a real-time risk dashboard. Risk teams use this to monitor margin utilisation, unrealised PnL, and open order exposure across the firm's Bybit accounts. Polling at moderate cadence keeps within rate limit budgets.
Every 60 seconds, fetch wallet balance and position list, compute margin utilisation, and alert if it exceeds 70%
Market Data Capture for Research
Capture historical klines and live orderbook snapshots across spot and derivatives for backtesting, microstructure research, or feature engineering. The market endpoints are unauthenticated for read-only access, so this can be parallelised aggressively.
For 100 symbols, fetch 1-hour klines for the last 90 days from /v5/market/kline and write to a research datastore
AI Agent Trading Operations
Through Jentic, an AI agent can execute Bybit V5 trading and treasury operations using natural language intent. The signature is computed at execution time so the raw secret never enters the agent context. Useful for assistants that monitor or rebalance positions under guarded conditions.
Search Jentic for 'amend a bybit order', load the schema for POST /v5/order/amend, and execute with category, symbol, orderId, and the new price
11 endpoints — jentic publishes the only available openapi specification for bybit v5 api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/v5/market/kline
Read kline data
/v5/market/orderbook
Read live orderbook
/v5/order/create
Place an order
/v5/order/amend
Amend an open order
/v5/order/cancel
Cancel an open order
/v5/position/list
List open positions
/v5/account/wallet-balance
Query wallet balance
/v5/asset/withdraw/create
Initiate an asset withdrawal
/v5/market/kline
Read kline data
/v5/market/orderbook
Read live orderbook
/v5/order/create
Place an order
/v5/order/amend
Amend an open order
/v5/order/cancel
Cancel an open order
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 and X-BAPI-TIMESTAMP are computed at execution time so raw secrets never enter the agent's context window.
Intent-based discovery
Agents search by intent (e.g., 'amend 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, and error handling. Through Jentic: under 1 hour for the first working call.
Alternatives and complements available in the Jentic catalogue.
Bybit V5 API (curated)
Lighter 8-endpoint slice without amend, position list, or withdrawals
Use the lighter spec when you only need market data, simple order create/cancel, and wallet balance
Binance
Major crypto exchange with deep liquidity across spot and derivatives
Choose Binance for the largest spot order book and broader product coverage
Kraken
Crypto exchange with strong spot and futures coverage
Use Kraken when fiat on-ramp coverage and US-friendly compliance matter
OKX
Crypto exchange with derivatives and on-chain products
Pair with Bybit for cross-exchange arbitrage or risk diversification
Specific to using Bybit V5 API 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 X-BAPI-API-KEY, an HMAC-SHA256 signature in X-BAPI-SIGN, and a millisecond timestamp in X-BAPI-TIMESTAMP. Through Jentic, the secret is held in the encrypted vault and the signature is computed at execution time.
Can I amend an open order with this API?
Yes. POST /v5/order/amend updates an open order's price or quantity in place — useful for adjusting limit orders without the cancel-and-replace race window. The /bybit-exchange.github.io/main spec does not include this endpoint.
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 are looser than authenticated trade endpoints. Watch for 429 / Bybit-specific rate-limit codes and back off rather than retrying immediately.
How do I initiate a withdrawal through Jentic?
Run pip install jentic, then search Jentic with the query 'withdraw bybit asset', load the schema for POST /v5/asset/withdraw/create, and execute with the coin, chain, address, and amount fields. The address must be whitelisted in your Bybit account.
How does this spec differ from the bybit-exchange.github.io main spec?
Both target the live Bybit V5 API at api.bybit.com. This spec covers 11 endpoints including /v5/order/amend, /v5/position/list, and /v5/asset/withdraw/create. The bybit-exchange.github.io main spec covers a tighter 8-endpoint slice without amend, position list, or withdrawals.
/v5/position/list
List open positions
/v5/account/wallet-balance
Query wallet balance
/v5/asset/withdraw/create
Initiate an asset withdrawal