Installation

clawhub install hieuhani/entradex

Summary

EntradeX CLI provides command-line access to DNSE brokerage workflows, including account management, market data, and order execution. It supports stocks and derivatives on the Vietnamese DNSE exchange. Credentials can be stored in a config file or passed via environment variables.

SKILL.md

EntradeX CLI

Install

bash
npm i -g entradex-cli

Usage

bash
entradex [global-options] [command]

Configuration

Credential priority order:

  1. Config file (~/.entradex-cli/config.json) - recommended
  2. Environment variables (DNSE_API_KEY, DNSE_API_SECRET)
  3. Global command options (--api-key, --api-secret)

Setup and inspect config:

bash
entradex config set --key "<api-key>" --secret "<api-secret>"
entradex config set
entradex config get
entradex config clear

Security & Safety

Before using this skill:

  • Verify the npm package: npm view entradex-cli - check author is hieuhani and repository matches
  • Inspect package contents: npm pack entradex-cli --dry-run or view on npmjs.com
  • Treat DNSE_API_KEY and DNSE_API_SECRET as highly sensitive trading credentials

Autonomous execution warning:

  • This skill can place real trades using provided credentials
  • Consider using a separate limited-permission account
  • Rotate API keys if you suspect unauthorized access

Global Options

  • --api-key <key> DNSE API key
  • --api-secret <secret> DNSE API secret
  • --base-url <url> API base URL (default: https://openapi.dnse.com.vn)
  • --debug Show request details
  • -V, --version Show CLI version
  • -h, --help Show help

Commands

Config

bash
entradex config set [--key <key>] [--secret <secret>] [--url <url>]
entradex config get
entradex config clear

Account

bash
entradex account list
entradex account balances <accountNo>
entradex account loan-packages <accountNo> <marketType> [--symbol <symbol>]

Trade

bash
entradex trade order <marketType> <symbol> <side> <orderType> <price> <quantity> <tradingToken> [--price-stop <price>]
entradex trade modify <accountNo> <orderId> <marketType> <symbol> <side> <orderType> <price> <quantity> <tradingToken> [--price-stop <price>]
entradex trade cancel <accountNo> <orderId> <marketType> <tradingToken>

Parameters:

  • marketType (enum): STOCK, DERIVATIVE
  • side (enum): NB (buy), NS (sell)
  • orderType (enum): ATO, ATC, LO, MTL, MOK, PLO
    • ATO: At The Opening
    • ATC: At The Close
    • LO: Limit Order
    • MTL: Market To Limit
    • MOK: Market Order Kill
    • PLO: Post Limit Order
  • price (number): unit price; follow DNSE tick-size/market constraints
    • If orderType=LO, price must be greater than 0.
    • If orderType is anything other than LO (ATO, ATC, MTL, MOK, PLO), price must be exactly 0.
  • quantity (integer): order quantity; must satisfy market lot rules
    • For marketType=STOCK, valid quantity is either:
      • Board lot: multiples of 100 (100, 200, ...)
      • Odd lot: integers from 1 to 99
    • For marketType=STOCK, values like 101, 102, ... are invalid odd lots and must be rejected.
  • tradingToken (string): token from entradex auth create-token

Normalization rules for user intent:

  • If user says buy/sell, map to NB/NS.
  • Uppercase enum-style params before execution (marketType, side, orderType).
  • If user provides an unsupported enum value, stop and ask for a valid value.
  • If orderType is not supported by the target market/session, stop and ask user to choose a supported type.

Order

bash
entradex order list <accountNo> <marketType>
entradex order detail <accountNo> <orderId> <marketType>
entradex order history <accountNo> <marketType> [--from <date>] [--to <date>] [--page-size <size>] [--page-index <index>]
entradex order deals <accountNo> <marketType>

Market

bash
entradex market secdef <symbol> [--board-id <id>]
entradex market ppse <accountNo> <marketType> <symbol> <price> <loanPackageId>

Auth

bash
entradex auth send-otp <email> [--otp-type <type>]
entradex auth create-token <otpType> <passcode>

Dry Run

bash
entradex dry-run accounts
entradex dry-run balances <accountNo>
entradex dry-run order <marketType> <symbol> <side> <orderType> <price> <quantity> [--price-stop <price>]

Common Workflow

bash
# 1) Configure credentials
entradex config set

# 2) Send OTP
entradex auth send-otp user@example.com

# 3) Create trading token with passcode
entradex auth create-token smart_otp <passcode>

# 4) Place an order
entradex trade order STOCK VIC NB LO 15000 100 <trading-token>

Recommended skills

Browse all →

Related guides

Hand-picked reading to help you choose, install, and use agent skills.