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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

futunn_helper-2.0.0.tar.gz (23.4 kB view details)

Uploaded Oct 13, 2025 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

futunn_helper-2.0.0-py3-none-any.whl (12.7 kB view details)

Uploaded Oct 13, 2025 Python 3

File details

Details for the file futunn_helper-2.0.0.tar.gz.

File metadata

Download URL: futunn_helper-2.0.0.tar.gz
Upload date: Oct 13, 2025
Size: 23.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.9.2

File hashes

Hashes for futunn_helper-2.0.0.tar.gz
Algorithm	Hash digest
SHA256	`9c6db6561158e3b460f7efafb63e10c652430a4555a831bdba194038732a6be1`
MD5	`ac8ff14cc4e5a0571e7d0ea3efca45c6`
BLAKE2b-256	`1b3062cda77fe18b7534d66291413fbfdee2a45fef0ea8dc88bbb2f706be7673`

See more details on using hashes here.

File details

Details for the file futunn_helper-2.0.0-py3-none-any.whl.

File metadata

Download URL: futunn_helper-2.0.0-py3-none-any.whl
Upload date: Oct 13, 2025
Size: 12.7 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.9.2

File hashes

Hashes for futunn_helper-2.0.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`20dd1cb485c242b408085a6a4e1eb659be7e600f7836bf1c6ba2304ed3ee87a0`
MD5	`8ec61f90882a4f54074291bf26720fc0`
BLAKE2b-256	`7b7f9383c5ce65c05cc16510a8a6a8a7491d83d85edbc9f87b418b75a822e2ff`