# listEthereumWalletPositions

**Identifier:** `zerion_listEthereumWalletPositions`

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

List the token positions of an Ethereum wallet address: quantity held and value per token, largest first. Use getEthereumWalletPortfolio for aggregate value only. The returned 'fungibleIds' can be passed to getEthereumWalletBalanceChart to chart specific tokens.

## Run it with the CLI

```bash
kirha tools run zerion_listEthereumWalletPositions \
  --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_listEthereumWalletPositions",
  "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"
    },
    "limit": {
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "type": "number"
    },
    "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": {
    "context": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "ethereumAddress": {
      "type": "string"
    },
    "fungibleIds": {
      "description": "Fungible ids of the listed positions for composition with other tools",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "positions": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "chainId": {
            "type": "string"
          },
          "fungibleId": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "positionType": {
            "type": "string"
          },
          "price": {
            "type": [
              "number",
              "null"
            ]
          },
          "quantity": {
            "type": "number"
          },
          "symbol": {
            "type": "string"
          },
          "value": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "fungibleId",
          "name",
          "symbol",
          "chainId",
          "positionType",
          "quantity",
          "price",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "context",
    "ethereumAddress",
    "currency",
    "positions",
    "fungibleIds"
  ],
  "type": "object"
}
```

## Related tools

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

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

-----

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