# Tushare Futures

> tushare-futures: Futures Queries

- Skill: `oopslink/tushare-futures` (Agent Skill)
- Install (CLI): `npx skillmds@latest add oopslink/tushare-futures`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oopslink/tushare-futures/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: oopslink (https://skillmd.com/u/oopslink)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/oopslink/tushare-futures

---


# tushare-futures: Futures Queries

## Commands

```bash
# All contracts for an exchange
tushare-cli futures contracts --exchange CFFEX    # CFFEX / DCE / SHFE / CZCE

# Institutional holdings for a contract
tushare-cli futures holdings --ts-code IF2403.CFX

# Intraday minute bars
tushare-cli futures minute --ts-code IF2403.CFX

# NanHua commodity index
tushare-cli futures nh-index --ts-code NH0100.NHF

# Warehouse receipts
tushare-cli futures wsr --trade-date 20240201
```

## Common Workflow

### Top holders for a contract
```bash
tushare-cli --format json futures holdings --ts-code IF2406.CFX | \
  jq 'sort_by(-.vol) | .[:5]'
```