Safe (Gnosis Safe) · Example Payload

Safes_Balances_Retrieve_2

Get paginated balances for Ether and ERC20 tokens. The maximum limit allowed is 200.

safes

Safes_Balances_Retrieve_2 is an example object payload from Safe (Gnosis Safe), with 8 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

operationIdmethodpathsummarydescriptiontagsparametersresponses

Example Payload

{
  "operationId": "safes_balances_retrieve_2",
  "method": "GET",
  "path": "/tx-service/eth/api/v2/safes/{address}/balances/",
  "summary": "",
  "description": "Get paginated balances for Ether and ERC20 tokens.\nThe maximum limit allowed is 200.",
  "tags": [
    "safes"
  ],
  "parameters": [
    {
      "name": "address",
      "in": "path",
      "required": true,
      "description": "",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "trusted",
      "in": "query",
      "required": false,
      "description": "If `True` just trusted tokens will be returned",
      "schema": {
        "type": "boolean",
        "default": false
      }
    },
    {
      "name": "exclude_spam",
      "in": "query",
      "required": false,
      "description": "If `True` spam tokens will not be returned",
      "schema": {
        "type": "boolean",
        "default": false
      }
    },
    {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Number of results to return per page.",
      "schema": {
        "type": "integer"
      }
    },
    {
      "name": "offset",
      "in": "query",
      "required": false,
      "description": "The initial index from which to return the results.",
      "schema": {
        "type": "integer"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PaginatedSafeCollectibleResponseList"
          }
        }
      }
    },
    "404": {
      "description": "Safe not found",
      "content": {}
    },
    "422": {
      "description": "Safe address checksum not valid",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/CodeErrorResponse"
          }
        }
      }
    }
  }
}