Get Holding Statement
GET/v1.2/statement/positions
This is used to get the current position details of a given customer under a given account number.
Request
Query Parameters
year integerrequired
only accepts current year or a previous year
Example: 2022
month integerrequired
Possible values: >= 1
and <= 12
if current year is given, month must be current month or a previous month
customerNumber stringrequired
Possible values: <= 20 characters
accountNumber string
Possible values: <= 50 characters
Security account number
contentType stringrequired
currently only accepts json format
Example: json
Header Parameters
Throttle-Key string
Responses
- 200
- 401
OK
- application/json
- Schema
- Example (from schema)
- Equity/Option
- Fixed Income
- Mutual Funds
- Spot
Schema
- Array [
- Array [
- Array [
- Array [
- ]
- ]
- ]
- ]
status stringrequired
reason string
rejectCode integer
customerNumber string
month integer
year integer
period string
list object[]
accountNumber string
securityType string
Possible values: [CS
, OPT
, BND
, FND
]
list object[]
exchangeAccountId string
exchange string
list object[]
symbol string
totalHolding number
This is only for equity, option and spot asset types.
totalAmount number
This is only for bond and fund asset types.
list object[]
transactionDate string
Possible values: Value must match regular expression ^[0-9]{4}/(0[1-9]|1[0-2])/(0[1-9]|[1-2][0-9]|3[0-1])$
narration string
quantity number
This is only for equity, option and spot asset types.
amount number
This is only for bond and fund asset types.
{
"status": "string",
"reason": "string",
"rejectCode": 0,
"customerNumber": "string",
"month": 0,
"year": 0,
"period": "string",
"list": [
{
"accountNumber": "string",
"securityType": "CS",
"list": [
{
"exchangeAccountId": "string",
"exchange": "string",
"list": [
{
"symbol": "string",
"totalHolding": 0,
"totalAmount": 0,
"list": [
{
"transactionDate": "string",
"narration": "string",
"quantity": 0,
"amount": 0
}
]
}
]
}
]
}
]
}
{
"status": "SUCCESS",
"customerNumber": "ASI446440071",
"month": 8,
"year": 2023,
"period": "2023/08/01 to 2023/08/31",
"list": [
{
"accountNumber": "P000284060",
"securityType": "CS",
"list": [
{
"exchangeAccountId": "686566",
"exchange": "NSDQ",
"list": [
{
"symbol": "AAPL - AAPL",
"totalHolding": 200,
"list": [
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237910 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237910 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237910 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237910 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237910 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237910 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237910 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237910 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237910 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237910 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237920 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237920 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237920 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237920 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237920 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237920 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237920 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237920 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237920 Buy 10.00000000@ 175.84000",
"quantity": 10
},
{
"transactionDate": "2023/08/22",
"narration": "Ord:2237920 Buy 10.00000000@ 175.84000",
"quantity": 10
}
]
}
]
}
]
}
]
}
{
"status": "SUCCESS",
"customerNumber": "ASI114817125",
"month": 3,
"year": 2024,
"period": "2024/03/01 to 2024/03/31",
"list": [
{
"accountNumber": "P000284369",
"list": [
{
"exchangeAccountId": "694824",
"exchange": "GTNFI",
"list": [
{
"symbol": "ANZ 3.652 01/20/26 - ANZ 3.652 20 JAN 2026",
"list": [
{
"transactionDate": "2024/03/01",
"narration": "Opening Balance",
"amount": 4000
}
],
"totalAmount": 0
}
]
},
{
"exchangeAccountId": "691444",
"exchange": "BOND",
"list": [
{
"symbol": "ANF 1",
"list": [
{
"transactionDate": "2024/03/01",
"narration": "Opening Balance",
"amount": 1000000000000
}
],
"totalAmount": 0
}
]
}
],
"securityType": "BND"
}
]
}
{
"status": "SUCCESS",
"customerNumber": "253602837",
"month": 3,
"year": 2024,
"period": "2024/03/01 to 2024/03/31",
"list": [
{
"accountNumber": "P001133137",
"list": [
{
"exchangeAccountId": "2334960",
"exchange": "MFSFUNDS",
"list": [
{
"symbol": "LU0371570317 ABERDEEN STANDARD ISLAMIC GLOBAL EQUITY \"A\" (USD) ACC",
"list": [
{
"transactionDate": "2024/03/20",
"narration": "Inv ID: FO240320-2-000003 Subscription - Amount 90090.72000 USD @12.00000",
"amount": 416.67
},
{
"transactionDate": "2024/03/20",
"narration": "Inv ID: FO240320-2-000003 Subscription - Amount 90089.46000 USD @23.00000",
"amount": 217.39
},
{
"transactionDate": "2024/03/20",
"narration": "Inv ID: FO240320-2-000003 Subscription - Amount 90090.00000 USD @100.00000",
"amount": 50
},
{
"transactionDate": "2024/03/20",
"narration": "Inv ID: FO240320-2-000003 Subscription - Amount 90090.00000 USD @100.00000",
"amount": 50
},
{
"transactionDate": "2024/03/20",
"narration": "Inv ID: FO240320-2-000003 Subscription - Amount 90090.00000 USD @100.00000",
"amount": 50
}
],
"totalAmount": 0
},
{
"symbol": "AFB008093906 kelum fund",
"list": [
{
"transactionDate": "2024/03/01",
"narration": "OPENING BALANCE",
"amount": 143630
}
],
"totalAmount": 0
},
{
"symbol": "LU0820775533 GOLDMAN SACHS US REAL ESTATE BALANCED PORTFOLIO \"BS\" ACC",
"list": [
{
"transactionDate": "2024/03/20",
"narration": "Inv ID: FO240320-2-000037 Subscription - Amount 90090.00000 USD @100.00000",
"amount": 50
},
{
"transactionDate": "2024/03/20",
"narration": "Inv ID: FO240320-2-000037 Subscription - Amount 90090.00000 USD @100.00000",
"amount": 50
},
{
"transactionDate": "2024/03/20",
"narration": "Inv ID: FO240320-2-000037 Subscription - Amount 90090.00000 USD @178.45000",
"amount": 28.01905
}
],
"totalAmount": 0
},
{
"symbol": "AFB007013406 SNB CAPITA MULTI-ASSET CONSERVATIVE (USD) ACC",
"list": [
{
"transactionDate": "2024/03/13",
"narration": "Inv ID: FO240313-2-000024 Subscription - Amount 90090.72000 USD @12.00000",
"amount": 416.67
},
{
"transactionDate": "2024/03/13",
"narration": "Inv ID: FD240313-0-122456 Deposit - Amount USD @100.00000",
"amount": 10000000
},
{
"transactionDate": "2024/03/15",
"narration": "Inv ID: FO240313-2-000024 Subscription - Amount 180179.28000 USD @12.00000",
"amount": 833.33
}
],
"totalAmount": 0
},
{
"symbol": "LU0128526901 FRANKLIN U.S. DOLLAR SHORT-TERM MONEY MARKET \"A\" ACC",
"list": [
{
"transactionDate": "2024/03/20",
"narration": "Inv ID: FO240320-2-000035 Subscription - Amount 36036.00000 USD @100.00000",
"amount": 20
}
],
"totalAmount": 0
},
{
"symbol": "LU0237698245 FIDELITY GLOBAL PROPERTY \"A\" (USD) INC",
"list": [
{
"transactionDate": "2024/03/20",
"narration": "Inv ID: FO240320-2-000023 Subscription - Amount 90090.00000 USD @100.00000",
"amount": 50
},
{
"transactionDate": "2024/03/20",
"narration": "Inv ID: FO240320-2-000023 Subscription - Amount 126126.00000 USD @100.00000",
"amount": 70
}
],
"totalAmount": 0
}
]
}
],
"securityType": "FND"
}
]
}
{
"status": "SUCCESS",
"customerNumber": "253602837",
"month": 4,
"year": 2024,
"period": "2024/04/01 to 2024/04/30",
"list": [
{
"accountNumber": "P001133136",
"list": [
{
"exchangeAccountId": "2348940",
"exchange": "GTNSPOT",
"list": [
{
"symbol": "XAU/USD",
"totalHolding": 300,
"list": [
{
"transactionDate": "2024/04/01",
"narration": "Ord:10930407 Buy 100.00000@ 10.00000",
"quantity": 100
},
{
"transactionDate": "2024/04/01",
"narration": "Ord:10930408 Buy 100.00000@ 10.00000",
"quantity": 100
},
{
"transactionDate": "2024/04/01",
"narration": "Ord:10930447 Buy 100.00000@ 10.00000",
"quantity": 100
}
]
}
]
},
{
"exchangeAccountId": "2334940",
"exchange": "NSDQ",
"list": [
{
"symbol": "AAPL - APPLE",
"totalHolding": 10100,
"list": [
{
"transactionDate": "2024/04/01",
"narration": "OPENING BALANCE",
"quantity": 9100
},
{
"transactionDate": "2024/04/01",
"narration": "Ord:10930449 Buy 100.00000@ 10.00000",
"quantity": 100
},
{
"transactionDate": "2024/04/01",
"narration": "Ord:10930449 Buy 100.00000@ 10.00000",
"quantity": 100
},
{
"transactionDate": "2024/04/01",
"narration": "Ord:10930449 Buy 100.00000@ 10.00000",
"quantity": 100
},
{
"transactionDate": "2024/04/01",
"narration": "Ord:10930449 Buy 100.00000@ 10.00000",
"quantity": 100
},
{
"transactionDate": "2024/04/01",
"narration": "Ord:10930449 Buy 100.00000@ 10.00000",
"quantity": 100
},
{
"transactionDate": "2024/04/01",
"narration": "Ord:10930455 Buy 100.00000@ 10.00000",
"quantity": 100
},
{
"transactionDate": "2024/04/01",
"narration": "Ord:10930455 Buy 100.00000@ 10.00000",
"quantity": 100
},
{
"transactionDate": "2024/04/01",
"narration": "Ord:10930455 Buy 100.00000@ 10.00000",
"quantity": 100
},
{
"transactionDate": "2024/04/01",
"narration": "Ord:10930455 Buy 100.00000@ 10.00000",
"quantity": 100
},
{
"transactionDate": "2024/04/01",
"narration": "Ord:10930455 Buy 100.00000@ 10.00000",
"quantity": 100
}
]
}
]
}
],
"securityType": "CS"
}
]
}
Unauthorized
- application/json
- Schema
- Example (from schema)
- Invalid Token
- Expired Token
Schema
timestamp string
status string
error string
message string
path string
rejectCode string
{
"timestamp": "string",
"status": "string",
"error": "string",
"message": "string",
"path": "string",
"rejectCode": "string"
}
{
"timestamp": "2023-12-28T09:51:50.682Z",
"status": "401",
"error": "Unauthorized",
"message": "Invalid Token",
"path": "/api/v1.2/statement/positions",
"rejectCode": "1008"
}
{
"timestamp": "2023-12-28T09:51:50.682Z",
"status": "401",
"error": "Unauthorized",
"message": "Expired Token",
"path": "/api/v1.2/statement/positions",
"rejectCode": "1007"
}
Loading...
Is this page helpful for you?