PMobile 2 - ST API

Welcome to the POEMS Mobile 2.0 - ST API!.

We have language bindings in curl! You can view code examples in the dark area to the right.

Counter

Get Stocks CounterID by PMPFeedcode

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/counter/counterID/SGX/D05?osVersion=2&language=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 013FFE75-D56A-4E1E-8D82-5BF392D61A39' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5'

Sample Response

{
    "msg": "success",
    "code": 1,
    "counterID": "ST/SG/SGX/DBS.SG"
}

This function is to retrieve the counterID for Stocks using feedcode.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/counter/counterID/{exchange}/{pmpFeedCode}

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Path Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version

Parameter	Default	Description
exchange
pmpfeedcode

Get Stocks Counter Information

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/counter/info?osVersion=2&counterID=ST%2FSG%2FSGX%2FDBS.SG&language=1&priceMode=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 013FFE75-D56A-4E1E-8D82-5BF392D61A39' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterIDs=FX%2FFX%2FFX%2FAUDCAD'

Sample Response

{
    "msg": "success",
    "code": 1,
    "product": "ST",
    "productIcon": "EQ",
    "counterName": "DBS",
    "market": "SG",
    "delayIndicator": "",
    "lastDone": "28.55",
    "change": "-0.25",
    "changePercent": "-0.86%",
    "bid": "28.54",
    "ask": "28.56",
    "bVolK": "4.3",
    "sVolK": "9.4",
    "low": "28.18",
    "high": "28.59",
    "lastDoneDate": "14:29",
    "pmpTopic": "\\SGXSE\\D05_RY"
}

This function is to retrieve the counter information for Stocks. This function allows to filter the counter information (Short or Details) by passing the price mode.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/counter/info

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID
priceMode	1	1: Short Info, 2: Detail Info

Get Stocks Supported Exchanges

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/counter/exchange?osVersion=2&language=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 7E7484F6-9309-4AFD-B0C9-D2DCDE0674B0' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5'

Sample Response

{
    "msg": "success",
    "code": 1,
    "markets": [
        {
            "market": "SG",
            "exchange": "SGX",
            "exchangeDisplay": "SGX"
        },
        {
            "market": "US",
            "exchange": "NYSE",
            "exchangeDisplay": "NYSE"
        },
        {
            "market": "US",
            "exchange": "AMEX",
            "exchangeDisplay": "AMEX"
        },
        {
            "market": "US",
            "exchange": "NASD",
            "exchangeDisplay": "NASDAQ"
        },
        {
            "market": "UK",
            "exchange": "LSE",
            "exchangeDisplay": "LSE"
        },
        {
            "market": "JP",
            "exchange": "TSE",
            "exchangeDisplay": "TSE"
        },
        {
            "market": "MY",
            "exchange": "KLSE",
            "exchangeDisplay": "Bursa"
        },
        {
            "market": "HK",
            "exchange": "SEHK",
            "exchangeDisplay": "HKEx"
        },
        {
            "market": "CN",
            "exchange": "SSE",
            "exchangeDisplay": "SSE-A"
        },
        {
            "market": "CN",
            "exchange": "SZSE",
            "exchangeDisplay": "SZSE-A"
        }
    ]
}

This function is to retrieve Stocks supported exchanges.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/counter/exchange

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version

Get Stocks Top Counters

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/counter/top?osVersion=2&language=1&market=SG&exchange=SGX&type=1&top=30&counterID=ST%2FSG%2FSGX%2FDBS.SG&priceMode=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: F60A9A00-63AB-4EEC-BD34-240FE223B073' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=FX%2FFX%2FFX%2FAUDCAD'

Sample Response

{
    "msg": "success",
    "code": 1,
    "topCounters": [
        {
            "product": "ST",
            "productIcon": "EQ",
            "counterName": "Advance SCT^",
            "counterID": "ST/SG/SGX/ASCT.SG",
            "delayIndiciator": "",
            "lastDone": "0.001",
            "change": "0",
            "changePercent": "0%",
            "bid": "0",
            "ask": "0.001",
            "bVolK": "0",
            "sVolK": "232,067.9",
            "volK": "92,000",
            "open": "0.001",
            "high": "0.001",
            "low": "0.001",
            "prevClose": "0.001",
            "symbol": "5FH",
            "market": "SG",
            "exchange": "SGX"
        },
        {
            "product": "ST",
            "productIcon": "EQ",
            "counterName": "Infinio",
            "counterID": "ST/SG/SGX/IFNSC.SG",
            "delayIndiciator": "",
            "lastDone": "0.007",
            "change": "+0.001",
            "changePercent": "+16.66%",
            "bid": "0.007",
            "ask": "0.008",
            "bVolK": "44,166.4",
            "sVolK": "14,712.9",
            "volK": "38,781.9",
            "open": "0.006",
            "high": "0.008",
            "low": "0.006",
            "prevClose": "0.006",
            "symbol": "5G4",
            "market": "SG",
            "exchange": "SGX"
        },
        ...
    ],
    "pmpTopic": "\\SGXSE\\[SGXSE]TOP01,\\SGXSE\\[SGXSE]TOP02,\\SGXSE\\[SGXSE]TOP03,\\SGXSE\\[SGXSE]TOP04,\\SGXSE\\[SGXSE]TOP05,\\SGXSE\\[SGXSE]TOP06,\\SGXSE\\[SGXSE]TOP07,\\SGXSE\\[SGXSE]TOP08,\\SGXSE\\[SGXSE]TOP09,\\SGXSE\\[SGXSE]TOP10,\\SGXSE\\[SGXSE]TOP11,\\SGXSE\\[SGXSE]TOP12,\\SGXSE\\[SGXSE]TOP13,\\SGXSE\\[SGXSE]TOP14,\\SGXSE\\[SGXSE]TOP15,\\SGXSE\\[SGXSE]TOP16,\\SGXSE\\[SGXSE]TOP17,\\SGXSE\\[SGXSE]TOP18,\\SGXSE\\[SGXSE]TOP19,\\SGXSE\\[SGXSE]TOP20,\\SGXSE\\[SGXSE]TOP21,\\SGXSE\\[SGXSE]TOP22,\\SGXSE\\[SGXSE]TOP23,\\SGXSE\\[SGXSE]TOP24,\\SGXSE\\[SGXSE]TOP25,\\SGXSE\\[SGXSE]TOP26,\\SGXSE\\[SGXSE]TOP27,\\SGXSE\\[SGXSE]TOP28,\\SGXSE\\[SGXSE]TOP29,\\SGXSE\\[SGXSE]TOP30"
}

This function is to retrieve top counters for Stocks product.This function allows to filter the number of counters by passing the top and to filter the top 30 type (Volume, Gainer or Loser) by passing type.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/counter/top

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
market
exchange
type		1: Volume, 2:Gainer, 3:Loser
top	30	Number of Counters

Get Pre-login indices components

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/counter/prelogin/indicescomponent/sgx/STI?osVersion=2&language=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 013FFE75-D56A-4E1E-8D82-5BF392D61A39' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5'

Sample Response

{
    "msg": "success",
    "code": 1,
    "columns": [
        {
            "title": "name",
            "property": "name"
        },
        {
            "title": "Last Done",
            "property": "lastDone"
        },
        ...
    ],
    "counterData": [
        {
            "counterID": "ST/SG/SGX/ARE.SG",
            "name": "Ascendas Reit",
            "change": "-0.01",
            "changePercent": "-0.3%",
            "lastDone": "3.290",
            "volume": "1,547,100"
        },
        {
            "counterID": "ST/SG/SGX/CCT.SG",
            "name": "CapitaCom Trust",
            "change": "-0.01",
            "changePercent": "-0.48%",
            "lastDone": "2.070",
            "volume": "2,939,300"
        },
        ...
    ]
}

This function is to retrieve the pre-login indices components.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/counter/prelogin/indicescomponent/sgx/{indexCode}

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Path Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version

Parameter	Default	Description
indexCode	STI

Get Indices components.

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/counter/indicescomponent/sgx/STI?osVersion=2&language=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 013FFE75-D56A-4E1E-8D82-5BF392D61A39' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5'

Sample Response

{
    "msg": "success",
    "code": 1,
    "topCounters": [
        {
            "product": "ST",
            "production": "EQ",
            "counterName": "Ascendas Reit",
            "counterID": "ST/SG/SGX/ARE.SG",
            "delayIndiciator": "",
            "lastDone": "3.28",
            "change": "-0.02",
            "changePercent": "-0.6%",
            "bid": "3.29",
            "ask": "3.29",
            "bVolK": "112.6",
            "sVolK": "535.2",
            "volK": "1,752,900",
            "open": "3.29",
            "high": "3.3",
            "low": "3.28",
            "prevClose": "3.3",
            "symbol": "A17U",
            "market": "SG",
            "exchange": "SGX",
            "closingAuctionPrice": "0"
        },
        {
            "product": "ST",
            "production": "EQ",
            "counterName": "CapitaCom Trust",
            "counterID": "ST/SG/SGX/CCT.SG",
            "delayIndiciator": "",
            "lastDone": "2.06",
            "change": "-0.02",
            "changePercent": "-0.96%",
            "bid": "2.07",
            "ask": "2.07",
            "bVolK": "51.3",
            "sVolK": "851.6",
            "volK": "3,117,100",
            "open": "2.09",
            "high": "2.09",
            "low": "2.06",
            "prevClose": "2.08",
            "symbol": "C61U",
            "market": "SG",
            "exchange": "SGX",
            "closingAuctionPrice": "0"
        },
        ...
    ],
    "pmpTopic": "\\SGXSE\\A17U_RY,\\SGXSE\\C61U_RY,\\SGXSE\\C31_RY,\\SGXSE\\C38U_RY,\\SGXSE\\C09_RY,\\SGXSE\\C52_RY,\\SGXSE\\D01_RY,\\SGXSE\\D05_RY,\\SGXSE\\G13_RY,\\SGXSE\\E5H_RY,\\SGXSE\\H78_RY,\\SGXSE\\C07_RY,\\SGXSE\\J36_RY,\\SGXSE\\J37_RY,\\SGXSE\\BN4_RY,\\SGXSE\\N2IU_RY,\\SGXSE\\O39_RY,\\SGXSE\\S58_RY,\\SGXSE\\U96_RY,\\SGXSE\\S68_RY,\\SGXSE\\C6L_RY,\\SGXSE\\Z74_RY,\\SGXSE\\T39_RY,\\SGXSE\\S63_RY,\\SGXSE\\Y92_RY,\\SGXSE\\U11_RY,\\SGXSE\\U14_RY,\\SGXSE\\V03_RY,\\SGXSE\\F34_RY,\\SGXSE\\BS6_RY"
}

This function is to retrieve the Indices components.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/counter/indicescomponent/sgx/{indexCode}

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Path Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version

Parameter	Default	Description
indexCode	STI

Get Stocks Indices Counters

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/counter/indices?osVersion=2&language=1&market=SG&exchange=SGX' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: F60A9A00-63AB-4EEC-BD34-240FE223B073' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5'

Sample Response

{
    "msg": "success",
    "code": 1,
    "topCounters": [
        {
            "product": "ST",
            "productIcon": "EQ",
            "counterName": "FTSE ST Maritime",
            "delayIndiciator": "",
            "lastDone": "285.87",
            "change": "-8.24",
            "changePercent": "-2.8%",
            "bid": "0",
            "ask": "0",
            "bVolK": "0",
            "sVolK": "0",
            "volK": "0",
            "open": "286.92",
            "high": "290.19",
            "low": "284.17",
            "prevClose": "294.11",
            "currency": null,
            "asset": null,
            "oneYearReturn": null,
            "threeYearReturn": null,
            "oneYearAnnReturn": null,
            "threeYearAnnReturn": null,
            "minInvestment": null,
            "subInvestment": null,
            "serviceCharge": null,
            "pmpTopic": "\\SGXSE.I\\I_FSTAM",
            "symbol": "FSTAM",
            "market": "SI",
            "exchange": "SGX",
            "counterID": "ST/SI/SGX/FSTAM.SG"
        },
        {
            "product": "ST",
            "productIcon": "EQ",
            "counterName": "FTSE ST All-Share Index",
            "delayIndiciator": "",
            "lastDone": "841.92",
            "change": "-7.19",
            "changePercent": "-0.84%",
            "bid": "0",
            "ask": "0",
            "bVolK": "0",
            "sVolK": "0",
            "volK": "0",
            "open": "841.73",
            "high": "843.92",
            "low": "840.09",
            "prevClose": "849.11",
            "currency": null,
            "asset": null,
            "oneYearReturn": null,
            "threeYearReturn": null,
            "oneYearAnnReturn": null,
            "threeYearAnnReturn": null,
            "minInvestment": null,
            "subInvestment": null,
            "serviceCharge": null,
            "pmpTopic": "\\SGXSE.I\\I_FSTAS",
            "symbol": "FSTAS",
            "market": "SI",
            "exchange": "SGX",
            "counterID": "ST/SI/SGX/FSTAS.SG"
        },
        ...
    ]
}

This function is to get stock indices counters information by acctNo.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/counter/indices

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
market
exchange

Get Stocks Intraday Time and Sales

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/counter/intradaytimesales?osVersion=2&language=1&counterID=ST%2FSG%2FSGX%2FARE.SG&size=100&page=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: CD91B16A-E3FA-4CD0-A44E-A199132D06FF' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FARE.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "totalPage": 10,
    "PmpTopic": "\\SGXSE.TSX\\A17U_RY-0",
    "PmpFID": "999",
    "timeSales": [
        {
            "time": "14:01:04",
            "price": "3.29",
            "vol": "200"
        },
        {
            "time": "14:01:04",
            "price": "3.29",
            "vol": "20,000"
        },
        ...
    ]
}

This function is to retrieve Intraday time and sales information for an exchange.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/counter/intradaytimesales

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID
size	100
page	1

Get Stocks Time and Sales

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/counter/timesales?osVersion=2&language=1&market=SG&exchange=SGX&type=1&top=30&counterID=ST%2FSG%2FSGX%2FDBS.SG&priceMode=1&from=12%3A10&to=16%3A10&size=100&page=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: CD91B16A-E3FA-4CD0-A44E-A199132D06FF' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterIDs=FX%2FFX%2FFX%2FAUDCAD'

Sample Response

{
    "msg": "success",
    "code": 1,
    "totalPage": 19,
    "timeSales": [
        {
            "time": "15:24:20",
            "price": "28.43",
            "vol": "100"
        },
        {
            "time": "15:24:20",
            "price": "28.43",
            "vol": "1,400"
        },
        ...
    ]
}

This function is to retrieve history or time and sales information for an exchange.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/counter/timesales

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID
from
to
size	100
page	1

Get market counters

Sample Request

curl -X POST \
  https://sandboxapi.poems.com.sg/pmobile2/st/counter/marketcounter?osVersion=2&language=1 \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 3D27207A-7D80-4F4F-8116-8A2802324EF6' \
  -H 'versionno: 2.0.0' \
  -d 'osVersion=2&language=1&market=SG'

Sample Response

{
    "msg": "Instrument deleted from WatchList.",
    "code": 1,
    "list": [
        {
            "counterID": "ST/US/NASD/BCOM",
            "code": "BCOM",
            "exchange": "US",
            "market": "NASD",
            "name": "B Communications Ltd",
            "symbol": "BCOM",
            "index": 3,
            "symbolDisplay": null,
            "exchangeDisplay": "NASDAQ",
            "product": "ST",
            "productIcon": "EQ",
            "delayIndicator": "",
            "nameDisplay": "B Communications Ltd"
        },
        {
            "counterID": "UT/UT/UT/555001",
            "code": "555001",
            "exchange": "UT",
            "market": "UT",
            "name": "Aberdeen Global - Multi Asset Income Fd Cl A MInc Hedged SGD",
            "symbol": "555001",
            "index": 3,
            "symbolDisplay": null,
            "exchangeDisplay": "UT",
            "product": "UT",
            "productIcon": "UT",
            "delayIndicator": "",
            "nameDisplay": "Aberdeen Global - Multi Asset Income Fd Cl A MInc Hedged SGD"
        },
        ...
    ]
}

This function is to get market counters.

HTTP Request

POST https://sandboxapi.poems.com.sg/pmobile2/st/counter/marketcounter

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Form Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
market

Get market depth

Sample Request

curl -X POST \
  https://sandboxapi.poems.com.sg/pmobile2/st/counter/marketdepth?osVersion=2&language=1 \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 3D27207A-7D80-4F4F-8116-8A2802324EF6' \
  -H 'versionno: 2.0.0' \
  -d 'osVersion=2&language=1&counterID=ST%2FSG%2FSGX%2FARE.SG'

Sample Response

{
    "msg": "You are not subscribed for the market depth service.",
    "code": -1,
    "pmpTopic": "",
    "marketDepth": null
}

This function is to get market depth.

HTTP Request

POST https://sandboxapi.poems.com.sg/pmobile2/st/counter/marketdepth

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Form Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID

Get Pre-login world indices

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/counter/prelogin/worldindices?osVersion=2&language=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 013FFE75-D56A-4E1E-8D82-5BF392D61A39' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5'

Sample Response

{
    "msg": "success",
    "code": 1,
    "columns": [
        {
            "title": "name",
            "property": "name"
        },
        {
            "title": "Last/Ind.NAV",
            "property": "lastDone"
        },
        ...
    ],
    "counterData": [
        {
            "counterID": "ST/US/WIDX/COMP",
            "name": "* NASDAQ COMPOSITE INDEX",
            "change": "0",
            "changePercent": "0%",
            "lastDone": "9731.176"
        },
        {
            "counterID": "ST/JP/WIDX/N225",
            "name": "* NIKKEI 225 INDEX",
            "change": "-164.35",
            "changePercent": "-0.69%",
            "lastDone": "23523.240"
        },
        ...
    ]
}

This function is to retrieve the pre-login world indices.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/counter/prelogin/worldindices

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version

Get world indices

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/counter/worldindices?osVersion=2&language=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 013FFE75-D56A-4E1E-8D82-5BF392D61A39' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5'

Sample Response

{
    "msg": "success",
    "code": 1,
    "topCounters": [
        {
            "product": "ST",
            "production": "EQ",
            "counterName": "Ascendas Reit",
            "counterID": "ST/SG/SGX/ARE.SG",
            "delayIndiciator": "",
            "lastDone": "3.28",
            "change": "-0.02",
            "changePercent": "-0.6%",
            "bid": "3.29",
            "ask": "3.29",
            "bVolK": "112.6",
            "sVolK": "535.2",
            "volK": "1,752,900",
            "open": "3.29",
            "high": "3.3",
            "low": "3.28",
            "prevClose": "3.3",
            "symbol": "A17U",
            "market": "SG",
            "exchange": "SGX",
            "closingAuctionPrice": "0"
        },
        {
            "product": "ST",
            "production": "EQ",
            "counterName": "CapitaCom Trust",
            "counterID": "ST/SG/SGX/CCT.SG",
            "delayIndiciator": "",
            "lastDone": "2.06",
            "change": "-0.02",
            "changePercent": "-0.96%",
            "bid": "2.07",
            "ask": "2.07",
            "bVolK": "51.3",
            "sVolK": "851.6",
            "volK": "3,117,100",
            "open": "2.09",
            "high": "2.09",
            "low": "2.06",
            "prevClose": "2.08",
            "symbol": "C61U",
            "market": "SG",
            "exchange": "SGX",
            "closingAuctionPrice": "0"
        },
        ...
    ],
    "pmpTopic": "\\SGXSE\\A17U_RY,\\SGXSE\\C61U_RY,\\SGXSE\\C31_RY,\\SGXSE\\C38U_RY,\\SGXSE\\C09_RY,\\SGXSE\\C52_RY,\\SGXSE\\D01_RY,\\SGXSE\\D05_RY,\\SGXSE\\G13_RY,\\SGXSE\\E5H_RY,\\SGXSE\\H78_RY,\\SGXSE\\C07_RY,\\SGXSE\\J36_RY,\\SGXSE\\J37_RY,\\SGXSE\\BN4_RY,\\SGXSE\\N2IU_RY,\\SGXSE\\O39_RY,\\SGXSE\\S58_RY,\\SGXSE\\U96_RY,\\SGXSE\\S68_RY,\\SGXSE\\C6L_RY,\\SGXSE\\Z74_RY,\\SGXSE\\T39_RY,\\SGXSE\\S63_RY,\\SGXSE\\Y92_RY,\\SGXSE\\U11_RY,\\SGXSE\\U14_RY,\\SGXSE\\V03_RY,\\SGXSE\\F34_RY,\\SGXSE\\BS6_RY"
}

This function is to retrieve the world indices.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/counter/worldindices

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version

Get Restrictive Counters

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/counter/restrictedcounter?osVersion=2&language=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 013FFE75-D56A-4E1E-8D82-5BF392D61A39' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&market=SG&action=1'

Sample Response

{
    "msg": "success",
    "code": 1,
    "restrictiveCounters": [
        {
            "companyCode": "ISR.SG",
            "market": "SG",
            "startDate": "2016-09-20 17:11:12.643",
            "isRestrictedBuy": "Y",
            "isRestrictedSell": "-",
            "counterId": "ST/SG/SGX/ISR.SG"
        },
        {
            "companyCode": "NOBSC.SG",
            "market": "SG",
            "startDate": "2017-05-24 08:15:07.61",
            "isRestrictedBuy": "Y",
            "isRestrictedSell": "-",
            "counterId": "ST/SG/SGX/NOBSC.SG"
        },
        ...
    ]
}

This function is to retrieve Restricted counter details.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/counter/restrictedcounter

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
market
action

Get Recommended counters

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/counter/recommended?osVersion=2&language=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 013FFE75-D56A-4E1E-8D82-5BF392D61A39' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5'

Sample Response

{
    "msg": "success",
    "code": 1,
    "needDisclaimer": true,
    "disclaimers": [
	"The information contained in the ‘Discover’ feature are for information only and do not constitute investment advice, offer or solicitation to buy or sell the investment product(s) mentioned herein. It does not have any regard to your specific investment objectives, financial situation and any of your particular needs. Accordingly, no warranty whatsoever is given and no liability whatsoever is accepted for any loss arising whether directly or indirectly as a result of this information. Investments are subject to investment risks including possible loss of the principal amount invested. The value of the product and the income from them may fall as well as rise. You may wish to seek advice from an independent financial adviser before making a commitment to purchase or invest in the investment product(s) mentioned herein."
    ],
    "counterList": [
        {
            "name": "DBS",
            "nameDisplay": "DBS",
            "code": "DBS.SG",
            "index": 0,
            "symbol": "D05",
            "symbolDisplay": D05,
            "market": "SG",
            "exchange": "SGX",
            "exchangeDisplay": "SGX",
            "globalChartExchange": "SGX",
            "product": "ST",
            "pmpTopic": "\\SGXSE\\D05_RY",
            "counterID": "ST/SG/SGX/DBS.SG",
            "productIcon": "EQ",
            "delayIndicator": ""
        },
        {
            "name": "YZJ Shipbldg SGD",
            "nameDisplay": "YZJ Shipbldg SGD",
            "code": "YZJ.SG",
            "index": 0,
            "symbol": "BS6",
            "symbolDisplay": BS6,
            "market": "SG",
            "exchange": "SGX",
            "exchangeDisplay": "SGX",
            "globalChartExchange": "SGX",
            "product": "ST",
            "pmpTopic": "\\SGXSE\\BS6_RY",
            "counterID": "ST/SG/SGX/YZJ.SG",
            "productIcon": "EQ",
            "delayIndicator": ""
        },
        ...
    ]
}

This function is to retrieve recommended counter details.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/counter/recommended

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
count

Get Recommended check

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/counter/recommendedcheck?osVersion=2&language=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 013FFE75-D56A-4E1E-8D82-5BF392D61A39' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&count=10&flag=0'

Sample Response

{
    "msg": "success",
    "code": 1,
    "flag": false,
    "message": "Most traded counters in the past 3 months, tailored to your portfolio"
}

This function is to retrieve recommended check.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/counter/recommendedcheck

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
count
flag

Get Recommended check

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/counter/recommendedDetail?osVersion=2&language=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 013FFE75-D56A-4E1E-8D82-5BF392D61A39' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&count=10&counterID=ST%2FSG%2FSGX%2FDBS.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "basicInfo": {
        "msg": "success",
        "code": 1,
        "stockData": {
            "currencyCode": "SGD",
            "marketCapitalization": "52,247.80",
            "commonShareOutstanding": "2,478.7929",
            "week52High": "21.230",
            "week52HighDate": "17/04/2015",
            "week52Low": "16.640",
            "week52LowDate": "12/05/2014",
            "week52Return": "21.260",
            "averageDailyVolume": "3.5156",
            "beta": "1.16"
        },
        "lastUpdated": 05-May-2015 04:20AM,
        "stockValuation": {
            "currencyCode": "SGD",
            "historicalPERatio": "0.5800",
            "peRatio": "2.79",
            "pbv": "2.70",
            "bvps": "35.35",
            "epsttm": "1.18"
        },
    },
    "basicInfo": {
        {
            "market": "JP",
            "orderTypes": [
                {
                    "name": "Limit",
                    "value": "LO",
                    "gtd": false
                }
            ]
        },
        {
            "market": "MY",
            "orderTypes": [
                {
                    "name": "Limit",
                    "value": "LO",
                    "gtd": false
                }
            ]
        },
        ...
    ]
}

This function is to retrieve recommended check.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/counter/recommendedcheck

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
count
flag

Stocks Trade

This is the Stocks trade, which you can get Stocks trade information, validate and submit orders.

Get Trade Settings

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/trade/settings?osVersion=2&language=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 8E8CC490-9938-41DE-BD85-27EFCF3751C9' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "markets": [
        {
            "market": "JP",
            "orderTypes": [
                {
                    "name": "Limit",
                    "value": "LO",
                    "gtd": false
                }
            ]
        },
        {
            "market": "MY",
            "orderTypes": [
                {
                    "name": "Limit",
                    "value": "LO",
                    "gtd": false
                }
            ]
        },
        ...
    ]
}

This function is to retrieve Stocks trade setting information for different markets.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/trade/settings

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version

Get Trade Info

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/trade/info?osVersion=2&language=1&counterID=ST%2FSG%2FSGX%2FDBS.SG' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 8E8CC490-9938-41DE-BD85-27EFCF3751C9' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "passwordRequire": true,
    "twoFARequire": false,
    "counterID": "ST/SG/SGX/DBS.SG",
    "exchange": "SGX",
    "market": "SG",
    "stockCode": null,
    "symbol": "D05",
    "companyCode": "DBS.SG",
    "companyName": "DBS",
    "delayedIndicator": "",
    "currency": "SGD",
    "lastDone": 28.14,
    "expireDate": "",
    "securityType": "S",
    "securitySubType": "",
    "lotSize": 100,
    "buyLotSize": 100,
    "sellLotSize": 100,
    "upperLimit": 28.44,
    "lowerLimit": 27.84,
    "paymentMode": [
        {
            "value": "0",
            "text": "Cash"
        },
        {
            "value": "1",
            "text": "CPF"
        },
        {
            "value": "2",
            "text": "SRS"
        }
    ],
    "settlementCurrency": [
        {
            "value": "SGD",
            "text": "SGD"
        }
    ],
    "actions": [
        {
            "value": "1",
            "text": "Buy"
        },
        {
            "value": "2",
            "text": "Sell"
        },
        {
            "value": "5",
            "text": "Short Sell"
        }
    ],
    "bidSizes": [
        {
            "bidSize": 0.001,
            "strProceed": 0,
            "endProceed": 0.2
        },
        {
            "bidSize": 0.005,
            "strProceed": 0.2,
            "endProceed": 1
        },
        {
            "bidSize": 0.01,
            "strProceed": 1,
            "endProceed": 9999999999.999998
        }
    ],
    "closingAuctionPrice": 0.0000,
    "isOptMultiCurrency": true,
    "forceKeyEligible": ,
    "forceKeyInfo": "",
    "forceKeyLink": ""
}

This function is to retrieve Stocks trade information for different markets.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/trade/info

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID

Get all Limit Balance

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/trade/alllimitbalance?osVersion=2&language=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 8E8CC490-9938-41DE-BD85-27EFCF3751C9' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "allLimitBalance": [
        {
            "aFundBal": "0 SGD",
            "buyLimitBal": "10,000 SGD",
            "sellLimitBal": "10,000 SGD",
            "accountNo": "0000000"
        },
        {
            "aFundBal": "0 SGD",
            "buyLimitBal": "20,000 SGD",
            "sellLimitBal": "20,000 SGD",
            "accountNo": "2222222"
        },
        {
            "aFundBal": "0 SGD",
            "buyLimitBal": "1,000 SGD",
            "sellLimitBal": "1,000 SGD",
            "accountNo": "5111111"
        },
        ...
    ]
}

This function is to retrieve Stocks trade all limit balance information.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/trade/alllimitbalance

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version

Get Limit Balance

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/trade/limitbalance?osVersion=2&language=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 8E8CC490-9938-41DE-BD85-27EFCF3751C9' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "aFundBal": "0 SGD",
    "buyLimitBal": "999,999,999,999 SGD",
    "sellLimitBal": "999,999,999,999 SGD"
}

This function is to retrieve Stocks trade limit balance information.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/trade/limitbalance

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version

Get max purchase Balance

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/trade/maxpurchasebalance?osVersion=2&language=1' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 8E8CC490-9938-41DE-BD85-27EFCF3751C9' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "aFundBal": "0 SGD",
    "buyLimitBal": "20,000 SGD",
    "sellLimitBal": "20,000 SGD",
    "maxPurchaseBal": "20,000 SGD"
}

This function is to retrieve Stocks trade max purchase balance information.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/trade/maxpurchasebalance

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID
market
accountType

Validate Order

Sample Request

curl -X POST \
  https://sandboxapi.poems.com.sg/pmobile2/st/trade/validate \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'cache-control: no-cache' \
  -H 'deviceid: deviceid-sample' \
  -H 'encryptedpin: 839FD766FCB1FD7679951FEF950E1A308393E95944EE80B134023C6EB18FB1B708E64CBFD71BF09504733E03C41CE982449B0B2AE2913CD51EDFB4EBA8090F8610EA0AA535F3CDDF1AA6C37E77A9CDB3E067A5FEE2DFC8AE7D94F44B702639EA7C9F316C582C0ED7F54856A01B902C120527814AD93F332E51CE8457FC63BE14' \
  -H 'sessionid: 8E8CC490-9938-41DE-BD85-27EFCF3751C9' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FDBS.SG&action=1&orderType=LO&limitPrice=28.15&triggerPrice=28.14&quantity=200&settlementCurrency=SGD&triggerPriceType=2&validity=0&gtd=2017-09-16&payment=0'

Sample Response

{
    "msg": "Success",
    "code": 1,
    "passwordRequire": true,
    "twoFARequire": false,
    "errors": [],
    "warnings": [],
    "authToken": "92689114-374B-4DED-9F6C-E419B304CC5D",
    "orderNo": null,
    "orderDetailsURI": null,
    "exceedAmt": null
}

This function is to validate Stocks orders and get the authToken for submitting orders.

HTTP Request

POST https://sandboxapi.poems.com.sg/pmobile2/st/trade/validate

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
encryptedPIN	Encrypted PIN generated from client's password by using e2ee client lib

Form Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID
action		1: Buy, 2: Sell, 5: Short Sell
orderType		LO: Limit Order, SLO: Stop Limit Order, LIT: Limit-if-Touched
limitPrice
triggerPrice
quantity
settlementCurrency
payment		0:Cash 1:CPF 2:SRS
triggerPriceType
validity	0
gtd		Good Till Date

Submit Order

Sample Request

curl -X POST \
  https://sandboxapi.poems.com.sg/pmobile2/st/trade/submit \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'authtoken: 0E0A8A46-BAF4-4C04-A5C9-DD48C948EC8C' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 4A0C910E-9827-43EB-B1DF-D1D7DC56EC3C' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FDBS.SG&action=1&orderType=LO&limitPrice=28.15&triggerPrice=28.14&quantity=200&settlementCurrency=SGD&triggerPriceType=2&validity=0&gtd=2017-09-16&payment=0'

Sample Response

{
    "msg": "Order submitted successfully.",
    "code": 1,
    "passwordRequire": false,
    "twoFARequire": false,
    "errors": [],
    "warnings": [],
    "authToken": null,
    "orderNo": 5329076,
    "orderDetailsURI": "/st/order/5329076",
    "exceedAmt": null
}

This function is to submit Stocks orders.

HTTP Request

POST https://sandboxapi.poems.com.sg/pmobile2/st/trade/submit

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
authToken	Authentication Token

Form Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID
action		1: Buy, 2: Sell, 5: Short Sell
orderType		LO: Limit Order, SLO: Stop Limit Order, LIT: Limit-if-Touched
limitPrice
triggerPrice
quantity
settlementCurrency
payment		0:Cash 1:CPF 2:SRS
triggerPriceType
validity	0
gtd		Good Till Date

Order Status

This is Stock order status, which you can get order details, withdraw order and amend order.

Get Order Details

The functions are to retrieve order details for Stocks.

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/order/5329079?osVersion=6.0.1&language=1&counterID=ST%2FSG%2FSGX%2FDBS.SG&isToday=true' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 8E24D187-175A-4D2D-8B4E-F243DD51F96A' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "passwordRequire": false,
    "twoFARequire": false,
    "counterID": "ST/SG/SGX/DBS.SG",
    "name": "DBS",
    "product": "ST",
    "productIcon": "EQ",
    "action": "BUY",
    "status": "WD",
    "statusDesc": "Withdrawn",
    "statusColor": "RED",
    "submittedPrice": "28",
    "executedPrice": "0",
    "submittedQty": "300",
    "executedQty": "0",
    "remainingQty": "0",
    "orderNo": "5329079",
    "lotSize": "100",
    "orderType": "Limit Order",
    "stopPrice": "",
    "triggeredType": "",
    "validity": "Day",
    "gtd": "",
    "paymentMode": "Cash",
    "settlementCurrency": "SGD",
    "currency": "SGD",
    "message": "",
    "amendURI": "",
    "withdrawURI": "",
    "exchange": "SGX",
    "symbol": "D05",
    "orderHistory": [
        {
            "status": "WD",
            "statusDesc": "Withdrawn",
            "qty": "200",
            "price": "28",
            "time": "05 Mar 2018 06:09 PM",
            "timeCompare": null,
            "message": "Withdrawn"
        },
        {
            "status": "AD",
            "statusDesc": "Order Amended",
            "qty": "200",
            "price": "28",
            "time": "05 Mar 2018 06:09 PM",
            "timeCompare": null,
            "message": "Amend Order Qty from 300 to 200"
        },
        {
            "status": "OR",
            "statusDesc": "Received",
            "qty": "300",
            "price": "28",
            "time": "05 Mar 2018 06:08 PM",
            "timeCompare": null,
            "message": "Received"
        }
    ]
}

This function is to retrieve the details of order by order ID for Stocks.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/order/{orderNo}

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID
isToday	true

Path Parameters

Parameter	Description
orderNo	Order No.

Withdraw Order

The functions are to withdraw orders for Stocks.

Sample Request

curl -X POST \
  https://sandboxapi.poems.com.sg/pmobile2/st/order/5329077/withdraw \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -H 'deviceid: deviceid-sample' \
  -H 'encryptedpin: AECC9F115C23036F39A4A2AFB019545DFEA83B9AFB817E206C712E213A8377368E420FBB60CB83FEB3FBB68836170ECBC85CD1D0C9ECFF50AB7B6E98898FAA7BD0846E3D7DC258B7247217F82A2EABB316AB4989815A5D9E378C52ECD62BD18441A0EC24AFD89590DD05BB5D5040D1C815CBEEC809D924AAE744A98194623A53' \
  -H 'sessionid: 8E24D187-175A-4D2D-8B4E-F243DD51F96A' \
  -H 'versionno: 2.0.0' \
  -d 'osVersion=6.0.1&language=1&counterID=ST%2FSG%2FSGX%2FDBS.SG'

Sample Response

{
    "msg": "Withdrawal request has been sent",
    "code": 1,
    "passwordRequire": true,
    "twoFARequire": false
}

this function is to withdraw the ST order. This function will allow to withdraw the withdrawable order after validating the input data.

HTTP Request

POST https://sandboxapi.poems.com.sg/pmobile2/st/order/{orderNo}/withdraw

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
encryptedPIN	Encrypted PIN generated from client's password by using e2ee client lib

Form Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID

Path Parameters

Parameter	Description
orderNo	Order No.

Amend Order

This function is to amend the ST order.

Stocks

Sample Request

curl -X POST \
  https://sandboxapi.poems.com.sg/pmobile2/st/order/5329086/amend \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -H 'deviceid: deviceid-sample' \
  -H 'encryptedpin: AECC9F115C23036F39A4A2AFB019545DFEA83B9AFB817E206C712E213A8377368E420FBB60CB83FEB3FBB68836170ECBC85CD1D0C9ECFF50AB7B6E98898FAA7BD0846E3D7DC258B7247217F82A2EABB316AB4989815A5D9E378C52ECD62BD18441A0EC24AFD89590DD05BB5D5040D1C815CBEEC809D924AAE744A98194623A53' \
  -H 'sessionid: 8E24D187-175A-4D2D-8B4E-F243DD51F96A' \
  -H 'versionno: 2.0.0' \
  -d 'osVersion=6.0.1&language=1&counterID=ST%2FSG%2FSGX%2FDBS.SG&amendQty=800'

Sample Response

{
    "msg": "Amend request has been sent",
    "code": 1,
    "passwordRequire": true,
    "twoFARequire": false
}

This function is to amend the ST order. This function will allow to amend the amendable order after validating the input data.

HTTP Request

POST https://sandboxapi.poems.com.sg/pmobile2/st/order/{orderNo}/amend

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
encryptedPIN	Encrypted PIN generated from client's password by using e2ee client lib

Form Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID

Path Parameters

Parameter	Description
orderNo	Order No.

Stock Analytics

This is Stock analytics, which you can get the stock analytics's financial summary, business summary, analyst estimate and disclaimer information.

Basic Stock Info

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/stockanalytics/stockinfo?osVersion=6.0.1&language=1&counterID=ST%2FSG%2FSGX%2FDBS.SG' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 8E24D187-175A-4D2D-8B4E-F243DD51F96A' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "stockData": {
        "currencyCode": "SGD",
        "marketCapitalization": "45,912.66",
        "commonShareOutstanding": "2,460.0344",
        "week52High": "18.600",
        "week52HighDate": "29/09/2014",
        "week52Low": "15.650",
        "week52LowDate": "21/03/2014",
        "week52Return": "12.040",
        "averageDailyVolume": "3.4422",
        "beta": "1.17"
    },
    "lastUpdated": "30-Sep-2014 05:31PM",
    "stockValuation": {
        "currencyCode": "SGD",
        "historicalPERatio": "12.51",
        "peRatio": "11.39",
        "pbv": "1.26",
        "bvps": "14.7104",
        "epsttm": "1.6253"
    },
    "stockDividend": {
        "currencyCode": "SGD",
        "annualDivPerShare": "0.5800",
        "divYieldTTM": "3.13",
        "divYieldAnnual": "3.13",
        "payoutRatio": "18.18",
        "growthRate3Year": "1.18"
    },
    "stockMargin": {
        "grossMargin": "-",
        "operatingProfitMargin": "51.12",
        "netProfitMargin": "44.15"
    },
    "financialStrength": {
        "currencyCode": "SGD",
        "currentRatio": "-",
        "quickRatio": "-",
        "longTermDebtEquity": "33.74",
        "totalDebtEquity": "84.49",
        "interestCoverageRatio": "-",
        "freeCashFlowToFirm": "-2,685.00"
    },
    "peerComparison": [
        {
            "industryPeer": "DBS Group Holdings Ltd",
            "roa": "0.96",
            "roe": "10.71",
            "pe": "12.51",
            "divYield": "3.13",
            "flagCurrentCompany": true
        },
        {
            "industryPeer": "Oversea-Chinese Banking Corp. Limited",
            "roa": "1.13",
            "roe": "13.70",
            "pe": "12.90",
            "divYield": "3.43",
            "flagCurrentCompany": false
        },
        {
            "industryPeer": "United Overseas Bank Ltd",
            "roa": "1.10",
            "roe": "11.51",
            "pe": "12.27",
            "divYield": "3.10",
            "flagCurrentCompany": false
        }
    ]
}

This function is to retrieve the stock information for a exchange.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/stockanalytics/stockinfo

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID

Financial Summary

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/stockanalytics/financialsummary?osVersion=6.0.1&language=1&counterID=ST%2FSG%2FSGX%2FDBS.SG' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 8E24D187-175A-4D2D-8B4E-F243DD51F96A' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "finalcialSummary": "BRIEF: For the six months ended 30 June 2014, DBS Group Holdings Ltd interest income increased 12% to SP$4.35B. Net interest income after loan loss provision increased 23% to SP$2.77B.  Net income increased 20% to SP$2.2B. Net interest income after loan loss provision reflects Institutional Banking segment increase from SP$549M to SP$1.38B, Consumer Banking segment increase from SP$344M to SP$734M, Treasury segment increase from SP$181M to SP$466M.",
    "lastUpdated": "30-Sep-2014 05:31PM",
    "currency": "SGD",
    "annualFinancialStatement": [
        {
            "cssClass": "CssClass",
            "description": "Income Statement",
            "values": [
                "FY2013",
                "FY2012",
                "FY2011",
                "FY2010",
                "FY2009"
            ]
        },
        {
            "cssClass": "",
            "description": "Total Interest Income",
            "values": [
                "7,986.00",
                "7,621.00",
                "6,555.00",
                "5,699.00",
                "6,114.00"
            ]
        },
        ...
    ],
    "annualRatioAndOtherData": [
        {
            "cssClass": "",
            "description": "ROA (%)",
            "values": [
                "1.03",
                "1.16",
                "1.05",
                "0.69",
                "0.86"
            ]
        },
        {
            "cssClass": "",
            "description": "ROE (%)",
            "values": [
                "11.12",
                "12.56",
                "10.85",
                "6.16",
                "8.90"
            ]
        },
        ...
    ],
    "quarterFinancialStatement": [
        {
            "cssClass": "CssClass",
            "description": "Income Statement",
            "values": [
                "FY2014  Q2",
                "FY2014  Q1",
                "FY2013  Q4",
                "FY2013  Q3",
                "FY2013  Q2"
            ]
        },
        {
            "cssClass": "",
            "description": "Total Interest Income",
            "values": [
                "2,218.00",
                "2,129.00",
                "2,085.00",
                "2,006.00",
                "1,975.00"
            ]
        },
        ...
    ],
    "quarterRatioAndOtherData": [
        {
            "cssClass": "",
            "description": "ROA (%)",
            "values": [
                "0.96",
                "1.21",
                "1.01",
                "0.91",
                "0.97"
            ]
        },
        {
            "cssClass": "",
            "description": "ROE (%)",
            "values": [
                "10.71",
                "13.84",
                "11.33",
                "10.59",
                "10.94"
            ]
        },
        ...
    ]
}

This function is to retrieve the stock analytics's financial summary information for a exchange.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/stockanalytics/financialsummary

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID

Business Summary

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/stockanalytics/businesssummary?osVersion=6.0.1&language=1&counterID=ST%2FSG%2FSGX%2FDBS.SG' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 8E24D187-175A-4D2D-8B4E-F243DD51F96A' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "businessSummary": "DBS Group Holdings Ltd operates through its main subsidiary, DBS Bank Ltd (the Bank). The Bank is engaged in the provision of retail, small and medium-sized enterprise, corporate and investment banking services. The Company's financial businesses are organized into four segments: consumer Banking/Wealth Management, institutional banking, treasury and others. Consumer Banking/Wealth Management provides individual customers with a range of banking and related financial services. Institutional Banking provides financial services and products to institutional clients, including bank and non bank financial institutions, government linked companies, large corporates and small and medium-sized businesses. Treasury provides treasury services to corporations, institutional and private investors, financial institutions and other market participants. In June 2014, its indirect wholly owned subsidiary, DBS Bank (Hong Kong) Limited, acquired 50% interest in Hutchison DBS Card Limited.",
    "lastUpdated": "30-Sep-2014 05:31PM"
}

This function is to retrieve the stock analytics's summary information for a exchange.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/stockanalytics/businesssummary

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID

Analyst Estimate

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/stockanalytics/analystestimate?osVersion=6.0.1&language=1&counterID=ST%2FSG%2FSGX%2FDBS.SG' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 8E24D187-175A-4D2D-8B4E-F243DD51F96A' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "lastUpdated": "30-Sep-2014 05:31PM",
    "recommendations": [
        {
            "description": "Buy",
            "currentWeek": "9"
        },
        {
            "description": "Outperform",
            "currentWeek": "12"
        },
        {
            "description": "Hold",
            "currentWeek": "3"
        },
        {
            "description": "Underperform",
            "currentWeek": "0"
        },
        {
            "description": "Sell",
            "currentWeek": "0"
        },
        {
            "description": "No Recommendation",
            "currentWeek": "0"
        }
    ],
    "targetPrice": {
        "phillipPotentialChange": "-6.9",
        "phillipRecommendation": "Reduce",
        "phillipTargetPrice": "17.240",
        "priceCurrency": "SGD",
        "reuterPotentialChange": "0.0",
        "reuterRecommendation": "Outperform",
        "reuterTargetPrice": "N/A",
        "reuterLastTradedPrice": "18.520",
        "reuterLastTradedPriceDate": "29/09/14"
    }
}

This function is to retrieve the stock estimate information for a exchange.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/stockanalytics/analystestimate

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID

Disclaimer

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/stockanalytics/disclaimer?osVersion=6.0.1&language=1&counterID=ST%2FSG%2FSGX%2FDBS.SG' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 8E24D187-175A-4D2D-8B4E-F243DD51F96A' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "disclaimer": "<html> <head><title>Stock Analytics Disclaimer</title><style>td.style5{height: 12.75pt;width: 302pt;color: windowtext;font-size: 8.0pt;font-weight: 700;font-style: normal;text-decoration: none;font-family: Arial, sans-serif;text-align: general;vertical-align: bottom;white-space: nowrap;border-style: none;border-color: inherit;border-width: medium;padding-left: 1px;padding-right: 1px;padding-top: 1px;}td.style6{width: 130pt;color: windowtext;font-size: 8.0pt;font-weight: 700;font-style: normal;text-decoration: none;font-family: Arial, sans-serif;text-align: general;vertical-align: bottom;white-space: nowrap;border-style: none;border-color: inherit;border-width: medium;padding-left: 1px;padding-right: 1px;padding-top: 1px;}td.style7{height: 12.75pt;color: windowtext;font-size: 8.0pt;font-weight: 400;font-style: normal;text-decoration: none;font-family: Arial, sans-serif;text-align: general;vertical-align: bottom;white-space: nowrap;border-style: none;border-color: inherit;border-width: medium;padding-left: 1px;padding-right: 1px;padding-top: 1px;}td.style9{color: windowtext;font-size: 8.0pt;font-weight: 400;font-style: normal;text-decoration: none;font-family: Arial, sans-serif;text-align: left;vertical-align: bottom;white-space: nowrap;border-style: none;border-color: inherit;border-width: medium;padding-left: 1px;padding-right: 1px;padding-top: 1px;}</style>...</html>"
}

This function is to retrieve the stock analytics's disclaimer information for a exchange.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/stockanalytics/disclaimer

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID

Portfolio

This is Stock portfolio, which you can get Stocks account details and position details.

Get Stocks Account Details

Sample Request

curl -X GET \
'https://sandboxapi.poems.com.sg/pmobile2/st/portfolio/accountdetails?osVersion=6.0.1&language=1' \
-H 'accountno: 0000000' \
-H 'accounttype: V' \
-H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
-H 'deviceid: deviceid-sample' \
-H 'sessionid: 8E24D187-175A-4D2D-8B4E-F243DD51F96A' \
-H 'versionno: 2.0.0' \
-d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
"msg": "Success",
"code": 1,
"lastUpdated": "07-Mar-2018 07:15AM",
"accountDetails": [
{
"currency": "SGD",
"balanceAsYesterday": "-277,553.87",
"fundReceivedToday": "0",
"openingBalanceToday": "-277,553.87",
"itemsDueForSettlement": "0",
"availableBalance": "0",
"allItemsOutstanding": "3,011.59",
"netAmount": "0",
"totalAssetValue": "437,259",
"collateralValue": "0",
"marginCall": "0",
"marginRatio": "89.9",
"creditLimit": "300,000",
"purchaseA": "0",
"purchaseB": "0",
"purchaseC": "0",
"purchaseS": "0",
"cashCall": "-19,206.34",
"isGBOImplemented": "Yes",
"forceSellingIndicator": "No",
"initialMargin": "0">
}
],
"needDisclaimer": false,
"disclaimers": []
}

This function is to retrieve Stocks account details.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/portfolio/accountdetails

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
accountType

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version

Get Stocks Holdings (Unrealized Profit/Loss)

Sample Request

curl -X GET \
'https://sandboxapi.poems.com.sg/pmobile2/st/portfolio/holdings?osVersion=6.0.1&language=1&accountType=V' \
-H 'accountno: 0000000' \
-H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
-H 'deviceid: deviceid-sample' \
-H 'sessionid: 8E24D187-175A-4D2D-8B4E-F243DD51F96A' \
-H 'versionno: 2.0.0' \
-d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
"msg": "success",
"code": 1,
"total": "-6,591.023",
"currency": "SGD",
"lastUpdated": "19-Sep-2017 09:40AM",
"holdings": [
{
"exchange": "SGX",
"currencies": [
{
"currency": "USD",
"unrealizedPL": "-3,752.645",
"list": [
{
"counterID": "",
"name": "MANULREIT USD R",
"unrealizedPL": "-19.13",
"qty": "5,033",
"mktValue": "956.27",
"aveCostPrice": "0.193",
"closingPrice": "0.19",
"tradedCurr": "USD",
"suspendedQty": "0",
"totalCost": "975.4",
"symbol": null,
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": false
},
{
"counterID": "ST/SG/SGX/DFH.SG",
"name": "DAIRY FARM",
"unrealizedPL": "234.989",
"qty": "3,665",
"mktValue": "37,599.9",
"aveCostPrice": "8.009",
"closingPrice": "8.06",
"tradedCurr": "USD",
"suspendedQty": "0",
"totalCost": "29,355.283",
"symbol": "D01",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
},
...
]
},
{
"currency": "SGD",
"unrealizedPL": "-8,820.474",
"list": [
{
"counterID": "ST/SG/SGX/ADIT.SG",
"name": "ASCENDAS-ITRUST",
"unrealizedPL": "90.703",
"qty": "13,374",
"mktValue": "18,083.25",
"aveCostPrice": "1.119",
"closingPrice": "1.125",
"tradedCurr": "SGD",
"suspendedQty": "0",
"totalCost": "14,970.282",
"symbol": "CY6U",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
},
{
"counterID": "ST/SG/SGX/APTT.SG",
"name": "ASIAN PAY TV TR",
"unrealizedPL": "1.205",
"qty": "63",
"mktValue": "36.225",
"aveCostPrice": "0.555",
"closingPrice": "0.575",
"tradedCurr": "SGD",
"suspendedQty": "0",
"totalCost": "35.019",
"symbol": "S7OU",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
},
...
]
},
{
"currency": "HKD",
"unrealizedPL": "84.04",
"list": [
{
"counterID": "ST/SG/SGX/FRE.SG",
"name": "FORTUNE REIT",
"unrealizedPL": "84.04",
"qty": "249",
"mktValue": "2,265.9",
"aveCostPrice": "8.762",
"closingPrice": "9.1",
"tradedCurr": "HKD",
"suspendedQty": "0",
"totalCost": "2,181.86",
"symbol": "F25U",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
}
]
}
]
},
{
"exchange": "SEHK",
"currencies": [
{
"currency": "HKD",
"unrealizedPL": "5,219.585",
"list": [
{
"counterID": "ST/HK/SEHK/0494.HK",
"name": "LI & FUNG",
"unrealizedPL": "5,219.585",
"qty": "0",
"mktValue": "48,720",
"aveCostPrice": "3.625",
"closingPrice": "4.06",
"tradedCurr": "HKD",
"suspendedQty": "0",
"totalCost": "0",
"symbol": "0494.HK",
"market": "HK",
"exchange": "SEHK",
"delayIndicator": "*",
"tradable": true
}
]
}
]
}
],
"needDisclaimer": false,
"disclaimers": []
}

This function is to return the script positions/holdings for Stocks by passing the account type.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/portfolio/holdings

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
accountType		Account Type (M, V, C)

Get Stocks foreign Holdings

Sample Request

curl -X GET \
'https://sandboxapi.poems.com.sg/pmobile2/st/portfolio/foreignholdings?osVersion=6.0.1&language=1&accountType=V' \
-H 'accountno: 0000000' \
-H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
-H 'deviceid: deviceid-sample' \
-H 'sessionid: 8E24D187-175A-4D2D-8B4E-F243DD51F96A' \
-H 'versionno: 2.0.0' \
-d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
"msg": "success",
"code": 1,
"total": "-6,591.023",
"currency": "SGD",
"lastUpdated": "19-Sep-2017 09:40AM",
"holdings": [
{
"exchange": "SGX",
"currencies": [
{
"currency": "USD",
"unrealizedPL": "-3,752.645",
"list": [
{
"counterID": "",
"name": "MANULREIT USD R",
"unrealizedPL": "-19.13",
"qty": "5,033",
"mktValue": "956.27",
"aveCostPrice": "0.193",
"closingPrice": "0.19",
"tradedCurr": "USD",
"suspendedQty": "0",
"totalCost": "975.4",
"symbol": null,
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": false
},
{
"counterID": "ST/SG/SGX/DFH.SG",
"name": "DAIRY FARM",
"unrealizedPL": "234.989",
"qty": "3,665",
"mktValue": "37,599.9",
"aveCostPrice": "8.009",
"closingPrice": "8.06",
"tradedCurr": "USD",
"suspendedQty": "0",
"totalCost": "29,355.283",
"symbol": "D01",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
},
...
]
},
{
"currency": "SGD",
"unrealizedPL": "-8,820.474",
"list": [
{
"counterID": "ST/SG/SGX/ADIT.SG",
"name": "ASCENDAS-ITRUST",
"unrealizedPL": "90.703",
"qty": "13,374",
"mktValue": "18,083.25",
"aveCostPrice": "1.119",
"closingPrice": "1.125",
"tradedCurr": "SGD",
"suspendedQty": "0",
"totalCost": "14,970.282",
"symbol": "CY6U",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
},
{
"counterID": "ST/SG/SGX/APTT.SG",
"name": "ASIAN PAY TV TR",
"unrealizedPL": "1.205",
"qty": "63",
"mktValue": "36.225",
"aveCostPrice": "0.555",
"closingPrice": "0.575",
"tradedCurr": "SGD",
"suspendedQty": "0",
"totalCost": "35.019",
"symbol": "S7OU",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
},
...
]
},
{
"currency": "HKD",
"unrealizedPL": "84.04",
"list": [
{
"counterID": "ST/SG/SGX/FRE.SG",
"name": "FORTUNE REIT",
"unrealizedPL": "84.04",
"qty": "249",
"mktValue": "2,265.9",
"aveCostPrice": "8.762",
"closingPrice": "9.1",
"tradedCurr": "HKD",
"suspendedQty": "0",
"totalCost": "2,181.86",
"symbol": "F25U",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
}
]
}
]
},
{
"exchange": "SEHK",
"currencies": [
{
"currency": "HKD",
"unrealizedPL": "5,219.585",
"list": [
{
"counterID": "ST/HK/SEHK/0494.HK",
"name": "LI & FUNG",
"unrealizedPL": "5,219.585",
"qty": "0",
"mktValue": "48,720",
"aveCostPrice": "3.625",
"closingPrice": "4.06",
"tradedCurr": "HKD",
"suspendedQty": "0",
"totalCost": "0",
"symbol": "0494.HK",
"market": "HK",
"exchange": "SEHK",
"delayIndicator": "*",
"tradable": true
}
]
}
]
}
],
"needDisclaimer": false,
"disclaimers": []
}

This function is to return the foreign holdings for Stocks by passing the account type.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/portfolio/foreignholdings

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
accountType		Account Type (M, V, C)

Get Stocks Holdings new

Sample Request

curl -X GET \
'https://sandboxapi.poems.com.sg/pmobile2/st/portfolio/holdingsnew?osVersion=6.0.1&language=1&accountType=V' \
-H 'accountno: 0000000' \
-H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
-H 'deviceid: deviceid-sample' \
-H 'sessionid: 8E24D187-175A-4D2D-8B4E-F243DD51F96A' \
-H 'versionno: 2.0.0' \
-d 'language=1&osVersion=5&accountType=V'

Sample Response

{
"msg": "success",
"code": 1,
"total": "-6,591.023",
"currency": "SGD",
"lastUpdated": "19-Sep-2017 09:40AM",
"holdings": [
{
"exchange": "SGX",
"currencies": [
{
"currency": "USD",
"unrealizedPL": "-3,752.645",
"list": [
{
"counterID": "",
"name": "MANULREIT USD R",
"unrealizedPL": "-19.13",
"qty": "5,033",
"mktValue": "956.27",
"aveCostPrice": "0.193",
"closingPrice": "0.19",
"tradedCurr": "USD",
"suspendedQty": "0",
"totalCost": "975.4",
"symbol": null,
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": false
},
{
"counterID": "ST/SG/SGX/DFH.SG",
"name": "DAIRY FARM",
"unrealizedPL": "234.989",
"qty": "3,665",
"mktValue": "37,599.9",
"aveCostPrice": "8.009",
"closingPrice": "8.06",
"tradedCurr": "USD",
"suspendedQty": "0",
"totalCost": "29,355.283",
"symbol": "D01",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
},
...
]
},
{
"currency": "SGD",
"unrealizedPL": "-8,820.474",
"list": [
{
"counterID": "ST/SG/SGX/ADIT.SG",
"name": "ASCENDAS-ITRUST",
"unrealizedPL": "90.703",
"qty": "13,374",
"mktValue": "18,083.25",
"aveCostPrice": "1.119",
"closingPrice": "1.125",
"tradedCurr": "SGD",
"suspendedQty": "0",
"totalCost": "14,970.282",
"symbol": "CY6U",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
},
{
"counterID": "ST/SG/SGX/APTT.SG",
"name": "ASIAN PAY TV TR",
"unrealizedPL": "1.205",
"qty": "63",
"mktValue": "36.225",
"aveCostPrice": "0.555",
"closingPrice": "0.575",
"tradedCurr": "SGD",
"suspendedQty": "0",
"totalCost": "35.019",
"symbol": "S7OU",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
},
...
]
},
{
"currency": "HKD",
"unrealizedPL": "84.04",
"list": [
{
"counterID": "ST/SG/SGX/FRE.SG",
"name": "FORTUNE REIT",
"unrealizedPL": "84.04",
"qty": "249",
"mktValue": "2,265.9",
"aveCostPrice": "8.762",
"closingPrice": "9.1",
"tradedCurr": "HKD",
"suspendedQty": "0",
"totalCost": "2,181.86",
"symbol": "F25U",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
}
]
}
]
},
{
"exchange": "SEHK",
"currencies": [
{
"currency": "HKD",
"unrealizedPL": "5,219.585",
"list": [
{
"counterID": "ST/HK/SEHK/0494.HK",
"name": "LI & FUNG",
"unrealizedPL": "5,219.585",
"qty": "0",
"mktValue": "48,720",
"aveCostPrice": "3.625",
"closingPrice": "4.06",
"tradedCurr": "HKD",
"suspendedQty": "0",
"totalCost": "0",
"symbol": "0494.HK",
"market": "HK",
"exchange": "SEHK",
"delayIndicator": "*",
"tradable": true
}
]
}
]
}
],
"needDisclaimer": false,
"disclaimers": []
}

This function is to return the new holdings for Stocks by passing the account type.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/portfolio/holdingsnew

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
accountType		Account Type (M, V, C)

Get Stocks Holdings new

Sample Request

curl -X GET \
'https://sandboxapi.poems.com.sg/pmobile2/st/portfolio/holdingsnew?osVersion=6.0.1&language=1&accountType=V' \
-H 'accountno: 0000000' \
-H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
-H 'deviceid: deviceid-sample' \
-H 'sessionid: 8E24D187-175A-4D2D-8B4E-F243DD51F96A' \
-H 'versionno: 2.0.0' \
-d 'language=1&osVersion=5&accountType=V'

Sample Response

{
"msg": "success",
"code": 1,
"total": "-6,591.023",
"currency": "SGD",
"lastUpdated": "19-Sep-2017 09:40AM",
"holdings": [
{
"exchange": "SGX",
"currencies": [
{
"currency": "USD",
"unrealizedPL": "-3,752.645",
"list": [
{
"counterID": "",
"name": "MANULREIT USD R",
"unrealizedPL": "-19.13",
"qty": "5,033",
"mktValue": "956.27",
"aveCostPrice": "0.193",
"closingPrice": "0.19",
"tradedCurr": "USD",
"suspendedQty": "0",
"totalCost": "975.4",
"symbol": null,
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": false
},
{
"counterID": "ST/SG/SGX/DFH.SG",
"name": "DAIRY FARM",
"unrealizedPL": "234.989",
"qty": "3,665",
"mktValue": "37,599.9",
"aveCostPrice": "8.009",
"closingPrice": "8.06",
"tradedCurr": "USD",
"suspendedQty": "0",
"totalCost": "29,355.283",
"symbol": "D01",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
},
...
]
},
{
"currency": "SGD",
"unrealizedPL": "-8,820.474",
"list": [
{
"counterID": "ST/SG/SGX/ADIT.SG",
"name": "ASCENDAS-ITRUST",
"unrealizedPL": "90.703",
"qty": "13,374",
"mktValue": "18,083.25",
"aveCostPrice": "1.119",
"closingPrice": "1.125",
"tradedCurr": "SGD",
"suspendedQty": "0",
"totalCost": "14,970.282",
"symbol": "CY6U",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
},
{
"counterID": "ST/SG/SGX/APTT.SG",
"name": "ASIAN PAY TV TR",
"unrealizedPL": "1.205",
"qty": "63",
"mktValue": "36.225",
"aveCostPrice": "0.555",
"closingPrice": "0.575",
"tradedCurr": "SGD",
"suspendedQty": "0",
"totalCost": "35.019",
"symbol": "S7OU",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
},
...
]
},
{
"currency": "HKD",
"unrealizedPL": "84.04",
"list": [
{
"counterID": "ST/SG/SGX/FRE.SG",
"name": "FORTUNE REIT",
"unrealizedPL": "84.04",
"qty": "249",
"mktValue": "2,265.9",
"aveCostPrice": "8.762",
"closingPrice": "9.1",
"tradedCurr": "HKD",
"suspendedQty": "0",
"totalCost": "2,181.86",
"symbol": "F25U",
"market": "SG",
"exchange": "SGX",
"delayIndicator": "",
"tradable": true
}
]
}
]
},
{
"exchange": "SEHK",
"currencies": [
{
"currency": "HKD",
"unrealizedPL": "5,219.585",
"list": [
{
"counterID": "ST/HK/SEHK/0494.HK",
"name": "LI & FUNG",
"unrealizedPL": "5,219.585",
"qty": "0",
"mktValue": "48,720",
"aveCostPrice": "3.625",
"closingPrice": "4.06",
"tradedCurr": "HKD",
"suspendedQty": "0",
"totalCost": "0",
"symbol": "0494.HK",
"market": "HK",
"exchange": "SEHK",
"delayIndicator": "*",
"tradable": true
}
]
}
]
}
],
"needDisclaimer": false,
"disclaimers": []
}

This function is to return the new holdings for Stocks by passing the account type.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/portfolio/holdingsnew

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
accountType		Account Type (M, V, C)

Get Stocks Profit and Loss

Sample Request

curl -X GET \
'https://sandboxapi.poems.com.sg/pmobile2/st/portfolio/profitandloss?flag=1&language=1&osVersion=9' \
-H 'accountno: 0000000' \
-H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
-H 'deviceid: deviceid-sample' \
-H 'sessionid: 8E24D187-175A-4D2D-8B4E-F243DD51F96A' \
-H 'versionno: 2.0.0' \
-d 'language=1&osVersion=5&flag=1'

Sample Response

{
"msg": "success",
"code": 1,
"profitLoss": [
   {
     "exchange": "LSE",
     "listExchange": [
        {
          "realizedPLTotal": "0",
          "openQtyCostTotal": "0",
          "marktValueTotal": "214,500",
          "unrealizedPLTotal": "0",
          "subTotalCurrency": "GBX",
          "list": [
             {
               "counterID": "ST/UK/LSE/AAL.UK",
               "name": "ANGLO AMERICAN PLC",
               "unrealizedPL": "0",
               "fdCode": "AAL",
               "symbol": null,
               "tradedCurr": "GBX",
               "openQtyCost": "214,500.00",
               "avgPrice": "2,145",
               "currPrice": "2,145",
               "marketVal": "214,500",
               "realizePL": "0",
               "buyQty": "100",
               "sellQty": "0",
               "sellAvePrice": "0",
               "buyAvePrice": "2,145",
               "closedQty": "0",
               "openQty": "100",
               "market": "UK",
               "exchange": "LSE",
               "companyCode": "AAL.UK",
               "settledQty": 0,
               "settledTotalCost": 0,
               "lastDone": 0,
               "netPositionQty": 0,
               "outstandingBuyCost": 0,
               "outstandingBuyQty": 0,
               "outstandingNetQty": 0,
               "outstandingSellCost": 0,
               "outstandingSellQty": 0,
               "outstandingTotalCost": 0,
               "totalCost": 0,
               "intraBuyCost": 0,
               "intraBuyQty": 0,
               "intraSellCost": 0,
               "intraSellQty": 0,
               "tradable": true
             }
          ]
        }
     ]
   }
 ],
"needDisclaimer": false,
"disclaimers": [],
"currency": "SGD",
"realizedPLtotal": "0.00",
"openQtyCosttotal": "0.00",
"marktValuetotal": "214,500.00",
"unrealizedPLtotal": "0.00"
}

This function is to return the Live Positions.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/portfolio/profitandloss

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
flag		1:Intraday, 2:Settled Positions, 4:Outstanding Positions

Outstanding Positions

This is global outstanding postions, which you can get outstanding position information for Stocks and UT.

Get Stocks Outstanding Position Contract Details

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/osposition/contract?osVersion=6.0.1&language=1&accountType=V&id=455355%2F400%2F01' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: D18D1B1E-E011-485D-8F18-6FDF9E3EA98E' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "counterID": "ST/SG/SGX/BUN.SG",
    "contractNo": "455355/400/01",
    "contractDate": "11-Mar-2018",
    "dueDate": "16-Mar-2018",
    "price": "0.5252",
    "quantity": "83",
    "settlementAmount": "-48.95",
    "settlementAmountColor": "Red",
    "paymentMode": "CASH",
    "exchangeRate": "1",
    "currency": "SGD"
}

This function is to return the account contract details (Margin Call, Ledger DEflicits) for Stocks.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/osposition/contract

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
accountType		Account Type (M, V, C)
id		Contract ID

Get Stocks Outstanding Position Contra Details

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/osposition/contra?osVersion=6.0.1&language=1&accountType=V&id=0501948' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: D18D1B1E-E011-485D-8F18-6FDF9E3EA98E' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "counterID": "ST/SG//ASHT.SG",
    "contraNo": "0501948",
    "date": "16-Mar-2018",
    "dueDate": "16-Mar-2018",
    "exchangeRate": "1",
    "paymentMode": "",
    "paymentDue": "223.13",
    "paymentDueColor": "Green",
    "currency": "SGD",
    "contracts": [
        {
            "contractNo": "436313/400/01",
            "action": "BUY",
            "contractDate": "10-Mar-2018",
            "particulars": "ASCENDAS-HTRUST 30,000 SGD 0.85",
            "amount": "-25,538.20",
            "amountColor": "Red",
            "currency": "SGD"
        },
        {
            "contractNo": "487958/700/01",
            "action": "SELL",
            "contractDate": "13-Mar-2018",
            "particulars": "ASCENDAS-HTRUST 30,000 SGD 0.86",
            "amount": "25,761.33",
            "amountColor": "Green",
            "currency": "SGD"
        }
    ]
}

This function is to return the account contra details (Margin Call, Ledger DEflicits) for Stocks.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/osposition/contra

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
accountType		Account Type (M, V, C)
id		Contra ID

Online Forms - Stocks

This is Stocks online forms, which you can get withdrawal form and currency conversion form information, validate the withdrawal form and currency conversion form, submit the withdrawal form and currency conversion form, get online form history and cancel onlines form.

Get Stocks Withdrawal Form Info

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/withdrawalforminfo?osVersion=6.0.1&language=1' \
  -H 'accountno: 0000000' \
  -H 'accounttype: V' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: D18D1B1E-E011-485D-8F18-6FDF9E3EA98E' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "passwordRequire": true,
    "twoFARequire": false,
    "processDates": [
        "20180308",
        "20180309",
        "20180312",
        "20180313"
    ],
    "otherAccounts": [
        {
            "text": "(ZZ) 1000107 ((V))",
            "acctNo": "1000107",
            "spelCd": "(V)",
            "remisierCd": "ZZ"
        },
        {
            "text": "(ZZ) 1000115 ((V))",
            "acctNo": "1000115",
            "spelCd": "(V)",
            "remisierCd": "ZZ"
        },
        ...
    ],
    "rewardOptions": [
        {
            "text": "SGX MKT DEPTH ACCESS 20Q 1 MTH $21.40",
            "code": "RP-SMDA1M",
            "amount": 21.4
        },
        {
            "text": "SGX MKT DEPTH ACCESS 20Q 3 MTH $64.20",
            "code": "RP-SMDA3M",
            "amount": 64.2
        },
        ...
    ],
    "withdrawalTypes": [
        {
            "currency": "SGD",
            "supportedWithdrawalType": [
                {
                    "text": "Deposit to DBS/POSB Bank Account 554-54445-4",
                    "value": "DEPOSIT_LOCAL_BANK"
                },
                {
                    "text": "Quick Cheque Deposit into Bank",
                    "value": "CHEQUE_DEPOSIT"
                },
                ...
            ]
        }
    ]
}

This function is to retrieve the information of the Stocks online withdrawal form information for the current login account.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/withdrawalforminfo

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
accountType

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version

Validate Stocks Withdrawal Form

Sample Request

curl -X POST \
  https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/withdrawal/validate \
  -H 'accountno: 0000000' \
  -H 'accounttype: V' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -H 'deviceid: deviceid-sample' \
  -H 'encryptedpin: AC0EF751D0EECFE58ECA6FF91F487896BFA371A2E1FFEBC8FDAE804C02BBA427B5264F3D49D7929F338368459A677E3517BE82D0A36A1FA2A9CF78103372B96C5D3D6CB81E80B1928C6ED1273C17F36D783FDD78D5551FEF7132508C87DC06906B0418C3B65E8A527A955807D9DEB7082D4F8C1D25B5DB3A63A6DD70BCA3DC4F' \
  -H 'sessionid: D18D1B1E-E011-485D-8F18-6FDF9E3EA98E' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&withdrawalType=DEPOSIT_LOCAL_BANK&amount=1000&currency=SGD&processDate=20180308&remarks=sample&ttAcctNo=&ttAcctName=&ttBank=&ttDetail=&ttBranch=&ttSwiftCd=&ttInterBank=&ttInterSwiftCd=&taAcctNo=&taSpelCd=&taDetails=&taRemisierCd=&dcBank=&dcAccountNo=&rpCode=&rpOthers='

Sample Response

{
    "msg": "success",
    "code": 1,
    "passwordRequire": true,
    "twoFARequire": false,
    "authToken": "99D94B62-9EB2-47D1-B9AE-E1D48E1FD3B9",
    "confirmMessage": "Deposit into DBS/POSB bank\\nA/C No: 554-54445-4\\nSGD 1,000.00 on 08-Mar-2018",
    "note": "Withdrawal request submitted before 10.00 am will be processed on the same business day and the fund will be deposited into your bank account the next business day. Payment to 3rd party is not allowed. Sale proceeds will be made available for withdrawal from Contract Due Date 1."
}

This function is to validate the online withdrawal form before submitting the form. This function will validate the withdrawal form by checking the input parameters depending on the type of withdrawal and return back the authentication token required for form submission process.

HTTP Request

POST https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/withdrawal/validate

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
encryptedPIN	Encrypted PIN generated from client's password by using e2ee client lib
accountType	Account Type (eg.M)

Form Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
withdrawalType		Withdrawal Type (eg.DEPOSIT_LOCAL_BANK)
amount		Withdrawal Amount
currency		Currency (eg.SGD)
processDate		Process Date (yyyyMMdd)
remarks
ttAcctNo		TT Account No.
ttAcctName		TT Account Holder Name
ttBank		TT Bank Name
ttDetail		TT Detail
ttBranch		TT Bank Branch (Country/State)
ttSwiftCd		TT Swift Code
ttInterBank		TT Intermediary Bank
ttInterSwiftCd		TT Intermediary Bank Swift Code
taAcctNo		TA Account No
taSpelCd		TA Special Code
taDetails		TA Details
taRemisierCd		TA Remisier Code
dcBank		DC Bank Name
dcAccountNo		DC Bank Account No.
rpCode		Rewards Program Code (eg.RP-MD1M)
rpOthers		Description for RP-OTHERS ( Required if the rpCode is RP-OTHERS)

Submit Stocks Withdrawal Form

Sample Request

curl -X POST \
  https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/withdrawal/submit \
  -H 'accountno: 0000000' \
  -H 'accounttype: V' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'authtoken: 99D94B62-9EB2-47D1-B9AE-E1D48E1FD3B9' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: A93EF168-8CF5-49C2-8827-FB24A7256B31' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&withdrawalType=DEPOSIT_LOCAL_BANK&amount=1000&currency=SGD&processDate=20180308&remarks=sample&ttAcctNo=&ttAcctName=&ttBank=&ttDetail=&ttBranch=&ttSwiftCd=&ttInterBank=&ttInterSwiftCd=&taAcctNo=&taSpelCd=&taDetails=&taRemisierCd=&dcBank=&dcAccountNo=&rpCode=&rpOthers='

Sample Response

{
    "msg": "Withdrawal Request submitted.",
    "code": 1,
    "passwordRequire": true,
    "twoFARequire": false
}

This function is to submit the online withdrawal form.

HTTP Request

POST https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/withdrawal/submit

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
authToken	Authentication Token
accountType	Account Type (eg.M)

Form Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
withdrawalType		Withdrawal Type (eg.DP)
amount		Withdrawal Amount
currency		Currency (eg.SGD)
processDate		Process Date (yyyyMMdd)
remarks
ttAcctNo		TT Account No.
ttAcctName		TT Account Holder Name
ttBank		TT Bank Name
ttDetail		TT Detail
ttBranch		TT Bank Branch (Country/State)
ttSwiftCd		TT Swift Code
ttInterBank		TT Intermediary Bank
ttInterSwiftCd		TT Intermediary Bank Swift Code
taAcctNo		TA Account No
taSpelCd		TA Special Code
taDetails		TA Details
taRemisierCd		TA Remisier Code
dcBank		DC Bank Name
dcAccountNo		DC Bank Account No.
rpCode		Rewards Program Code (eg.RP-MD1M)
rpOthers		Description for RP-OTHERS ( Required if the rpCode is RP-OTHERS)

Get Stocks Currency Conversion Form Info

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/currencyconversion?language=1&osVersion=5' \
  -H 'accountno: 0000000' \
  -H 'accounttype: V' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: A93EF168-8CF5-49C2-8827-FB24A7256B31' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&withdrawalType=DEPOSIT_LOCAL_BANK&amount=1000&currency=SGD&processDate=20180308&remarks=sample&ttAcctNo=&ttAcctName=&ttBank=&ttDetail=&ttBranch=&ttSwiftCd=&ttInterBank=&ttInterSwiftCd=&taAcctNo=&taSpelCd=&taDetails=&taRemisierCd=&dcBank=&dcAccountNo=&rpCode=&rpOthers='

Sample Response

{
    "msg": "success",
    "code": 1,
    "passwordRequire": true,
    "twoFARequire": false,
    "optIn": false,
    "currencies": [
        "SGD",
        "CNY",
        "GBP",
        "HKD",
        "USD"
    ],
    "processDates": [
        "20180308",
        "20180309",
        "20180312",
        "20180313"
    ],
    "conversionType": [
        {
            "text": "Convert amount",
            "value": "CONVERT_AMOUNT"
        },
        {
            "text": "Convert to offset debit balance",
            "value": "CONVERT_OFFSET"
        }
    ]
}

This function is to get Stocks currency conversion form information.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/currencyconversion

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
accountType

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version

Validate Stocks Currency Conversion Form

Sample Request

curl -X POST \
  https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/currencyconversion/validate \
  -H 'accountno: 0000000' \
  -H 'accounttype: V' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -H 'deviceid: deviceid-sample' \
  -H 'encryptedpin: AB64F3EA01FE3667C56F2FFAC3FEB7F2CC1217327508450CC808CA1260EFE41B3C990D7F4E1A9D70091D69F468B00CD4C406CB864287BFE93884577D32425CE3F0236E86C828C7332C19D893BA5AE226CCA587CDB168F994848FA2E285B7600755F9723A7A44AA15C2C2F2B6756A525019DDE59543EC1D85023BAC24B39565AC' \
  -H 'sessionid: A93EF168-8CF5-49C2-8827-FB24A7256B31' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&conversionType=CONVERT_AMOUNT&sourceCurrency=SGD&processDate=20180308&sourceAmount=1000&targetCurrency=USD&targetAmount=&offsetSourceCurrecny=&offsetTargetCurrecny=&remarks=sample'

Sample Response

{
    "msg": "Currency conversion request submitted.",
    "code": 1,
    "passwordRequire": false,
    "twoFARequire": false,
    "authToken": "3D8529A6-0C1E-41D5-9BE4-4BF56A6B3E0F",
    "confirmMessage": "Convert SGD 1000 to USD  on 08-Mar-2018."
}

This function is to validate Stocks currency conversion information.

HTTP Request

POST https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/currencyconversion/validate

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
encryptedPIN	Encrypted PIN generated from client's password by using e2ee client lib
accountType	Account Type (eg.M)

Form Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
processDate
conversionType		Conversion Type (EMPTY, CONVERT_AMOUNT, OPT_IN_MULTI_CURRENCY, CONVERT_OFFSET)
sourceCurrency
sourceAmount
targetCurrency
targetAmount
offsetSourceCurrecny		It will have data when conversion type is CONVERT_OFFSET
offsetTargetCurrecny		It will have data when conversion type is CONVERT_OFFSET
remarks

Submit Stocks Currency Conversion Form

Sample Request

curl -X POST \
  https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/currencyconversion/submit \
  -H 'accountno: 0000000' \
  -H 'accounttype: V' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'authtoken: 3D8529A6-0C1E-41D5-9BE4-4BF56A6B3E0F' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 2184EDF0-682A-42D1-9FBF-5DF15B85AA71' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&conversionType=CONVERT_AMOUNT&sourceCurrency=SGD&processDate=20180308&sourceAmount=1000&targetCurrency=USD&targetAmount=&offsetSourceCurrecny=&offsetTargetCurrecny=&remarks=sample'

Sample Response

{
    "msg": "Success",
    "code": 1,
    "passwordRequire": true,
    "twoFARequire": false
}

This function is to submit successful validation Stokcs currency conversion information.

HTTP Request

POST https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/currencyconversion/submit

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
authToken	Authentication Token
accountType	Account Type (eg.M)

Form Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
processDate
conversionType		Conversion Type (EMPTY, CONVERT_AMOUNT, OPT_IN_MULTI_CURRENCY, CONVERT_OFFSET)
sourceCurrency
sourceAmount
targetCurrency
targetAmount
offsetSourceCurrecny		It will have data when conversion type is CONVERT_OFFSET
offsetTargetCurrecny		It will have data when conversion type is CONVERT_OFFSET
remarks

Get Stocks Online Form History

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/history?language=1&osVersion=5&period=201803' \
  -H 'accountno: 0000000' \
  -H 'accounttype: V' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 2184EDF0-682A-42D1-9FBF-5DF15B85AA71' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&conversionType=CONVERT_AMOUNT&sourceCurrency=SGD&processDate=20180308&sourceAmount=1000&targetCurrency=USD&targetAmount=&offsetSourceCurrecny=&offsetTargetCurrecny=&remarks=sample'

Sample Response

{
    "msg": "success",
    "code": 1,
    "passwordRequire": true,
    "twoFARequire": false,
    "history": [
        {
            "description": "Convert SGD 1000.00 to USD",
            "status": "Submitted",
            "formType": "CURRENCY_CONVERSION",
            "processNo": "186273",
            "time": "07-Mar-2018 06:22PM",
            "cancellable": true,
            "adminRemark": "",
            "clientRemark": "sample"
        },
        {
            "description": "Deposit into DBS/POSB bank, A/C No. 554-54445-4 - SGD 1000.00",
            "status": "Submitted",
            "formType": "WITHDRAWAL",
            "processNo": "1133234",
            "time": "07-Mar-2018 05:56PM",
            "cancellable": true,
            "adminRemark": "",
            "clientRemark": "sample"
        },
        ...
    ]
}

This function is to retrieve the history of Stocks online withdrawal form for a month. This function allows to filter the withdrawal form history by passing the year and month. The default period is current month.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/history

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
accountType

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version

Cancel Stocks Online Form

Sample Request

curl -X POST \
  https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/cancel \
  -H 'accountno: 0000000' \
  -H 'accounttype: V' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -H 'deviceid: deviceid-sample' \
  -H 'encryptedpin: 7D644365C1C54B90139B1E814E61A1E7F5B585A106ADC3D880D4C94D365DC4DB6548B1DBA73A99E0F376032AC52F3197571783C52FC34558EC552D7E9360345ACC000579E9F1DD6F50089F9F98507F0335CE3C801B2621674808FFE61054BFBED2D0130A8F0BD10B722F3A65C5F37E85AD768D884EB0F54A377A04353022BEA6' \
  -H 'sessionid: 8B75A110-44E1-41F7-9D86-2FB684DBA660' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&wdProcessNos=&ccProcessNos=186272'

Sample Response

{
    "msg": "Cancellation Request submitted.",
    "code": 1,
    "passwordRequire": true,
    "twoFARequire": false
}

This function is to cancel Stocks online forms.

HTTP Request

POST https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/cancel

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
encryptedPIN	Encrypted PIN generated from client's password by using e2ee client lib
accountType	Account Type (eg.M)

Form Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
wdProcessNos		withdraw form process No. is separated by comma
ccProcessNos		currency conversion form process No. is separated by comma

Get Stocks Withdrawal Form Note

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/withdrawal/note?language=1&osVersion=5&currency=SGD&withdrawalType=DEPOSIT_LOCAL_BANK' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 8B75A110-44E1-41F7-9D86-2FB684DBA660' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&wdProcessNos=&ccProcessNos=186272'

Sample Response

{
    "msg": "success",
    "code": 1,
    "note": "Withdrawal request submitted before 10.00 am will be processed on the same business day and the fund will be deposited into your bank account the next business day. Payment to 3rd party is not allowed. Sale proceeds will be made available for withdrawal from Contract Due Date 1."
}

This function is to retrieve the different withdrawal notes according to the currency and action.

HTTP Request

POST https://sandboxapi.poems.com.sg/pmobile2/st/onlineforms/withdrawal/note

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Form Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
currency
withdrawalType		Withdrawal Type (eg.DP)

Get Stocks get excess fund History

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/excessfund/history?language=1&osVersion=5' \
  -H 'accountno: 0000000' \
  -H 'accounttype: V' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 2184EDF0-682A-42D1-9FBF-5DF15B85AA71' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&accountType=V'

Sample Response

{
    "msg": "You have submitted your request.<br />It takes about three working days to process your application.",
    "code": 1,
    "passwordRequire": true,
    "twoFARequire": false,
    "mmfHistory": [
        {
            "processNo": 8083,
            "accNo": "2222222",
            "remisierCode": "ZZ",
            "submittedTime": "2011-02-15 17:39:03.383",
            "status": "Submitted",
            "multiCurrFacility": 0,
            "mmfFacility": 1
        }
    ],
    "actionRequired": false,
    "optInMMF": false,
}

This function is to retrieve the history of excess fund by account type.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/excessfund/history

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
accountType

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
accountType

Get Stocks get excess fund MMFOptInStatus

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/excessfund/mmfoptinstatus?language=1&osVersion=5' \
  -H 'accountno: 0000000' \
  -H 'accounttype: V' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 2184EDF0-682A-42D1-9FBF-5DF15B85AA71' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&accountType=V'

Sample Response

{
    "msg": "You have submitted your request.<br />It takes about three working days to process your application.",
    "code": 1,
    "passwordRequire": true,
    "twoFARequire": false,
    "actionRequired": false,
    "optInMMF": false,
}

This function is to retrieve the mmfoptinstatus of excess fund by account type.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/excessfund/mmfoptinstatus

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
accountType

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
accountType

submit MMF Request

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/excessfund?language=1&osVersion=5' \
  -H 'accountno: 0000000' \
  -H 'accounttype: V' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
-H 'encryptedpin: 13BC859444FF15D7CEE3672F56937E2B84740E0B3B2EF12C47F526136409EC956F091CB2371F6790BDDC601259AE6B15154DB160F20FB653C2AD0CC3D468A5B2DCCE9E0854DCE08A40CAD1D9996890CCAC057945D98AC654ECA1E96FCC34D2497EDB30EE6BA635D5689FD06078B7C37A8A54DDCDEB7871D9C833BBD597C1AF10' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 2184EDF0-682A-42D1-9FBF-5DF15B85AA71' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&accountType=V'

Sample Response

{
    "msg": "You have submitted your request.<br />It takes about three working days to process your application.",
    "code": 1,
    "passwordRequire": true,
    "twoFARequire": false,
    "mmfHistory": [
        {
            "processNo": 8083,
            "accNo": "2222222",
            "remisierCode": "ZZ",
            "submittedTime": "2011-02-15 17:39:03.383",
            "status": "Submitted",
            "multiCurrFacility": 0,
            "mmfFacility": 1
        }
    ],
    "actionRequired": false,
    "optInMMF": false,
}

This function is to submit MMF request.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/excessfund

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID
accountType

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
accountType

Transaction History

The functions are to get the transaction history by passing the currency code and year month.

Get Stocks Transaction History

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/transactionhistory?language=1&osVersion=5&currency=SGD&month=201803&pageSize=100&pageIndex=0&accountType=V' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 98846FE5-A736-4770-9449-AB5E01CDDBFC' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&wdProcessNos=&ccProcessNos=186272'

Sample Response

{
    "msg": "success",
    "code": 1,
    "totalRow": 132,
    "currencies": [
        "HKD",
        "SGD",
        "USD"
    ],
    "transHistory": [
        {
            "currency": "SGD",
            "date": "",
            "description": "TRADING ACCOUNT BALANCE B/F S$",
            "debit": "0.00",
            "credit": "0.00",
            "debitColor": "Red",
            "creditColor": "Green",
            "balance": "-276,034.95"
        },
        {
            "currency": "SGD",
            "date": "02-Mar-2018",
            "description": "2  VENTURE           17.1000",
            "debit": "34.25",
            "credit": "0.00",
            "debitColor": "Red",
            "creditColor": "Green",
            "balance": "-276,069.2"
        },
        ...
    ],
    "lastUpdated": "05-Apr-2017 03:00AM"
}

This function is to get Stocks transaction history by passing the currency code and year.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/transactionhistory

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
currency
month
pageSize	100
pageIndex	0
accountType	Account Type (eg.M)

Stocks News

This is the Stocks news, which you can get news category, news headlines, news contents, related news and pre-login news.

Get News Category

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/news/category?osVersion=2&language=1' \
  -H 'accountno: 0008911' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 6F52FE61-4D1C-4303-B977-BC7CFF0F14DC' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "Success",
    "code": 1,
    "newsCategory": [
        {
            "code": "all",
            "description": "All Headlines",
            "headlineURI": "st/news/headlines/all"
        },
        {
            "code": "%7Cnmsmc%7Cnngmc%7Cnsmcm%7C",
            "description": "Stock Market Commentary",
            "headlineURI": "st/news/headlines/%7Cnmsmc%7Cnngmc%7Cnsmcm%7C"
        },
        ...
    ]
}

This function is to retrieve Stocks new category.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/news/category

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version

Get News Headlines

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/news/headlines/%7Cnmsmc%7Cnngmc%7Cnsmcm%7C?osVersion=2&language=1&search=Malaysia&count=30' \
  -H 'accountno: 0008911' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 6F52FE61-4D1C-4303-B977-BC7CFF0F14DC' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "Success",
    "code": 1,
    "newsHeadline": [
        {
            "title": "Malaysia Stocks Start Lower Tracking Broader Markets -- Market Talk",
            "description": "0108 GMT - Malaysia stocks start Friday lower alongside weaker broader Asian marker following overnight losses on Wall Street. The FBM KLCI Index edges down 0.14% to 1858 points. Among the losers in the index are mobile phone operator Maxis...",
            "publishedTime": "02 Mar 2018 10:17 AM",
            "source": "Dow Jones Institutional News",
            "logoURL": "http://logos.factiva.com/djdnLogo.gif",
            "contentURI": "st/news/content/DJDN000020180302ee3200049",
            "publishedDateTime": 1519957075000
        },
        {
            "title": "Malaysia Stocks Also Start Strongly -- Market Talk",
            "description": "0110 GMT - Malaysia stocks start Tuesday higher alongside fresh broad, solid gains in Asia after more recovery in the US. The FBM KLCI climbs 0.5% to 1869 with Maybank rising 1.5%. It's a heavy day earnings-wise in the country, with the ...",
            "publishedTime": "27 Feb 2018 09:32 AM",
            "source": "Dow Jones Institutional News",
            "logoURL": "http://logos.factiva.com/djdnLogo.gif",
            "contentURI": "st/news/content/DJDN000020180227ee2r0004p",
            "publishedDateTime": 1519695136000
        },
        ...
    ]
}

This function is to retrieve Stocks news headline base on category.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/news/headlines/{category}

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
search
count	30

Path Parameters

Parameter	Description
category	News category code

Get News Contents

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/news/content/DJDN000020180302ee3200049?osVersion=2&language=1' \
  -H 'accountno: 0008911' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 5024BE13-246D-4FD2-9D4C-05044AEB3CB8' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "Success",
    "code": 1,
    "contentType": "html",
    "date": "02 Mar 2018 09:08 AM",
    "description": "<Para>0108 GMT - Malaysia stocks start Friday lower alongside weaker broader Asian marker following overnight losses on Wall Street. The FBM KLCI Index edges down 0.14% to 1858 points. Among the losers in the index are mobile phone operator Maxis...</Para>",
    "id": null,
    "title": "Malaysia Stocks Start Lower Tracking Broader Markets -- Market Talk",
    "content": "<div style=\"padding-bottom:20px;\">0108 GMT - Malaysia stocks start Friday lower alongside weaker broader Asian marker following overnight losses on Wall Street. The FBM KLCI Index edges down 0.14% to 1858 points. Among the losers in the index are mobile phone operator Maxis and lender CIMB. Shares of the companies decline 1.7% and almost 1.0%, respectively. Investors will closely monitor a 4Q earnings announcement by the country's state oil company Petronas at lunchtime local time. (yantoultra.ngui@wsj.com; @yantoultra)</div><div style=\"padding-bottom:20px;\">(END) Dow Jones Newswires</div><div style=\"padding-bottom:20px;\">March 01, 2018 20:08 ET (01:08 GMT)</div>",
    "source": "Dow Jones Institutional News",
    "logourl": "http://logos.factiva.com/djdnLogo.gif"
}

This function is to retrieve Stocks news content base on category and newsid.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/news/content/{newsid}

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version

Path Parameters

Parameter	Description
newsid	News ID

Get Related News

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/news/related?osVersion=2&language=1&counterID=ST%2FSG%2FSGX%2FDBS.SG&count=30' \
  -H 'accountno: 0008911' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: 5024BE13-246D-4FD2-9D4C-05044AEB3CB8' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "Success",
    "code": 1,
    "newsHeadline": [
        {
            "title": "Roaring celebrations for DBS",
            "description": "DBS Bank's group head of consumer banking and wealth management Tan Su Shan and chief executive Piyush Gupta with children dressed as lion cubs. Mr Gupta and DBS chairman Peter Seah led 50 children in a lion dance performance for the bank's...",
            "publishedTime": "26 Feb 2018 08:00 AM",
            "source": "The Straits Times",
            "logoURL": "http://logos.factiva.com/stimesLogo.gif",
            "contentURI": "st/news/content/STIMES0020180225ee2q002mz",
            "publishedDateTime": 1519603212000
        },
        {
            "title": "Global Equities Roundup: Market Talk",
            "description": "The latest Market Talks covering Equities. Published exclusively on Dow Jones Newswires throughout the day.2149 ET - DBS thinks Singapore's builders are turning cautious with their bids for land parcels after more sites are sold without a ...",
            "publishedTime": "19 Feb 2018 11:03 AM",
            "source": "Dow Jones Institutional News",
            "logoURL": "http://logos.factiva.com/djdnLogo.gif",
            "contentURI": "st/news/content/DJDN000020180219ee2j0003f",
            "publishedDateTime": 1519009431000
        },
        ...
    ]
}

This function is to retrieve Stocks releted news to company code.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/news/related

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
counterID
count	30

Get Pre-login News

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/news/prelogin?osVersion=2&language=1&count=30' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "Success",
    "code": 1,
    "newsHeadline": [
        {
            "title": "Defence spending to remain steady even as other countries spend more on wide-ranging security threats: Ng Eng Hen",
            "description": "SINGAPORE - Substantial investments by past governments in building up the Singapore Armed Forces (SAF) will allow Singapore to keep its defence spending steady even as countries in the region are spending more and against wide-ranging ...",
            "publishedTime": "02 Mar 2018 12:04 PM",
            "source": "The Straits Times",
            "logoURL": "http://logos.factiva.com/stimesLogo.gif",
            "contentURI": "st/news/content/STIMES0020180302ee32000p2",
            "publishedDateTime": 1519963483000
        },
        {
            "title": "Australia hopes to be exempted from US metal tariffs amid fears of trade war",
            "description": "SYDNEY - In Australia, US President Donald Trump's proposed tariffs on steel and aluminium imports have raised concerns of a \"trade war\" involving escalating global barriers that will lead to curbs on Australian resources exports.",
            "publishedTime": "02 Mar 2018 11:49 AM",
            "source": "The Straits Times",
            "logoURL": "http://logos.factiva.com/stimesLogo.gif",
            "contentURI": "st/news/content/STIMES0020180302ee32000m9",
            "publishedDateTime": 1519962578000
        },
        ...
    ]
}

This function is to retrieve Stocks prelogin news headlines.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/news/prelogin

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
count	30

Alerts

This is Stock alerts, which you can get the account alert details for Stocks.

Get Stocks Account Alerts

Sample Request

curl -X GET \
  'https://sandboxapi.poems.com.sg/pmobile2/st/alert/account?osVersion=2&language=1&accountType=V' \
  -H 'accountno: 0000000' \
  -H 'apikey: 3FA5B748-9EC7-41EF-93FA-8C93AC349312' \
  -H 'deviceid: deviceid-sample' \
  -H 'sessionid: F40E6287-9F7E-4140-AD52-313CD8E4B8A3' \
  -H 'versionno: 2.0.0' \
  -d 'language=1&osVersion=5&counterID=ST%2FSG%2FSGX%2FCRP.SG'

Sample Response

{
    "msg": "success",
    "code": 1,
    "timeStamp": "20180312145157",
    "marginCallAmount": null,
    "marginCallAmountDisplay": null,
    "marginCallAmountColor": null,
    "marginCallDate": "12 Mar 2018",
    "ledgerDeficitDate": null,
    "marginCallDays": "0",
    "ledgerDeficits": null
}

This function is to return the account alert details (Margin Call, Ledger DEflicits) for Stocks.

HTTP Request

GET https://sandboxapi.poems.com.sg/pmobile2/st/alert/account

Header Parameters

Parameter	Description
apikey	API key to access the api
versionNo	Application version number
deviceId	Client's device id
accountNo	Login Account Number
sessionId	Session ID

Query Parameters

Parameter	Default	Description
language	1	1: English, 2: Chinese
osVersion		Client's device OS version
accountType		Account Type (eg. M)

Errors

The Kittn API uses the following error codes:

Error Code	Meaning
400	Bad Request -- Your request is invalid.
401	Unauthorized -- Your API key is wrong.
403	Forbidden -- The kitten requested is hidden for administrators only.
404	Not Found -- The specified kitten could not be found.
405	Method Not Allowed -- You tried to access a kitten with an invalid method.
406	Not Acceptable -- You requested a format that isn't json.
410	Gone -- The kitten requested has been removed from our servers.
418	I'm a teapot.
429	Too Many Requests -- You're requesting too many kittens! Slow down!
500	Internal Server Error -- We had a problem with our server. Try again later.
503	Service Unavailable -- We're temporarily offline for maintenance. Please try again later.