futuapi

Query market data and execute trades through the Futu OpenAPI Python SDK.

1.5k|337|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/qusong0627/QuantMind --skill futuapi-qusong0627
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: futuapi
Source: https://github.com/qusong0627/QuantMind/tree/main/skills/futuapi
Command: npx skills add https://github.com/qusong0627/QuantMind --skill futuapi-qusong0627

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires futu-api, pandas, and includes scripts (resource) and references (resource) components.

What problem does it solve? It gives AI assistants a structured, script-driven way to interact with the Futu OpenAPI, so users can fetch quotes, K-lines, options chains, fundamentals, and place or manage orders without writing SDK boilerplate themselves. ## Core Features & Use Cases - Market Data & Screening: Retrieve quotes, snapshots, K-lines, order books, capital flow, sector data, and run V1/V2 stock screeners across HK, US, A-share, SG, MY, and JP markets. - Trading & Account Management: Place, modify, and cancel orders (simulate by default, real trading with two-step confirmation), and query positions, funds, orders, and deals with APP-aligned field mapping. - Derivatives & Crypto: Query option chains, IV, strategy P&L, warrants, futures via OpenFutureTradeContext, prediction market event contracts, and BTC/ETH crypto quotes and trading. - Use Case: Ask "show my current positions and diagnose concentration risk" and the skill runs get_portfolio.py, applies the correct APP-aligned P&L fields, and returns a structured diagnostic report. ## Quick Start Ask the assistant to check the latest quote and recent daily K-line for HK.00700 using the futuapi skill.

Frequently Asked Questions about futuapi

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I place an order with the Futu OpenAPI Python SDK?▼

Use place_order.py with the security code, side, quantity, and price; the market is inferred from the code prefix. Orders default to the SIMULATE environment, and real orders require a two-step flow with a --confirmed flag plus manual trade unlock in the OpenD GUI.

How to get real-time quotes and K-line data from Futu OpenAPI?▼

Run the quote scripts under scripts/quote, such as get_snapshot.py or the K-line scripts, with codes like HK.00700 or US.AAPL. Real-time streaming requires subscribing first, while snapshots and history K-lines work without subscription but consume quota.

Does Futu OpenAPI support cryptocurrency trading?▼

Yes, via OpenCryptoTradeContext in futu-api 10.5.6508 or higher, supporting BTC and ETH pairs like CC.BTCUSD. Crypto trading is real-money only, limited to FUTUSECURITIES, FUTUINC, and FUTUSG, with fractional quantities allowed.

Why does Futu OpenAPI return unlock needed when placing real orders?▼

Real trading requires unlocking the trade password manually in the OpenD GUI before API orders are accepted. The SDK's unlock_trade call is intentionally blocked for security, so click Unlock Trade in the OpenD interface and retry.

What are the Futu OpenAPI rate limits and quotas?▼

place_order is limited to 15 calls per 30 seconds and order queries to 10 per 30 seconds. Subscription and history K-line quotas range from 100 to 2000 depending on account assets and trading activity, so check get_history_kl_quota before batch requests.

Can I trade futures through the Futu OpenAPI scripts?▼

Futures require OpenFutureTradeContext rather than the securities context used by standard scripts. Generate code directly against OpenFutureTradeContext for contracts like SG.CNmain, or use --ctx-type FUTURE for prediction market EC codes.