Shadow Ingest HTTP Service¶

The HTTP service runs on 30110 and exposes FastAPI/OpenAPI documentation.

Use it for:

frontend integration
raw HTTP inspection
service-level debugging
checking the deployed OpenAPI contract

Live Docs¶

When the service is running:

http://data.zhengxinfund.com:30110/docs
http://data.zhengxinfund.com:30110/openapi.json

Main Routes¶

GET /health
GET /datasets
POST /query
GET /api/industry/standards
POST /api/industry/mapping
POST /api/industry/members
POST /api/daily-price
POST /api/daily-snapshot
POST /api/hk/market-calendar
POST /api/hk/universe
POST /api/hk/daily-price
POST /api/hk/daily-snapshot
POST /api/financial-snapshot

Important Positioning¶

FastAPI /docs documents the HTTP layer.

The generic POST /query route is still available for internal and low-level use, but the maintained user-facing HTTP surface should prefer the named /api/... routes.

For Python users, the main documentation should still be:

Hong Kong HTTP Example¶

curl -sS -X POST http://data.zhengxinfund.com:30110/api/hk/daily-price \
  -H 'Content-Type: application/json' \
  -d '{
    "stock_codes": ["00700.XHKG"],
    "start_date": "2026-06-25",
    "end_date": "2026-06-25",
    "fields": ["open", "close"]
  }'

Expected shape:

{
  "dataset": "hk_raw_price_daily",
  "columns": ["trade_date", "stock_code", "open", "close"],
  "rows": [
    {
      "trade_date": "2026-06-25",
      "stock_code": "00700.XHKG",
      "open": 428.6,
      "close": 421.4
    }
  ]
}