hithink-finance-futures

Futures public information and market data entry point. Select stable commands based on full thscode, variety, and date semantics.

Prerequisites table

Condition	Action
First time using this domain	Read shared rules; content already loaded in the same session can be reused
First execution or version change	View `capabilities --format json` and target `schema <id> --format json`; if the combination rules are unclear, view `--help`
Need to execute a command in the table below	First read the corresponding reference file; do not guess parameters from the command name alone
Whole market, pagination, multiple symbols, or long intervals	Use the `--output <path>` declared by the command to write to disk, and report only a summary

Quick decision

User intent	Preferred command / route
Futures varieties	`futures varieties`
Contract details	`futures contract-detail`
Variety or company positions	`futures variety-positions` / `futures company-variety-positions`
Contract positions	`futures contract-positions` / `futures contract-position-history`
Warehouse receipts or basis	`futures warehouse-receipts` / `futures latest-basis` / `futures basis-history`
Trading schedules	`futures trading-schedule`
Intraday or daily K	`futures intraday` / `futures daily`

Shortcuts

Command	When to use
futures basis-history	Query historical futures basis
futures commodity-indexes	List futures commodity indexes
futures company-variety-positions	Query daily company positions by futures varieties
futures contract-detail	Query futures contract details
futures contract-position-history	Query up to one year of futures contract positions
futures contract-positions	Query daily futures contract positions
futures contracts	List futures contracts
futures daily	Query fixed 1d futures prices
futures intraday	Query current futures session intraday prices
futures latest-basis	Query latest main-continuous futures basis
futures main	List futures main contracts
futures main-continuous	List futures main-continuous contracts
futures position-companies	List futures position companies
futures secondary-main	List futures secondary-main contracts
futures session-timeline	Query futures session timeline
futures trading-schedule	Query futures trading schedule
futures varieties	List public futures varieties
futures variety-plates	List futures variety plates
futures variety-positions	Query daily futures variety positions
futures warehouse-receipts	Query historical futures warehouse receipts

Native commands and schema

hithink-finance capabilities --format json
hithink-finance schema <capability-id> --format json
hithink-finance futures <command> --help

The schema provides the current command options; the reference supplements the business parameter relationships and acceptance methods. For global parameters, credentials, and output conventions, see the shared rules.

Boundary statements

Use the full futures thscode; the variety code must be uppercase and match the contract.
The historical position start date must be within one year before the call date; the start/end of daily must be provided in pairs.
Financial values and dates may be null; legal arrays with no data remain as empty arrays.