Pular para o conteúdo principal

Paginação

Endpoints GET que retornam listas de objetos suportam paginação para controlar o volume de dados retornados.

Como funciona

Quando uma resposta possui mais registros disponíveis, o campo paginationToken retorna true. Envie este token na próxima requisição para obter a próxima página.

Parâmetros

ParâmetroTipoDescrição
limitintegerNúmero máximo de registros por página. Máximo: 100
paginationTokenstringToken recebido na resposta anterior para buscar a próxima página

Exemplo de Fluxo

1. Primeira requisição:

curl "https://api-caas-it-sandbox.liqi.app.br/account/fetchProfiles?limit=10" \
-H "Authorization: Bearer {token}"

Resposta:

{
"paginationToken": true,
"data": [
{"id": "01J1...", "profile": "cliente-1", ...},
{"id": "01J2...", "profile": "cliente-2", ...}
]
}

2. Próxima página (enquanto paginationToken for true):

curl "https://api-caas-it-sandbox.liqi.app.br/account/fetchProfiles?limit=10&paginationToken=..." \
-H "Authorization: Bearer {token}"

Última página (paginationToken retorna false):

{
"paginationToken": false,
"data": [...]
}

Endpoints Paginados

Os seguintes endpoints suportam paginação:

  • GET /account/fetchProfiles
  • GET /wallet/fetchBalances
  • GET /wallet/fetchStatement
  • GET /wallet/fetchStatementCategory
  • GET /market/fetchExchanges
  • GET /market/fetchTickers
  • GET /orders/fetchOrders
  • GET /transactions/transfers
  • GET /transactions/balances
dica

Quando o parâmetro limit não é informado, o padrão é 100 objetos por página.