Agent Skills
› HKUDS/Vibe-Trading
› okx-market
okx-market
GitHub提供OKX V5公开API接口，用于获取加密货币现货、合约等市场数据。无需认证，支持Python调用，涵盖行情、K线及资金费率等实时数据查询功能。
Trigger Scenarios
需要获取加密货币实时价格或行情数据
查询K线历史数据或交易对信息
Install
npx skills add HKUDS/Vibe-Trading --skill okx-market -g -y
SKILL.md
Frontmatter
{
"name": "okx-market",
"category": "data-source",
"description": "OKX cryptocurrency market data interface. Uses the OKX V5 REST API to retrieve spot, derivatives, index, and other crypto market data, including real-time prices, candlesticks, funding rates, open interest, and more. No authentication required, free to use."
}
OKX Market
Overview
The OKX V5 REST API provides comprehensive cryptocurrency market data covering spot, perpetual swaps, delivery futures, options, and more. All market-data endpoints are public and can be called directly without authentication. The data comes from OKX, the world's second-largest cryptocurrency exchange.
Quick Start
- Install a Python runtime (Python 3.9+ recommended) and the required
requestsdependency.
pip install requests pandas
- No account registration or token configuration is required. Market-data endpoints are fully open.
- Review the endpoint documentation below and locate the interface you need.
- Use Python code to retrieve data according to the documentation. Example for the spot ticker endpoint:
import requests
import pandas as pd
BASE_URL = "https://www.okx.com/api/v5"
# Get the latest BTC-USDT market quote
resp = requests.get(f"{BASE_URL}/market/ticker", params={"instId": "BTC-USDT"})
data = resp.json()["data"][0]
print(f"BTC last price: {data['last']} 24h change: {float(data['last'])/float(data['open24h'])*100-100:.2f}%")
Parameter Format Reference
- Instrument format (
instId):- Spot:
BTC-USDT,ETH-USDT - Perpetual swap:
BTC-USDT-SWAP,ETH-USDT-SWAP - Delivery futures:
BTC-USDT-250328(expiry date inYYMMDD) - Options:
BTC-USD-250328-95000-C(expiry-strike-C/P) - Index:
BTC-USD,ETH-USD
- Spot:
- Candlestick interval (
bar):1m,3m,5m,15m,30m,1H,2H,4H,6H,12H,1D,1W,1M - Instrument type (
instType):SPOT(spot),SWAP(perpetual),FUTURES(delivery),OPTION(option) - Timestamp: millisecond Unix timestamp (for example
1773763200000) - Response format: JSON.
code=0indicates success, and data is returned in thedatafield
Link convention: every link to
references/in this document is written with the skill-name prefix (for exampleokx-market/references/...). Theread_filetool resolves paths rooted atskills/, so omitting the prefix makes the read fail. When adding new skill docs, always use the<skill-name>/references/...form.
Python Script Examples
Market Data Endpoint List
| ID | Endpoint Path | Title (Detailed Documentation) | Category | Description |
|---|---|---|---|---|
| 1 | /market/ticker | Single Ticker | Spot Market | Retrieve the latest market data for a single trading instrument, including last price, bid/ask, 24h volume, and more |
| 2 | /market/tickers | Batch Tickers | Spot Market | Retrieve all market data for a given instrument class (SPOT/SWAP/FUTURES/OPTION) in batch |
| 3 | /market/candles | Candlestick Data | Spot Market | Retrieve candlestick (OHLCV) data with multiple supported intervals |
| 4 | /market/trades | Recent Trades | Spot Market | Retrieve recent trade-level details |
| 5 | /public/instruments | Instrument List | Spot Market | Retrieve metadata for all tradable instruments, including minimum order size and price precision |
| 6 | /market/books | Order Book Depth | Spot Market | Retrieve bid/ask order book depth data |
| 7 | /public/funding-rate | Funding Rate | Derivatives Market | Retrieve current and historical funding rates for perpetual contracts |
| 8 | /public/funding-rate-history | Historical Funding Rate | Derivatives Market | Retrieve historical funding-rate data for perpetual contracts |
| 9 | /public/mark-price | Mark Price | Derivatives Market | Retrieve mark prices for derivatives, used for PnL and liquidation calculations |
| 10 | /public/open-interest | Open Interest | Derivatives Market | Retrieve open-interest data for derivatives |
| 11 | /public/price-limit | Price Limit | Derivatives Market | Retrieve the current maximum and minimum price limits for derivatives |
| 12 | /market/index-tickers | Index Tickers | Index Market | Retrieve index price market data |
| 13 | /market/index-candles | Index Candles | Index Market | Retrieve index candlestick data |
Version History
- 0aa45a9 Current 2026-07-24 17:46
