Migrating from Tushare

# Tushare                              # us
# 600667.SH   ->   sh600667
# 000001.SZ   ->   sz000001
# 830799.BJ   ->   bj830799
# 00700.HK    ->   hk00700
# AAPL        ->   usAAPL

# one-liner (Python)
def to_code(ts_code: str) -> str:
    """600667.SH -> sh600667 · 00700.HK -> hk00700 · AAPL -> usAAPL"""
    if "." not in ts_code:
        return "us" + ts_code.upper()
    num, mkt = ts_code.split(".")
    return {"SH": "sh", "SZ": "sz", "BJ": "bj", "HK": "hk"}[mkt] + num

# Tushare
#   pro.daily(ts_code="600667.SH", start_date="20260101", end_date="20260921")
# us (no date range: take the last N bars, filter locally)
curl "https://api.ashareapi.com/v1/kline?code=sh600667&period=day&count=30"

{
  "ok": true, "endpoint": "kline", "tier": "free",
  "elapsed_ms": 615, "source": "multi",
  "data": [
    {"date": "2026-09-21", "open": "20.64", "last": "20.30",
     "high": "20.78", "low": "20.12",
     "volume": "2213526",      // lots (same unit as Tushare vol)
     "amount": "4510589168",   // CNY
     "turnover": "10.58"}      // turnover rate (%)
  ]
}

import requests

BASE = "https://api.ashareapi.com/v1"
H = {}                                   # free endpoints: no key
# paid endpoints add (header keeps keys out of logs):
# H = {"Authorization": "Bearer ct-your-key"}

def get(path: str, **params):
    r = requests.get(f"{BASE}/{path}", params=params, headers=H, timeout=30)
    if r.status_code == 429:             # anonymous 5/min; 60/min after one PoW challenge
        raise RuntimeError("rate limited - slow down, or see /v1/challenge")
    r.raise_for_status()
    body = r.json()
    if not body.get("ok"):
        raise RuntimeError(f"upstream failed (not counted): {body}")
    return body["data"]