/getAccountsPaginated
Returns accounts using page-based or cursor-based pagination.
The endpoint returns the same account payloads as getAccounts, together
with pagination metadata.
Pagination can be configured using either:
- Page-based pagination
- Cursor-based pagination
Filtering and sorting can be applied through the request parameter.
AccountType filter
The optional AccountType filter, under Attributes → FilterFields,
restricts the returned accounts by account type.
Supported values:
omnibussegregated
The value is case-insensitive and leading or trailing whitespace is ignored.
AccountFeatures filter
The optional AccountFeatures filter, under Attributes → FilterFields,
accepts a non-empty array of account feature names.
Supported values:
MultisigAutoBalanceP2SHSegwitNative
When multiple values are provided, an account is returned if it matches any of the selected features (OR logic).
The values are case-insensitive and leading or trailing whitespace is ignored.
Request examples
Page-based pagination:
pages = PageBasedPaginationInformation(1, 10)
req = PaginatedAccountRequest.create(pages)
getAccountsPaginated(req)
Page-based pagination with sorting:
pages = PageBasedPaginationInformation(1, 10)
req = PaginatedAccountRequest.create(
pages,
AccountFilter(
sort_by="AccountName",
sort_order=SortOrder.ASC
)
)
getAccountsPaginated(req, omit_balance=True)
Filter by account IDs:
pages = PageBasedPaginationInformation(1, 10)
req = PaginatedAccountRequest.create(
pages,
AccountFilter(account_ids=[1, 2, 3])
)
getAccountsPaginated(req)
Filter by machine type:
pages = PageBasedPaginationInformation(1, 10)
req = PaginatedAccountRequest.create(
pages,
AccountFilter(machine="mpc")
)
getAccountsPaginated(req)
Filter omnibus or segregated accounts:
pages = PageBasedPaginationInformation(1, 10)
req = PaginatedAccountRequest.create(
pages,
AccountFilter(account_type="segregated")
)
getAccountsPaginated(req)
Filter by account features:
pages = PageBasedPaginationInformation(1, 10)
req = PaginatedAccountRequest.create(
pages,
AccountFilter(
account_features=["Multisig", "P2SH"]
)
)
getAccountsPaginated(req)
Cursor-based pagination:
cursor_pages = CursorPaginationInformation(
cursor=prev_cursor,
page_skip_number=1
)
req = PaginatedAccountRequest.create(
cursor_pages,
AccountFilter(sort_by="AccountId")
)
getAccountsPaginated(req)
-------------------- Response --------------------
"FunctionData": {
"Accounts": [
{
"AccountDataSignedByCold": {
"Addresses": [
{
"CoinSymbol": "BTC",
"ColdAddress": "tb1qqqxm5w4yvun2803dpuet7s02elfqtytffgujjp",
"HotAddress": "tb1qawrecjqrw8ea2jcsln40w3qwdj5lxjlw93l07r"
},
{
"CoinSymbol": "ETH",
"ColdAddress": "0x2Bc7CABBba1b6fF4ca0746de7AA216D2b9fb5dF3",
"HotAddress": "0xec5ef2afa2DB4C3FEEDA26fFcC1E1dB255dE0774"
},
{
"CoinSymbol": "BCH",
"ColdAddress": "bchtest:qqnt9w7rl3fa60jetq59pd4tlujh6a325s4r3ryl3k",
"HotAddress": "bchtest:qp6xkp4w09m9vr7wwuyk4qrma54qgagezyg7gn2chf"
},
{
"CoinSymbol": "XRP",
"ColdAddress": "r9M2JCRZYZwhD9Tdq8zYkstDqNGoSZrBAA",
"HotAddress": "rMfdA4DmD1rRax46ajnYUzzkQrqbvqpFmt"
},
{
"CoinSymbol": "XLM",
"ColdAddress": "GBBPA4VYBCDUS6S2UIOKAMVRIKCDCXQ6TTC2DPZUB7UK2AQO6FDSFU47",
"HotAddress": "GCZFWXP34DXM65WCDVFODEMKYMGSZ4X55AOMTMPHHMT2UOB6OV7GDO4S"
},
{
"CoinSymbol": "ADA",
"ColdAddress": "addr_test1qz2pkpz6udf4k562xqzdduawgysaaj9yq8gf4pkyt3z5avcakuh3wc03eck9ges9uaransu45mnqnjhfyu3vjd3tv96szv29ut",
"HotAddress": "addr_test1qpkxp5s5pxlsxllyrvx3exx96twxd35wymtxzk2f7qa38c3sf6qpjy7qzvvf2hgyftc7zdyc30x96l2hh2flvtaqd5sq80eqfx"
},
{
"CoinSymbol": "XTZ",
"ColdAddress": "tz1ZfDgFrUnn6dMfXS1bCD2VJtv6zR1UW5HW",
"HotAddress": "tz1T5eX4Fid63AoPbWzwESecYSWrMhYPzamS"
},
{
"CoinSymbol": "NEAR",
"ColdAddress": "b82940fa0ec462e0c57ed80345ae9ac7b0755358068c798d974d3486eca331dc",
"HotAddress": "172fbb490b896132ecd3fd13b5752621c5d130a6dc41fae910f3f5a47afdbefa"
},
{
"CoinSymbol": "HBAR",
"ColdAddress": "0xb1f93c385e58958aea183e7606ee08ce3fefe35a",
"HotAddress": "0xecb8cbbb6069a48b9eeee04c336582d53860cf7e"
},
{
"CoinSymbol": "IOTA",
"ColdAddress": "0xd507242e32b43936aee267f2c30cb105bac7fd6d5a35fa477dd727e6695abad0",
"HotAddress": "0xb4578cf9824dd5a25c7c602308c7ceba05f33555e561e430c58568a9225db46b"
},
{
"CoinSymbol": "SMR",
"ColdAddress": "rms1qr66qr5m2rh0qdtdlkvexquth9hdza8kqn3yjnys2z6zadtm975dzh8zdys",
"HotAddress": "rms1qqwv66dew3p7qxxar2jk8rlp445j3q5d2pwk8ucrdavgphzcjaq45gghl6j"
},
{
"CoinSymbol": "ATOM",
"ColdAddress": "cosmos1j4xz9fykeyfw9d26tu0meeffa29d0vf507alrd",
"HotAddress": "cosmos1y9lfl4jdzc0ll53c5w69r8mat55p8ylv4qg87w"
},
{
"CoinSymbol": "TRX",
"ColdAddress": "TMa4xisv8JbSTNGqWd4nCCYR5kKSM5UjwS",
"HotAddress": "TA5s6YmeZngqu9K8Qji238A6HfJV4uqc7C"
},
{
"CoinSymbol": "SOL",
"ColdAddress": "AwAnf533Tjs2AzJfrYmsGDAcHSqpm4LVSNwy3DFWFMWU",
"HotAddress": "9oru9hQzUhvizMfrouS5J9LpFmgnsQ8ErLG7ZVQRtPG4",
"StakingColdAddress": "BSeVEddF8RMLW2swLQcFjk3S9hmPoX9sUuwn2nrdywaN"
},
{
"CoinSymbol": "CSPR",
"ColdAddress": "01cc8eba02cad3f15fd2127e11e8962b0a7cc5e80c21e7af2478f1488a51dac1d8",
"HotAddress": "01e0a22af86837687acad6ace471de545197e47f25d50180acf20279128152c5fd"
},
{
"CoinSymbol": "STRK",
"ColdAddress": "0x06E006483e48c2face517055bF0df85eCcFb34aa17474349C5537F5B2605bFdF",
"HotAddress": "0x05caFBdBD8FC904430c9Ae2AA3557A54b5E4ecce00993708661dF225B60761e2"
},
{
"CoinSymbol": "POLYX",
"ColdAddress": "5E5NzrEfYXXbMJGoQCT8VdbAzaNPdwdS5TeN7vbqcr2GRA9n",
"HotAddress": "5FdJCh9bst331DaqMd1u565W2UQ8fz2ypwz83L9bxHM341DP"
}
],
"BitcoinAddressFormat": 2,
"Id": 1002,
"IsImportedFromMpcToCold": false,
"Time": "2025-10-09 10:58:32.184"
},
"BalancesAndPriceForAccount": [
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "7",
"CoinSymbol": "BTC",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "ETH",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "8773",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "8773",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "BCH",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "8773",
"HotIncludingWalletsFunds": "8773"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "2",
"CoinSymbol": "XRP",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "XLM",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "1000000",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "1000000",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "ADA",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "1000000",
"HotIncludingWalletsFunds": "1000000"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "XTZ",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "NEAR",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "HBAR",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "IOTA",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": "-",
"Hot": "-",
"HotIncludingWallets": "-"
},
"CoinPrice": "1",
"CoinSymbol": "SMR",
"Cold": "-",
"ColdFunds": "-",
"Hot": "-",
"HotFunds": "-",
"HotIncludingWalletsFunds": "-"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "ATOM",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "TRX",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "SOL",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "CSPR",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "STRK",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": "-",
"Hot": "-",
"HotIncludingWallets": "-"
},
"CoinPrice": "1",
"CoinSymbol": "POLYX",
"Cold": "-",
"ColdFunds": "-",
"Hot": "-",
"HotFunds": "-",
"HotIncludingWalletsFunds": "-"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "ETHS",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "4005.05485",
"CoinSymbol": "LINETH",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "GRAVITY",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": "-",
"Hot": "-",
"HotIncludingWallets": "-"
},
"CoinPrice": "1",
"CoinSymbol": "HOLESKY",
"Cold": "-",
"ColdFunds": "-",
"Hot": "-",
"HotFunds": "-",
"HotIncludingWalletsFunds": "-"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "USDT_TRX",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
}
],
"TotalAmountInFiat": "1.00008773",
"TotalAmountIncludingWalletsInFiat": "1.00008773",
"isConnectedByUserGroup": "true"
}
],
"AllAccountsBasicData": [
{
"AccountBalancingFrequency": null,
"AccountBalancingInfo": [],
"AccountId": 1,
"AccountName": "Main Account",
"AccountNotificationsOnTransaction": {
"Users": null
},
"AvailableAccountApprovers": {
"Users": null
},
"BitcoinAddressFormat": 1,
"IsEndpointAccount": false,
"IsImportedFromMpcToCold": false,
"IsMultisigAccount": false,
"NumberOfActiveWallets": 2,
"RequiredAccountApprovers": 0,
"TotalAmountInFiat": "19892.420604846",
"TotalAmountIncludingWalletsInFiat": "19892.420604846"
},
{
"AccountBalancingFrequency": null,
"AccountBalancingInfo": [],
"AccountId": 1001,
"AccountName": "Seg Account 1",
"AccountNotificationsOnTransaction": {
"Users": null
},
"AvailableAccountApprovers": {
"Users": null
},
"BitcoinAddressFormat": 2,
"IsEndpointAccount": true,
"IsImportedFromMpcToCold": false,
"IsMultisigAccount": false,
"NumberOfActiveWallets": 1,
"RequiredAccountApprovers": 0,
"TotalAmountInFiat": "11.285725009",
"TotalAmountIncludingWalletsInFiat": "47.104012009"
},
{
"AccountBalancingFrequency": null,
"AccountBalancingInfo": [],
"AccountId": 1002,
"AccountName": "Mpc Account 1",
"AccountNotificationsOnTransaction": {
"Users": null
},
"AvailableAccountApprovers": {
"Users": null
},
"BitcoinAddressFormat": 2,
"IsEndpointAccount": false,
"IsImportedFromMpcToCold": false,
"IsMultisigAccount": false,
"NumberOfActiveWallets": 0,
"RequiredAccountApprovers": 0,
"TotalAmountInFiat": "1.00008773",
"TotalAmountIncludingWalletsInFiat": "1.00008773"
}
],
"MpcAccounts": [
{
"AccountDataSignedByMpc": {
"AccountBalancingFrequency": null,
"AccountBalancingInfo": [],
"AccountNotificationsOnTransaction": {
"Users": null
},
"AvailableAccountApprovers": {
"Users": null
},
"BitcoinAddressFormat": 2,
"Id": 1002,
"IsActivated": true,
"IsEndpointAccount": "false",
"IsImportedFromMpcToCold": false,
"NickName": "Mpc Account 1",
"RequiredAccountApprovers": 0,
"Time": "2025-10-16 07:53:03.595",
"isMultisigAccount": "false"
},
"BalancesAndPriceForAccount": [
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "7",
"CoinSymbol": "BTC",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
},
{
"BalanceData": {
"Cold": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"Hot": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
},
"HotIncludingWallets": {
"Available": "0",
"Frozen": "0",
"Pending": "0"
}
},
"CoinPrice": "1",
"CoinSymbol": "ETH",
"Cold": "-",
"ColdFunds": "0",
"Hot": "-",
"HotFunds": "0",
"HotIncludingWalletsFunds": "0"
}
],
"TotalAmountInFiat": "1.00008773",
"TotalAmountIncludingWalletsInFiat": "1.00008773",
"isConnectedByUserGroup": "true"
}
],
"isUserMultisigApprover": "false"
}
curl --request POST \
--url '/getAccountsPaginated?request={%0A%20%20%22PageBasedPagination%22%3A%20{%0A%20%20%20%20%22PageIndex%22%3A%201%2C%0A%20%20%20%20%22PageSize%22%3A%2010%0A%20%20}%2C%0A%20%20%22Attributes%22%3A%20{%0A%20%20%20%20%22FilterFields%22%3A%20{%0A%20%20%20%20%20%20%22AccountType%22%3A%20%22segregated%22%2C%0A%20%20%20%20%20%20%22AccountFeatures%22%3A%20[%0A%20%20%20%20%20%20%20%20%22Multisig%22%2C%0A%20%20%20%20%20%20%20%20%22P2SH%22%0A%20%20%20%20%20%20]%0A%20%20%20%20}%2C%0A%20%20%20%20%22SortBy%22%3A%20%22AccountName%22%2C%0A%20%20%20%20%22SortOrder%22%3A%200%0A%20%20}%0A}%0A&omit_balance=true' \
--header 'accept: application/json'