Finhay Portfolio

Read-only trading data via the Finhay Securities Open API. All endpoints use signed GET requests.

MANDATORY: Before any action, read and complete pre-flight checks. Required: FINHAY_API_KEY, FINHAY_API_SECRET, USER_ID, and the relevant SUB_ACCOUNT_* variable. Do not skip or defer.

Setup

If USER_ID or SUB_ACCOUNT_* variables are missing, run once:

./_shared/scripts/infer-sub-account.sh

This writes USER_ID, SUB_ACCOUNT_NORMAL, and/or SUB_ACCOUNT_MARGIN to ~/.finhay/credentials/.env.

Making a Request

Always use request.sh. Resolve all path variables ({subAccountId}, {userId}) before calling — the signed path must be the final, fully resolved path.