Get symbol latest data

Endpoint

GET /oapi/priceboard/symbol-latest-data

Test this API in our Sandbox using simulated data.

Try the Sandbox to see how the API works with simulated data — no production account or live trading required.

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

View Sandbox Guide →
Required query parameters

symbolList — Comma-separated list of symbols. Example: ACB,FPT,VIC
fields — Comma-separated list of response fields to return.

Available fields

marketId,o,h,sessionId,l,c,ch,r,ti,a,re,vo,va,ce,fl,ep,er,ec,ev,mv,bbOd,boOd,bbBi,boBi,biC,biCh,biR,biVo,biVa,biMv,odC,odCh,odR,odVo,odVa,odMv,odH,odL,i,fsp,noFsp,ba,oi,exp,exr,ltd,is,be,c5ss,c1w,c1m,c3m,c6m,c1y,va5ss,va1w,va1m,va3m,va6m,va1y,td5ss,td1w,td3m,td6m,td1y,s,t,n1,n2,m,isin,rc,underlyingSymbol,underlyingPrice,underlyingStatus,aFrNSva6m,frSvo,aFrBvo1y,ch1y,aFrBva1w,aVa3m,r5ss,aVa1m,aFrSvo3m,aFrBva6m,aVo6m,frTr,aVa6m,aFrBvo6m,aFrNSva1w,aFrSvo1m,aFrSva3m,aFrSva1w,aFrNBva6m,aFrSvo1w,aFrBvo3m,frCr,ch5ss,aVo3m,aFrBva3m,aFrBvo1w,aVo5ss,aFrSva6m,r6m,td1m,frNBva,aVa1y,aVa5ss,r3m,aFrSva1y,r1w,aFrNBva1m,frBvo,aFrNSva3m,ch6m,aVo1m,aFrBvo1m,aFrNSva1m,frBva,aFrSvo6m,r1m,ch1m,aFrNBva3m,aVa1w,aFrBva1y,frNSva,r1y,frSva,ch3m,aFrSva1m,aFrNBva1y,aFrSvo1y,aVo1y,aVo1w,ch1w,aFrNBva1w,aFrNSva1y,aFrBva1m

Field descriptions

Core market fields

marketId (string) — Market code. Example: STO, STX, UPX, DVX.
s (string) — Symbol.
t (string) — Symbol type. Example: STOCK, CW, INDEX.
o (number) — Open price (giá mở cửa).
h (number) — High price (giá cao nhất).
l (number) — Low price (giá thấp nhất).
c (number) — Latest matched price (giá khớp gần nhất).
ch (number) — Change.
r (number) — Rate.
ti (number) — Latest update time (thời gian gần nhất mã được update).
a (number) — Average price (giá trung bình).
re (number) — New reference price (Giá tham chiếu mới).
vo (number) — Trading volume.
va (number) — Trading value.
ce (number) — Ceiling price.
fl (number) — Floor price.
ep (number) — Expected price for ATO or ATC.
er (number) — Expected rate.
ec (number) — Expected change.
ev (number) — Expected volume.
mv (number) — Latest matching volume (khối lượng khớp gần nhất).
sessionId (string) — Trading session ID. Example: 99.

Order book and buy-in

bbOd (array) — Odd-lot bid book (dư mua lô lẻ).
- p (number) — Price.
- v (number) — Volume.
boOd (array) — Odd-lot offer book (dư bán lô lẻ).
- p (number) — Price.
- v (number) — Volume.
bbBi (array) — Buy-in bid book (dư mua BuyIn).
- p (number) — Price.
- v (number) — Volume.
boBi (array) — Buy-in offer book (dư bán BuyIn).
- p (number) — Price.
- v (number) — Volume.
biC (number) — Buy-in price.
biCh (number) — Buy-in change.
biR (number) — Buy-in rate.
biVo (number) — Buy-in volume.
biVa (number) — Buy-in value.
biMv (number) — Buy-in matching volume.

Odd-lot fields

odC (number) — Odd-lot price.
odCh (number) — Odd-lot change.
odR (number) — Odd-lot rate.
odVo (number) — Odd-lot volume.
odVa (number) — Odd-lot value.
odMv (number) — Odd-lot matching volume.
odH (number) — Odd-lot high.
odL (number) — Odd-lot low.

Derivatives and CW fields

ba (number) — Basis (độ lệch so với VN30).
oi (number) — Open interest.
exp (number) — CW exercise price (Giá thực hiện của chứng quyền).
exr (string) — Conversion ratio (Tỉ lệ chuyển đổi).
ltd (string) — CW trading date (ngày giao dịch chứng quyền).
is (string) — CW issuer (Tổ chức phát hành chứng quyền).
be (number) — Break-even point of a CW (điểm hòa vốn của cw).
underlyingSymbol (string) — Underlying symbol (Mã CK cơ sở).
underlyingPrice (number) — Underlying symbol price.

Metadata

n1 (string) — Symbol name.
n2 (string) — English name.
m (string) — Exchange. Example: HOSE, HNX, UPCOM.
isin (string) — Exchange-defined symbol code.
rc (string) — Reference code.
i (boolean) — Highlight flag. Do not use.
fsp (number) — Do not use.
noFsp (number) — Do not use.

Foreign trading fields

frBvo (number) — Foreign buy volume.
frSvo (number) — Foreign sell volume.
frBva (number) — Foreign buy value.
frSva (number) — Foreign sell value.
frTr (number) — Total foreign room.
frCr (number) — Current foreign room.
frNBva (number) — Foreign net buy value.
frNSva (number) — Foreign net sell value.

Historical close, value, and trading-day fields

c5ss (number) — Close price 5 sessions ago.
c1w (number) — Close price 1 week ago.
c1m (number) — Close price 1 month ago.
c3m (number) — Close price 3 months ago.
c6m (number) — Close price 6 months ago.
c1y (number) — Close price 1 year ago.
va5ss (number) — Trading value 5 sessions ago.
va1w (number) — Trading value 1 week ago.
va1m (number) — Trading value 1 month ago.
va3m (number) — Trading value 3 months ago.
va6m (number) — Trading value 6 months ago.
va1y (number) — Trading value 1 year ago.
td5ss (number) — Total trading days 5 sessions ago.
td1w (number) — Total trading days 1 week ago.
td1m (number) — Total trading days 1 month ago.
td3m (number) — Total trading days 3 months ago.
td6m (number) — Total trading days 6 months ago.
td1y (number) — Total trading days 1 year ago.

Historical change and rate fields

ch5ss (number) — Change versus 5 sessions ago.
ch1w (number) — Change versus 1 week ago.
ch1m (number) — Change versus 1 month ago.
ch3m (number) — Change versus 3 months ago.
ch6m (number) — Change versus 6 months ago.
ch1y (number) — Change versus 1 year ago.
r5ss (number) — Rate versus 5 sessions ago.
r1w (number) — Rate versus 1 week ago.
r1m (number) — Rate versus 1 month ago.
r3m (number) — Rate versus 3 months ago.
r6m (number) — Rate versus 6 months ago.
r1y (number) — Rate versus 1 year ago.

Historical aggregate fields

aVa5ss (number) — Trading value 5 sessions ago.
aVa1w (number) — Trading value 1 week ago.
aVa1m (number) — Trading value 1 month ago.
aVa3m (number) — Trading value 3 months ago.
aVa6m (number) — Trading value 6 months ago.
aVa1y (number) — Trading value 1 year ago.
aVo5ss (number) — Trading volume 5 sessions ago.
aVo1w (number) — Trading volume 1 week ago.
aVo1m (number) — Trading volume 1 month ago.
aVo3m (number) — Trading volume 3 months ago.
aVo6m (number) — Trading volume 6 months ago.
aVo1y (number) — Trading volume 1 year ago.

Historical foreign trading fields

aFrBvo1w (number) — Foreign buy volume 1 week ago.
aFrBvo1m (number) — Foreign buy volume 1 month ago.
aFrBvo3m (number) — Foreign buy volume 3 months ago.
aFrBvo6m (number) — Foreign buy volume 6 months ago.
aFrBvo1y (number) — Foreign buy volume 1 year ago.
aFrSvo1w (number) — Foreign sell volume 1 week ago.
aFrSvo1m (number) — Foreign sell volume 1 month ago.
aFrSvo3m (number) — Foreign sell volume 3 months ago.
aFrSvo6m (number) — Foreign sell volume 6 months ago.
aFrSvo1y (number) — Foreign sell volume 1 year ago.
aFrBva1w (number) — Foreign buy value 1 week ago.
aFrBva1m (number) — Foreign buy value 1 month ago.
aFrBva3m (number) — Foreign buy value 3 months ago.
aFrBva6m (number) — Foreign buy value 6 months ago.
aFrBva1y (number) — Foreign buy value 1 year ago.
aFrSva1w (number) — Foreign sell value 1 week ago.
aFrSva1m (number) — Foreign sell value 1 month ago.
aFrSva3m (number) — Foreign sell value 3 months ago.
aFrSva6m (number) — Foreign sell value 6 months ago.
aFrSva1y (number) — Foreign sell value 1 year ago.
aFrNBva1w (number) — Foreign net buy value 1 week ago.
aFrNBva1m (number) — Foreign net buy value 1 month ago.
aFrNBva3m (number) — Foreign net buy value 3 months ago.
aFrNBva6m (number) — Foreign net buy value 6 months ago.
aFrNBva1y (number) — Foreign net buy value 1 year ago.
aFrNSva1w (number) — Foreign net sell value 1 week ago.
aFrNSva1m (number) — Foreign net sell value 1 month ago.
aFrNSva3m (number) — Foreign net sell value 3 months ago.
aFrNSva6m (number) — Foreign net sell value 6 months ago.
aFrNSva1y (number) — Foreign net sell value 1 year ago.

cURL

curl -G "$BASE_URL/oapi/priceboard/symbol-latest-data" \
  --data-urlencode "symbolList=ACB,FPT,VIC" \
  --data-urlencode "fields=marketId,o,h,l,c,vo"

Python

import requests

BASE_URL = "https://api.example.com"

params = {
    "symbolList": "ACB,FPT,VIC",
    "fields": "marketId,o,h,l,c,vo",
}

response = requests.get(
    f"{BASE_URL}/oapi/priceboard/symbol-latest-data",
    params=params,
)
response.raise_for_status()

print(response.json())

Example response

[
    {
        "s": "ACB",
        "o": 23400,
        "h": 23500,
        "ce": 25250,
        "fl": 21950,
        "l": 23000,
        "c": 23000,
        "ch": -600,
        "r": -2.54,
        "vo": 13775200,
        "va": 319093870000,
        "a": null,
        "re": 23600,
        "ti": 1773992705686,
        "mv": 6400,
        "bbOd": [
            {
                "p": 23200,
                "v": 103
            },
            {
                "p": 23150,
                "v": 1673
            },
            {
                "p": 23100,
                "v": 1312
            }
        ],
        "boOd": [
            {
                "p": 23250,
                "v": 92
            },
            {
                "p": 23300,
                "v": 161
            },
            {
                "p": 23350,
                "v": 30
            }
        ],
        "bbBi": [
            {
                "p": 0,
                "v": 0
            },
            {
                "p": 0,
                "v": 0
            },
            {
                "p": 0,
                "v": 0
            }
        ],
        "boBi": [
            {
                "p": 0,
                "v": 0
            },
            {
                "p": 0,
                "v": 0
            },
            {
                "p": 0,
                "v": 0
            }
        ],
        "fsp": null,
        "noFsp": null,
        "t": "STOCK",
        "n1": "Ngân hàng Thương mại Cổ phần Á Châu",
        "n2": "Asia Commercial Joint Stock Bank",
        "marketId": "STO",
        "m": "HOSE",
        "isin": "VN000000ACB8",
        "rc": "ACB",
        "odH": 23600,
        "odL": 23200,
        "odC": 23200,
        "odCh": -400,
        "odR": -1.69,
        "odMv": 2,
        "odVo": 10634,
        "odVa": 247743450,
        "biC": null,
        "biCh": null,
        "biR": null,
        "biVo": null,
        "biVa": null,
        "biMv": null,
        "frBvo": 1729501,
        "frSvo": 7552813,
        "is": null,
        "exr": null,
        "ltd": null,
        "underlyingSymbol": null,
        "frBva": 40070453250,
        "frSva": 175015403600,
        "frTr": 1540996979,
        "frCr": 130293727,
        "frNBva": -134944950350,
        "frNSva": 134944950350,
        "ep": 0,
        "ec": 0,
        "er": 0,
        "ev": 0,
        "be": null,
        "ba": null,
        "oi": null,
        "i": false
    }
]

Replace BASE_URL with your API host. Replace the sample symbols and fields as needed.

API documentation

Terms and conditions

Get symbol latest data

Endpoint

Test this API in our Sandbox using simulated data.

Available fields

Field descriptions

Core market fields

Order book and buy-in

Odd-lot fields

Derivatives and CW fields

Metadata

Foreign trading fields

Historical close, value, and trading-day fields

Historical change and rate fields

Historical aggregate fields

Historical foreign trading fields

cURL

Python

Example response

​Endpoint

​Test this API in our Sandbox using simulated data.

​Available fields

​Field descriptions

​Core market fields

​Order book and buy-in

​Odd-lot fields

​Derivatives and CW fields

​Metadata

​Foreign trading fields

​Historical close, value, and trading-day fields

​Historical change and rate fields

​Historical aggregate fields

​Historical foreign trading fields

​cURL

​Python

​Example response

Endpoint

Test this API in our Sandbox using simulated data.

Available fields

Field descriptions

Core market fields

Order book and buy-in

Odd-lot fields

Derivatives and CW fields

Metadata

Foreign trading fields

Historical close, value, and trading-day fields

Historical change and rate fields

Historical aggregate fields

Historical foreign trading fields

cURL

Python

Example response