​

Nhóm API Giao dịch - Cơ sở (Chứng khoán)

Đặt lệnh, sửa lệnh và hủy lệnh chứng khoán. Mọi lệnh gọi đều cần access_token lấy từ B1 (Xác thực - Cơ sở).

​

Mục lục

​

Xác thực

GET (như C4) không cần x-otp-token.

​

C1. Đặt lệnh (Cơ sở)

​

Tham số

​

Ví dụ yêu cầu

curl -X POST "https://flashapi.phs.vn/sandbox/oapi/accounts/$ACCOUNT_ID/orders/underlying" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "x-lang: vi" -H "x-via: K" \
  -H "x-otp-token: 552066a35eb30a9815afc952b14287a8" \
  -d '{
        "instrument": "ACB",
        "qty": 1,
        "side": "buy",
        "type": "LO",
        "limitPrice": 23000,
        "timetype": "T"
      }'

​

Ví dụ phản hồi

{
  "s": "ok",
  "d": { "orderid": "8000180326000219" }
}

Hành vi trên Sandbox: Sandbox vẫn kiểm tra đầy đủ các trường bắt buộc và đúng kiểu dữ liệu, đồng thời yêu cầu các header giống như Production, nhưng không có lệnh nào thực sự được gửi đến sàn giao dịch. Mỗi lệnh gọi thành công sẽ trả về một mã lệnh (order ID) mẫu cố định. Thay vì mã OTP thật gửi về điện thoại, Sandbox chấp nhận mã OTP mẫu cố định ghi chú ở mục Xác thực - hãy gửi đúng chuỗi đó trong header x-otp-token.

​

C2. Sửa lệnh (Cơ sở)

​

Tham số

​

Ví dụ yêu cầu

curl -X PUT "https://flashapi.phs.vn/sandbox/oapi/accounts/$ACCOUNT_ID/orders/underlying/$ORDER_ID" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "x-lang: vi" -H "x-via: K" \
  -H "x-otp-token: 552066a35eb30a9815afc952b14287a8" \
  -d '{
        "qty": 1,
        "limitPrice": 23000
      }'

​

Ví dụ phản hồi

{ "s": "ok" }

Hành vi trên Sandbox: Sandbox vẫn kiểm tra đầy đủ các trường bắt buộc và đúng kiểu dữ liệu, đồng thời yêu cầu các header giống như Production, nhưng không có lệnh nào thực sự được gửi đến sàn giao dịch. Mỗi lệnh gọi thành công sẽ trả về một mã lệnh (order ID) mẫu cố định. Thay vì mã OTP thật gửi về điện thoại, Sandbox chấp nhận mã OTP mẫu cố định ghi chú ở mục Xác thực - hãy gửi đúng chuỗi đó trong header x-otp-token.

​

C3. Hủy lệnh (Cơ sở)

​

Tham số

​

Ví dụ yêu cầu

curl -X DELETE "https://flashapi.phs.vn/sandbox/oapi/accounts/$ACCOUNT_ID/orders/underlying/$ORDER_ID?timeType=T&isbuyin=N" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "x-lang: vi" -H "x-via: K" \
  -H "x-otp-token: 552066a35eb30a9815afc952b14287a8"

​

Ví dụ phản hồi

{ "s": "ok" }

Hành vi trên Sandbox: Sandbox vẫn kiểm tra đầy đủ các trường bắt buộc và đúng kiểu dữ liệu, đồng thời yêu cầu các header giống như Production, nhưng không có lệnh nào thực sự được gửi đến sàn giao dịch. Mỗi lệnh gọi thành công sẽ trả về một mã lệnh (order ID) mẫu cố định. Thay vì mã OTP thật gửi về điện thoại, Sandbox chấp nhận mã OTP mẫu cố định ghi chú ở mục Xác thực - hãy gửi đúng chuỗi đó trong header x-otp-token.

​

C4. Lấy sức mua Cơ sở

​

Tham số

​

Ví dụ yêu cầu

curl "https://flashapi.phs.vn/sandbox/oapi/accounts/$ACCOUNT_ID/underlying/buyingPower?symbol=VIC&quotePrice=222000" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

​

Ví dụ phản hồi

{
  "s": "ok",
  "d": [
    { "ppse": 0, "maxqty": -1, "allowance": 16, "blocked": 0 }
  ]
}

Hành vi trên Sandbox: Sandbox trả về đúng một bản ghi mẫu cố định cho bất kỳ accountId nào bạn truyền vào, giúp bạn xác nhận tên trường và kiểu dữ liệu trước khi trỏ hệ thống của bạn sang Production, nơi dữ liệu phản ánh đúng tài khoản thật.