---
title: "Wallet/contract state on 5 EVM chains: native balance, nonce, EOA/contract, ERC-20 balances (paid)"
method: POST
path: "/chain/v1/chain-state"
tags: ["OnChain"]
---

# Wallet/contract state on 5 EVM chains: native balance, nonce, EOA/contract, ERC-20 balances (paid)

`POST /chain/v1/chain-state`

## Request

- Base URL: `https://agent.connskill.com` (the document declares no server; this is the origin it was published from)
- URL: `https://agent.connskill.com/chain/v1/chain-state`
- Auth: none declared

## Request body

- object
  - `chain` 'base' | 'ethereum' | 'arbitrum' | 'optimism' | 'polygon', required
  - `address` string, required: Wallet or contract address
  - `tokens` string[]: Optional ERC-20 contract addresses to read balances for (max 10)

## Response `200`

State snapshot

- object
  - `status` string
  - `chain` string
  - `address` string
  - `isContract` boolean
  - `codeKind` string
  - `nonce` integer
  - `native` object
    - `wei` string
    - `formatted` string
  - `tokens` object[]
    - `contract` string
    - `symbol` string
    - `decimals` integer
    - `balanceRaw` string
    - `balance` string

## Other responses

- `402`: Payment Required

---

[API](https://skmtc.dev/connskill/apis/connskill-growth-services.md) · [All operations](https://skmtc.dev/connskill/apis/connskill-growth-services/llms.txt) · [OpenAPI document](https://skmtc.dev/connskill/apis/connskill-growth-services/revisions/aae873ea0805?raw)