futunn-helper

Asynchronous Python client for Futunn stock market quote API.

Features

🚀 Async/await support with httpx
🌍 Multiple markets (US, HK, CN, SG, AU, JP, MY, CA)
🔐 Automatic token management
📊 Real-time stock data
⚡ Concurrent request handling

Installation

pip install futunn-helper

Quick Start

import asyncio
from futunn import FutunnClient

async def main():
    client = FutunnClient()
    
    # Get top turnover US stocks
    stocks = await client.get_stock_list(
        market_type=2,      # US market
        rank_type=5,        # Top turnover
        page_size=50
    )
    
    print(f"Total: {stocks.pagination.total} stocks")
    for stock in stocks.stocks[:5]:
        print(f"{stock.stock_code}: ${stock.price_nominal}")

asyncio.run(main())

Requirements

Python >= 3.11
httpx[http2] >= 0.27.0

License

MIT License

Metadata

Release files for futunn-helper 2.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for futunn-helper 2.0.0
File	Size	Uploaded
futunn_helper-2.0.0.tar.gz	23.4 kB	Oct 13, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for futunn-helper 2.0.0
File	Interpreter	ABI	Platform	Reset
futunn_helper-2.0.0-py3-none-any.whl 12.7 kB Oct 13, 2025	Python 3	none	any	Details

Total release size: 36.0 kB

Release files / futunn_helper-2.0.0.tar.gz

Download URL	futunn_helper-2.0.0.tar.gz
Size	23.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`9c6db6561158e3b460f7efafb63e10c652430a4555a831bdba194038732a6be1`
BLAKE2b-256 checksum How to use checksums	`1b3062cda77fe18b7534d66291413fbfdee2a45fef0ea8dc88bbb2f706be7673`
Upload date	Oct 13, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.9.2`

Release files / futunn_helper-2.0.0-py3-none-any.whl

Download URL	futunn_helper-2.0.0-py3-none-any.whl
Size	12.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`20dd1cb485c242b408085a6a4e1eb659be7e600f7836bf1c6ba2304ed3ee87a0`
BLAKE2b-256 checksum How to use checksums	`7b7f9383c5ce65c05cc16510a8a6a8a7491d83d85edbc9f87b418b75a822e2ff`
Upload date	Oct 13, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.9.2`