Toss Invest icon

Toss Invest

Use the Toss Securities Open API

Asset → Get Holdings

AI-generated

Summary

Retrieve the current holdings of an investment account, optionally filtered by a specific stock symbol.

Inputs

  • Account Sequence — The unique identifier (accountSeq) of the investment account to query. If left empty, the node uses the default account sequence set in the credentials.
  • Symbol — Optional stock symbol to filter holdings. Provide a specific symbol to retrieve a particular holding; leave empty to retrieve all holdings.

Output shape

a list of holding records in JSON format

The output contains an array of holdings from the specified account filtered optionally by symbol. Requires a valid account sequence either as input or within the credentials. Throws an error if account sequence is missing.

Examples

Example 1: Get all holdings for the default account

Leave Account Sequence empty and Symbol empty to fetch all holdings.

Example 2: Get holdings filtered by a stock symbol

Specify Account Sequence or set default in credentials, and provide Symbol to filter holdings.

Links

Discussion