Skip to content
Skillv1.0.0

tiger

Tiger Brokers (TigerOpen) — US/HK/A-share stocks. Account, positions, orders, quotes, history, and order placement (paper + live). Use when the user wants to check or trade a Tiger / 老虎证券 account (e.g

by starchild-ai-agent(0) 0 installs
Free
Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from starchild-ai-agent/official-skills (tiger/SKILL.md). Install upstream with npx skills add starchild-ai-agent/official-skills --skill tiger. Copyright stays with the author.

What this is

☁️ Cloud broker — runs directly in the container via the official tigeropen SDK. Covers US, HK, and A-share markets.

Auth is RSA-signed static key: a tiger_id + a local PKCS#1 private key (PEM) + your account number. No OAuth, no token refresh.

Paper/live guard: a Tiger paper (sandbox) account number is exactly 17 numeric digits (e.g. 20191106192858300); standard/global accounts are not. The chosen --profile must match the account format or the command fails closed. Live placement additionally requires --confirm-live. Note: paper accounts don't support GTC, so it's auto-forced to DAY.

Get your credentials

  1. Open a Tiger account and apply for API access at the Tiger Open Platform (登录 → 开发者 / API).
  2. Generate an RSA key pair (the platform requires PKCS#1). On any machine:
    openssl genrsa -out tiger_private_key.pem 2048      # PKCS#1 private key
    openssl rsa -in tiger_private_key.pem -pubout -out tiger_public_key.pem
  3. On the Open Platform, paste the public key content (between the BEGIN/END lines) to bind it. Note your tiger_id (developer id) shown there.
  4. Find your account number: paper account from the sandbox/模拟 section (17 digits); live/standard account from your real account page.
  5. Keep the private key safe — it never leaves your machine. Provide either its file path or paste the PEM contents via secure input.

Configure (.env)

Request via secure input — never paste keys/PEM in chat.

Variable Required Notes
TIGER_ID yes developer tiger_id
TIGER_PRIVATE_KEY_PATH one of these path to the PKCS#1 PEM file
TIGER_PRIVATE_KEY one of these inline PEM (use \n for newlines); written to ~/.tiger_private_key.pem (0600)
TIGER_PAPER_ACCOUNT for paper 17-digit sandbox account (or set TIGER_ACCOUNT)
TIGER_LIVE_ACCOUNT for live real account number (or set TIGER_ACCOUNT)

TIGER_ACCOUNT is a fallback used by whichever profile if the profile-specific var isn't set.

Usage

pip install tigeropen (first run; already present in this workspace). JSON output. Default profile paper.

python skills/tiger/scripts/tiger_cli.py status
python skills/tiger/scripts/tiger_cli.py account
python skills/tiger/scripts/tiger_cli.py positions
python skills/tiger/scripts/tiger_cli.py orders [--executions]
python skills/tiger/scripts/tiger_cli.py quote --symbol AAPL
python skills/tiger/scripts/tiger_cli.py history --symbol AAPL --period 1d --limit 90
# place (paper): qty in units only; market or limit; --currency default USD
python skills/tiger/scripts/tiger_cli.py place --symbol AAPL --side buy --qty 1 --type market
python skills/tiger/scripts/tiger_cli.py place --symbol AAPL --side buy --qty 1 --type limit --limit-price 180 --tif day
python skills/tiger/scripts/tiger_cli.py cancel --order-id <id>
# live:
python skills/tiger/scripts/tiger_cli.py --profile live --confirm-live place --symbol AAPL --side buy --qty 1

Periods: 1m 5m 15m 30m 1h 1d 1w 1M (note: 1m=minute, 1M=month, case-sensitive). Symbols are bare tickers (AAPL, 00700) — set --currency (USD/HKD/...) for non-USD.

Gotchas

  • Tiger has no notional path for stocks — always use --qty (units), never --notional.
  • status validates the profile/account match (17-digit guard) and pings assets. Run it first.
  • If you bound the public key but get auth errors, confirm the key is PKCS#1 (the openssl genrsa output), not PKCS#8.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml
targets:
  - https://api.opensmartroute.ai/api/v1/registry/starchild-ai-agent-official-skills-tiger/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

starchild-ai-agent-official-skills-tiger.ocm.jsonjson
{
  "ocm": "1",
  "id": "starchild-ai-agent-official-skills-tiger",
  "kind": "skill",
  "name": "tiger",
  "description": "Tiger Brokers (TigerOpen) — US/HK/A-share stocks. Account, positions, orders, quotes, history, and order placement (paper + live). Use when the user wants to check or trade a Tiger / 老虎证券 account (e.g. \"Tiger account assets\", \"buy 100 700.HK on Tiger\", \"my Tiger positions\"). Cloud API via the official tigeropen SDK, runs in the container.",
  "publisher": "starchild-ai-agent",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "tiger",
      "tigeropen",
      "broker",
      "us-stocks",
      "hk-stocks",
      "trading",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Tiger Brokers (TigerOpen) — US/HK/A-share stocks. Account, positions, orders, quotes, history, and order placement (paper + live). Use when the user wants to check or trade a Tiger / 老虎证券 account (e.g. \"Tiger account assets\", \"buy 100 700.HK on Tiger\", \"my Tiger positions\"). Cloud API via the official tigeropen SDK, runs in the container."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/starchild-ai-agent/official-skills",
      "path": "tiger/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/starchild-ai-agent/official-skills/blob/HEAD/tiger/SKILL.md",
      "key": "starchild-ai-agent/official-skills/tiger/SKILL.md"
    }
  },
  "instructions": "## What this is\n\n☁️ **Cloud broker** — runs **directly in the container** via the official `tigeropen` SDK. Covers US, HK, and A-share markets.\n\nAuth is **RSA-signed static key**: a `tiger_id` + a local PKCS#1 private key (PEM) + your account number. No OAuth, no token refresh.\n\n**Paper/live guard:** a Tiger paper (sandbox) account number is exactly **17 numeric digits** (e.g. `20191106192858300`); standard/global accounts are not. The chosen `--profile` must match the account format or the command fails closed. Live placement additionally requires `--confirm-live`. Note: paper accounts don't ",
  "cost": {
    "context_tokens": 894
  }
}

Fetch it by URL: GET /api/v1/registry/starchild-ai-agent-official-skills-tiger/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.