Skip to main content

Pagination

When you access the list of transactions all items will have an associated cursor position. This cursor can be used to paginate through the list by defining the after variable in the GraphQL request.

Example request with pagination​

Note the pageInfo object containing the cursor and page values. The edges object contains the transaction data.

  • endCursor: When paginating forwards, the cursor to continue.
  • hasNextPage: When paginating forwards, are there more items?
query transactionsForAccount($walletIds: [WalletId], $first: Int, $after: String) {
  me {
    id
    defaultAccount {
      transactions(walletIds: $walletIds, first: $first, after: $after) {
        pageInfo {
          endCursor
          hasNextPage
        }
        edges {
          cursor
          node {
            direction
            settlementCurrency
            settlementDisplayAmount
            status
            createdAt
          }
        }
      }
    }
  }
}

Variables​

  • first (Int): Returns the first n items from the list.
  • after (String): Returns the items in the list that come after the specified cursor.

The variables used in the request to show the 3 most recent transactions for the default account:

{
  "first": 2,
  "after": null
}

Sample response showing the first 3 transactions​

{
  "data": {
    "me": {
      "id": "dd3771d0-66b2-4b28-8757-b1a5db0f8fcf",
      "defaultAccount": {
        "transactions": {
          "pageInfo": {
            "endCursor": "653787e933905fc03c13e2bc",
            "hasNextPage": true
          },
          "edges": [
            {
              "cursor": "6538bda9491e13fd6416b5f3",
              "node": {
                "direction": "RECEIVE",
                "settlementCurrency": "USD",
                "settlementDisplayAmount": "0.01",
                "status": "SUCCESS",
                "createdAt": 1698217385
              }
            },
            {
              "cursor": "6538b68c491e13fd6416722d",
              "node": {
                "direction": "RECEIVE",
                "settlementCurrency": "USD",
                "settlementDisplayAmount": "1.00",
                "status": "SUCCESS",
                "createdAt": 1698215564
              }
            },
            {
              "cursor": "653787e933905fc03c13e2bc",
              "node": {
                "direction": "RECEIVE",
                "settlementCurrency": "BTC",
                "settlementDisplayAmount": "0.47",
                "status": "SUCCESS",
                "createdAt": 1698138089
              }
            }
          ]
        }
      }
    }
  }
}

Variables to show the next two transactions​

To show the next two transactions the endCursor value from the previous response is used as the after variable in the next request:

{
  "first": 2,
  "after": "653787e933905fc03c13e2bc"
}

Sample response showing the next two transactions​

{
  "data": {
    "me": {
      "id": "dd3771d0-66b2-4b28-8757-b1a5db0f8fcf",
      "defaultAccount": {
        "transactions": {
          "pageInfo": {
            "endCursor": "653787c033905fc03c13e0a3",
            "hasNextPage": true
          },
          "edges": [
            {
              "cursor": "653787e933905fc03c13e286",
              "node": {
                "direction": "SEND",
                "settlementCurrency": "BTC",
                "settlementDisplayAmount": "-0.47",
                "status": "SUCCESS",
                "createdAt": 1698138089
              }
            },
            {
              "cursor": "653787c033905fc03c13e0a3",
              "node": {
                "direction": "SEND",
                "settlementCurrency": "BTC",
                "settlementDisplayAmount": "-0.47",
                "status": "SUCCESS",
                "createdAt": 1698138048
              }
            }
          ]
        }
      }
    }
  }
}
tip

To test the GraphQL requests further use the GraphQL playground at api.blink.sv/graphql for mainnet or api.staging.blink.sv/graphql for staging.
Check out the Galoy API Postman collection to find examples in multiple programming languages.