[DEV-201]: Implement account balance REST endpoint

[PedroBinotto]

Changelog — Added Account Balance Endpoints

• Added GET /account-balances/:accountId
  Provides detailed balance information for a specific account, including accountId, balance, tokenId, and delegate.

• Added GET /account-balances
  Returns a paginated and filterable list of account balances. Supports filtering by addresses, delegates, balance ranges, and ordering options. Includes total item count in the response.

---

[
    "/account-balances/:accountId": {
      "get": {
        "operationId": "accountBalance",
        "summary": "Get account balance",
        "description": "Returns account balance",
        "tags": [
          "account-balances"
        ],
        "responses": {
          "200": {
            "description": "Successfully retrieved account balance",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "accountId": {
                      "type": "string"
                    },
                    "balance": {
                      "type": "string"
                    },
                    "tokenId": {
                      "type": "string"
                    },
                    "delegate": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "accountId",
                    "balance",
                    "tokenId",
                    "delegate"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/account-balances": {
      "get": {
        "operationId": "accountBalances",
        "summary": "Get account balances",
        "description": "Returns account balances",
        "tags": [
          "account-balances"
        ],
        "parameters": [
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            },
            "required": false,
            "name": "limit",
            "in": "query"
          },
          {
            "schema": {
              "type": "integer",
              "nullable": true,
              "minimum": 0,
              "default": 0
            },
            "required": false,
            "name": "skip",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "enum": [
                "asc",
                "desc"
              ],
              "default": "desc"
            },
            "required": false,
            "name": "orderDirection",
            "in": "query"
          },
          {
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "default": []
            },
            "required": false,
            "name": "addresses",
            "in": "query"
          },
          {
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "default": []
            },
            "required": false,
            "name": "delegates",
            "in": "query"
          },
          {
            "schema": {
              "type": "string"
            },
            "required": false,
            "name": "balanceGreaterThan",
            "in": "query"
          },
          {
            "schema": {
              "type": "string"
            },
            "required": false,
            "name": "balanceLessThan",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Successfully retrieved account balances",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "accountId": {
                            "type": "string"
                          },
                          "balance": {
                            "type": "string"
                          },
                          "tokenId": {
                            "type": "string"
                          },
                          "delegate": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "accountId",
                          "balance",
                          "tokenId",
                          "delegate"
                        ]
                      }
                    },
                    "totalCount": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "items",
                    "totalCount"
                  ]
                }
              }
            }
          }
        }
      }
    }
]

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
anticapture	Ready	Preview, Comment	Dec 22, 2025 8:12pm

1 Skipped Deployment

Project	Deployment	Review	Updated (UTC)
anticapture-storybook	Skipped		Dec 22, 2025 8:12pm