# getEthereumWalletBalanceChart

**Identifier:** `zerion_getEthereumWalletBalanceChart`

**Provider:** [Zerion](https://kirha.com/providers/zerion.md)

Get the balance chart information for a given Ethereum wallet address over time. Only works for ordinary user wallets: exchange wallets (Binance, Coinbase, ...), smart contracts (WETH, deposit contracts, timelocks, ...) and other high-traffic addresses are rejected as untrackable, and retrying with other filters does not help. For those addresses use getEthereumWalletPortfolio (current value only) instead.

## Run it with the CLI

```bash
kirha tools run zerion_getEthereumWalletBalanceChart \
  --input '{
    "ethereumAddress": "<ethereumAddress>"
  }'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "zerion_getEthereumWalletBalanceChart",
  "input": {
    "ethereumAddress": "<ethereumAddress>"
  }
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "currency": {
      "default": "usd",
      "enum": [
        "eth",
        "btc",
        "usd",
        "eur",
        "cny",
        "chf"
      ],
      "type": "string"
    },
    "ethereumAddress": {
      "type": "string"
    },
    "fungibleIds": {
      "description": "Filter by specific fungible token ids (e.g eth, usdc_circle, usdt_tether, lido_staked_eth, etc.). Use getFungibleId tool to get the fungible token id",
      "items": {
        "type": "string"
      },
      "maxItems": 5,
      "type": "array"
    },
    "period": {
      "default": "day",
      "description": "The time period for the balance chart",
      "enum": [
        "hour",
        "day",
        "week",
        "month",
        "year"
      ],
      "type": "string"
    },
    "zerionChainIds": {
      "description": "Filter by specific chain IDs (e.g ethereum, base, zksync-era, etc.)",
      "items": {
        "enum": [
          "arbitrum",
          "binance-smart-chain",
          "ethereum",
          "blast",
          "ape",
          "avalanche",
          "abstract",
          "opbnb",
          "astar-zkevm",
          "zksync-era",
          "berachain",
          "bob",
          "cyber",
          "degen",
          "fraxtal",
          "gravity-alpha",
          "ink",
          "lens",
          "lisk",
          "mode",
          "base",
          "mantle",
          "optimism",
          "polygon",
          "celo",
          "manta-pacific",
          "xdai",
          "fantom",
          "ronin",
          "linea",
          "metis-andromeda",
          "aurora",
          "xinfin-xdc",
          "cronos-zkevm",
          "polygon-zkevm",
          "polynomial",
          "rari",
          "redstone",
          "scroll",
          "sei",
          "soneium",
          "sonic",
          "swellchain",
          "taiko",
          "unichain",
          "wonder",
          "tomochain",
          "world",
          "zero",
          "okbchain",
          "zklink-nova",
          "zora",
          "re-al"
        ],
        "type": "string"
      },
      "maxItems": 5,
      "type": "array"
    }
  },
  "required": [
    "ethereumAddress"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "beginAt": {
      "type": "string"
    },
    "chartPoints": {
      "items": {
        "items": false,
        "maxItems": 2,
        "minItems": 2,
        "prefixItems": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ],
        "type": "array"
      },
      "type": "array"
    },
    "context": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "endAt": {
      "type": "string"
    },
    "ethereumAddress": {
      "type": "string"
    },
    "fungibleIds": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "period": {
      "enum": [
        "hour",
        "day",
        "week",
        "month",
        "year"
      ],
      "type": "string"
    },
    "zerionChainIds": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "context",
    "ethereumAddress",
    "currency",
    "period",
    "beginAt",
    "endAt",
    "chartPoints"
  ],
  "type": "object"
}
```

## Related tools

Other Zerion tools that this tool refers to, or that refer to it.

- [`getEthereumWalletPortfolio`](https://kirha.com/providers/zerion/getEthereumWalletPortfolio.md)
- [`listEthereumWalletPositions`](https://kirha.com/providers/zerion/listEthereumWalletPositions.md)
- [`getFungibleId`](https://kirha.com/providers/zerion/getFungibleId.md)

-----

[All Zerion tools](https://kirha.com/providers/zerion.md) · [< Back to tools list](https://kirha.com/tools.md)