Nhóm API Dữ liệu thị trường

Xác thực: Không yêu cầu xác thực. Tất cả API trong nhóm này có thể gọi trực tiếp bằng HTTP GET.

A1. Lấy dữ liệu mới nhất theo mã

Trả về dữ liệu thị trường mới nhất cho một hoặc nhiều mã, bao gồm giá, khối lượng, sổ lệnh và giao dịch khối ngoại. GET /priceboard/symbol-latest-data URL Sandbox

https://flashapi.phs.vn/sandbox/oapi/priceboard/symbol-latest-data

Tham số

string

bắt buộc

Danh sách mã, phân tách bằng dấu phẩy. Ví dụ: ACB,FPT,VIC

string

bắt buộc

Các trường dữ liệu cần trả về. Ví dụ: marketId,o,h,l,c,vo

curl -G "https://flashapi.phs.vn/sandbox/oapi/priceboard/symbol-latest-data" \
  --data-urlencode "symbolList=ACB,FPT,VIC" \
  --data-urlencode "fields=marketId,o,h,l,c,vo"

[
  {
    "s": "ACB",
    "o": 23400,
    "h": 23500,
    "l": 23000,
    "c": 23000,
    "ch": -600,
    "r": -2.54,
    "vo": 13775200,
    "va": 319093870000,
    "ce": 25250,
    "fl": 21950,
    "marketId": "STO",
    "m": "HOSE",
    "n1": "Ngân hàng TMCP Á Châu",
    "n2": "Asia Commercial JS Bank"
  }
]

Sandbox: Sandbox luôn trả về cùng một bộ dữ liệu mẫu. Tham số request vẫn được kiểm tra về tính đầy đủ và định dạng, nhưng thay đổi mã hoặc fields không làm thay đổi dữ liệu mẫu.

A2. Lấy dữ liệu thống kê khớp lệnh theo mã

Trả về thống kê khớp lệnh theo từng bước giá, bao gồm khối lượng và tỷ lệ mua/bán. GET /priceboard/symbol-statics-data URL Sandbox

https://flashapi.phs.vn/sandbox/oapi/priceboard/symbol-statics-data

Tham số

string

bắt buộc

Mã chứng khoán. Ví dụ: ACB

integer

bắt buộc

Số bước giá cần trả về. Ví dụ: 10

curl -G "https://flashapi.phs.vn/sandbox/oapi/priceboard/symbol-statics-data" \
  --data-urlencode "symbol=ACB" \
  --data-urlencode "fetchCount=10"

[
  {
    "price": 23500,
    "volume": 2400,
    "buyVolume": 2400,
    "sellVolume": 0,
    "buyRate": 1,
    "sellRate": 0,
    "rate": 0.0002
  },
  {
    "price": 23450,
    "volume": 5000,
    "buyVolume": 100,
    "sellVolume": 4900,
    "buyRate": 0.02,
    "sellRate": 0.98,
    "rate": 0.0004
  }
]

Sandbox: Sandbox luôn trả về cùng một bộ dữ liệu mẫu. Tham số request được kiểm tra nhưng không làm thay đổi dữ liệu mẫu trả về.

A3. Lấy dữ liệu khớp lệnh theo mã

Trả về các giao dịch khớp lệnh riêng lẻ (tick data) của một mã. GET /priceboard/symbol-matching-data URL Sandbox

https://flashapi.phs.vn/sandbox/oapi/priceboard/symbol-matching-data

Tham số

string

bắt buộc

Mã chứng khoán. Ví dụ: ACB

integer

bắt buộc

Số bản ghi cần trả về. Ví dụ: 10

curl -G "https://flashapi.phs.vn/sandbox/oapi/priceboard/symbol-matching-data" \
  --data-urlencode "symbol=ACB" \
  --data-urlencode "fetchCount=10"

{
  "fromIndex": 13745600,
  "toIndex": 13775200,
  "data": [
    {
      "ti": 1773992700007,
      "c": 23000,
      "ch": -600,
      "h": 23500,
      "l": 23000,
      "mb": "SELL",
      "mv": 6400,
      "r": -2.54,
      "va": 319093870000,
      "vo": 13775200
    }
  ]
}

Sandbox: Sandbox luôn trả về cùng một bộ dữ liệu mẫu. Thay đổi symbol hoặc fetchCount không làm thay đổi dữ liệu mẫu.

A4. Lấy danh sách toàn bộ mã

Trả về thông tin cơ bản của các mã cơ sở, phái sinh, chứng quyền (CW) và chỉ số, bao gồm mã, tên, sàn và loại công cụ.

Endpoint này phù hợp để xây dựng danh sách chọn mã hoặc instrument master.

GET /priceboard/all-stocks URL Sandbox

https://flashapi.phs.vn/sandbox/oapi/priceboard/all-stocks

Tham số

Không yêu cầu tham số.

curl "https://flashapi.phs.vn/sandbox/oapi/priceboard/all-stocks"

[
  {
    "s": "ACB",
    "ti": 1774332196854,
    "t": "STOCK",
    "n1": "Ngân hàng TMCP Á Châu",
    "n2": "Asia Commercial JS Bank",
    "marketId": "STO",
    "m": "HOSE"
  }
]

Sandbox: Endpoint luôn trả về cùng một bộ dữ liệu mẫu.

A5. Lấy dữ liệu nến (Candlestick)

Trả về dữ liệu OHLCV dùng cho biểu đồ.

Các khung thời gian được hỗ trợ: 1, 5, 15, 30, 60, 120, 1D, 1W, 1M. Trong đó các giá trị số tính theo phút; D, W, M tương ứng với ngày, tuần và tháng.

GET /priceboard/candlestick-data URL Sandbox

https://flashapi.phs.vn/sandbox/oapi/priceboard/candlestick-data

Tham số

string

bắt buộc

Mã chứng khoán. Ví dụ: ACB

string

bắt buộc

Khung thời gian. Ví dụ: 1D

integer

bắt buộc

Thời gian bắt đầu, Unix timestamp. Ví dụ: 1735257600

integer

bắt buộc

Thời gian kết thúc, Unix timestamp. Ví dụ: 1774051200

curl -G "https://flashapi.phs.vn/sandbox/oapi/priceboard/candlestick-data" \
  --data-urlencode "symbol=ACB" \
  --data-urlencode "resolution=1D" \
  --data-urlencode "from=1735257600" \
  --data-urlencode "to=1774051200"

{
  "t": [1735278140, 1735536640],
  "o": [25600, 25350],
  "h": [25700, 25650],
  "l": [25500, 25350],
  "c": [25550, 25400],
  "v": [7689900, 5000400],
  "s": "ok",
  "nextTime": null
}

Sandbox: Sandbox luôn trả về cùng một bộ dữ liệu mẫu. Các tham số symbol, resolution, from và to được kiểm tra nhưng không làm thay đổi dữ liệu mẫu trả về.

Tài liệu API

Các điều khoản & thỏa thuận

Nhóm API Dữ liệu thị trường

A1. Lấy dữ liệu mới nhất theo mã

Tham số

A2. Lấy dữ liệu thống kê khớp lệnh theo mã

Tham số

A3. Lấy dữ liệu khớp lệnh theo mã

Tham số

A4. Lấy danh sách toàn bộ mã

Tham số

A5. Lấy dữ liệu nến (Candlestick)

Tham số

​A1. Lấy dữ liệu mới nhất theo mã

​Tham số

​A2. Lấy dữ liệu thống kê khớp lệnh theo mã

​Tham số

​A3. Lấy dữ liệu khớp lệnh theo mã

​Tham số

​A4. Lấy danh sách toàn bộ mã

​Tham số

​A5. Lấy dữ liệu nến (Candlestick)

​Tham số

A1. Lấy dữ liệu mới nhất theo mã

Tham số

A2. Lấy dữ liệu thống kê khớp lệnh theo mã

Tham số

A3. Lấy dữ liệu khớp lệnh theo mã

Tham số

A4. Lấy danh sách toàn bộ mã

Tham số

A5. Lấy dữ liệu nến (Candlestick)

Tham số