Query/BalancesByAddress

Query/BalancesByAddress is successful when:

  • always (an error is never returned)

Query/BalancesByAddress has the following outcomes:

  • query response returned

An error is never returned

Background

Given balance

{
  "id": 1,
  "address": "BTZfSbi0JKqguZ/tIAPUIhdAa7Y=",
  "amount": "1.25",
  "expiration": "2021-01-01T00:00:00Z"
}

balance exists

When query balances by address

{
  "address": "chora1q5m97jdcksj24g9enlkjqq75ygt5q6ak54jk38"
}

Then expect no error.

balance does not exist

When query balances by address

{
  "address": "chora1s3x2yhc4qf59gf53hwsnhkh7gqa3eryxnu6nup"
}

Then expect no error.

The query response is returned

query response returned with no amounts

When query balances by address

{
  "address": "chora1q5m97jdcksj24g9enlkjqq75ygt5q6ak54jk38"
}

Then expect response

{
  "address": "chora1q5m97jdcksj24g9enlkjqq75ygt5q6ak54jk38",
  "total_amounts": [],
  "pagination": {}
}

query response returned with one amount

Given balance

{
  "id": 1,
  "address": "BTZfSbi0JKqguZ/tIAPUIhdAa7Y=",
  "amount": "1.25",
  "expiration": "2021-01-01T00:00:00Z"
}

When query balances by address

{
  "address": "chora1q5m97jdcksj24g9enlkjqq75ygt5q6ak54jk38"
}

Then expect response

{
  "address": "chora1q5m97jdcksj24g9enlkjqq75ygt5q6ak54jk38",
  "total_amounts": [
    {
      "id": 1,
      "total_amount": "1.250000000000000000"
    }
  ],
  "pagination": {
    "total": 1
  }
}

query response returned with multiple amounts

Given balance

{
  "id": 1,
  "address": "BTZfSbi0JKqguZ/tIAPUIhdAa7Y=",
  "amount": "1.25",
  "expiration": "2021-01-01T00:00:00Z"
}

And balance

{
  "id": 1,
  "address": "BTZfSbi0JKqguZ/tIAPUIhdAa7Y=",
  "amount": "1.25",
  "expiration": "2022-01-01T00:00:00Z"
}

And balance

{
  "id": 2,
  "address": "BTZfSbi0JKqguZ/tIAPUIhdAa7Y=",
  "amount": "1.25",
  "expiration": "2021-01-01T00:00:00Z"
}

When query balances by address

{
  "address": "chora1q5m97jdcksj24g9enlkjqq75ygt5q6ak54jk38"
}

Then expect response

{
  "address": "chora1q5m97jdcksj24g9enlkjqq75ygt5q6ak54jk38",
  "total_amounts": [
    {
      "id": 1,
      "total_amount": "2.500000000000000000"
    },
    {
      "id": 2,
      "total_amount": "1.250000000000000000"
    }
  ],
  "pagination": {
    "total": 3
  }
}