Skip to content
cccskills
FreePublished on GitHub

okx-market

Retrieve cryptocurrency prices, candlesticks, order books, funding rates, and open interest from OKX’s public API. Use spot, derivatives, and index data for market research without registering an account or configuring authentication.

OriginalShow the original 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.

Run score Not tested

See how to install

Good for

  • Checking cryptocurrency prices and trading volume
  • Retrieving historical candlestick data
  • Examining funding rates and open interest
  • Inspecting order book depth

Files included (16)

  • SKILL.md5.2 KB
  • references/合约行情/历史资金费率.md1.4 KB
  • references/合约行情/持仓量.md1.1 KB
  • references/合约行情/标记价格.md1.1 KB
  • references/合约行情/资金费率.md1.6 KB
  • references/合约行情/限价.md889 B
  • references/指数行情/指数K线.md1.4 KB
  • references/指数行情/指数行情.md1.3 KB
  • references/现货行情/K线数据.md2.3 KB
  • references/现货行情/交易产品列表.md1.7 KB
  • references/现货行情/最近成交.md954 B
  • references/现货行情/单个行情.md2.0 KB
  • references/现货行情/批量行情.md1.3 KB
  • references/现货行情/深度数据.md1.1 KB
  • scripts/candle_data_example.py3.3 KB
  • scripts/market_data_example.py3.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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 requests dependency.
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 in YYMMDD)
    • Options: BTC-USD-250328-95000-C (expiry-strike-C/P)
    • Index: BTC-USD, ETH-USD
  • 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=0 indicates success, and data is returned in the data field

Link convention: every link to references/ in this document is written relative to this document (for example references/...) — the form GitHub resolves when someone opens the file in a browser. The read_file tool resolves the same string against the skill that owns it, so the agent and a human reader reach one file. When adding new skill docs, always use the relative form, and keep reference paths unique across skills: a path two skills both carry is reported as ambiguous rather than guessed.

Python Script Examples

Market Data Endpoint List

IDEndpoint PathTitle (Detailed Documentation)CategoryDescription
1/market/tickerSingle TickerSpot MarketRetrieve the latest market data for a single trading instrument, including last price, bid/ask, 24h volume, and more
2/market/tickersBatch TickersSpot MarketRetrieve all market data for a given instrument class (SPOT/SWAP/FUTURES/OPTION) in batch
3/market/candlesCandlestick DataSpot MarketRetrieve candlestick (OHLCV) data with multiple supported intervals
4/market/tradesRecent TradesSpot MarketRetrieve recent trade-level details
5/public/instrumentsInstrument ListSpot MarketRetrieve metadata for all tradable instruments, including minimum order size and price precision
6/market/booksOrder Book DepthSpot MarketRetrieve bid/ask order book depth data
7/public/funding-rateFunding RateDerivatives MarketRetrieve current and historical funding rates for perpetual contracts
8/public/funding-rate-historyHistorical Funding RateDerivatives MarketRetrieve historical funding-rate data for perpetual contracts
9/public/mark-priceMark PriceDerivatives MarketRetrieve mark prices for derivatives, used for PnL and liquidation calculations
10/public/open-interestOpen InterestDerivatives MarketRetrieve open-interest data for derivatives
11/public/price-limitPrice LimitDerivatives MarketRetrieve the current maximum and minimum price limits for derivatives
12/market/index-tickersIndex TickersIndex MarketRetrieve index price market data
13/market/index-candlesIndex CandlesIndex MarketRetrieve index candlestick data

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

adr-hshare

FreeSummary

Compare a Chinese company's US depositary receipts, Hong Kong shares, and mainland shares after adjusting for exchange rates and share ratios. Analyze pricing gaps, valuation differences, and delisting risks to support research into its different listings.

  • Compare A-share and H-share pricing gaps
  • Measure ADR premiums against Hong Kong shares
  • Review US delisting risks and Hong Kong listing alternatives
HKUDS/Vibe-Trading36.5KUpdated Oct 23, 2026

akshare

FreeSummary

Retrieve stock prices, futures quotes, exchange rates, and economic indicators with the free Python library AKShare. The skill explains market-specific functions, symbol formats, and data preparation for analysis and testing strategies against historical data.

  • Retrieve historical prices for Chinese, US, and Hong Kong stocks
  • Collect Chinese GDP and consumer price data
  • Check futures quotes and foreign exchange rates
HKUDS/Vibe-Trading36.5KUpdated Oct 23, 2026

alpha-zoo

FreeSummary

Explore bundled libraries of investment factors, signals used to compare securities, and inspect individual formulas and metadata. Evaluate a factor or an entire library across a chosen universe and period, producing aggregate performance statistics and an HTML report.

  • Find bundled momentum or reversal factors
  • Inspect a named factor's formula and metadata
  • Compare a factor library across a chosen universe and period
HKUDS/Vibe-Trading36.5KUpdated Oct 23, 2026

Assess whether a Chinese A-share company may receive ST or *ST risk warnings next financial year. Review financial forecasts, dividends, audit opinions, and regulatory penalties, then report risk severity separately from confidence in the prediction.

  • Reviewing a Chinese A-share company's future ST risk
  • Assessing escalation risk for an existing ST or *ST stock
  • Checking revenue, equity, and dividend warning signs
HKUDS/Vibe-Trading36.5KUpdated Oct 23, 2026

asset-allocation

FreeSummary

Plan portfolio allocations across assets using risk, correlations, return forecasts, and trading costs. Compare five optimization methods, produce settings for config.json, and define rebalancing rules that adjust holdings back toward their target weights.

  • Comparing allocations across stocks, bonds, and gold
  • Choosing an optimizer based on return forecasts and correlations
  • Preparing portfolio settings for config.json
HKUDS/Vibe-Trading36.5KUpdated Oct 23, 2026

Diagnose failed or abnormal backtests, which test trading strategies on historical data. Inspect result files, strategy code, and configuration to identify bugs, make targeted repairs, rerun tests, and verify the updated metrics.

  • Investigating backtest execution errors
  • Finding why a strategy produces no trades
  • Checking delayed trades or low capital usage
HKUDS/Vibe-Trading36.5KUpdated Oct 23, 2026

See all skills by HKUDS

Report a problem with this skill