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.