---
title: "Base Token Balance"
method: POST
path: "/v1/base-token-balance"
tags: ["fresh-state", "x402", "live-data", "agent-utility"]
---

# Base Token Balance

`POST /v1/base-token-balance`

## Request

- Base URL: `https://api.salt19.com`
- URL: `https://api.salt19.com/v1/base-token-balance`
- Auth: none declared

Read a live ERC-20 token balance on Base and return raw units plus best-effort token decimals/symbol metadata without signup or an API key. Current x402 price: $0.01.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `token_address` string, required
  - `owner` string, required

## Response `200`

Fresh-State result

## Other responses

- `400`: Invalid input
- `402`: x402 Payment Required
- `502`: Upstream state source unavailable

---

[API](https://skmtc.dev/salt19/apis/salt19-agent-utility-grid.md) · [All operations](https://skmtc.dev/salt19/apis/salt19-agent-utility-grid/llms.txt) · [OpenAPI document](https://skmtc.dev/salt19/apis/salt19-agent-utility-grid/revisions/c2520ca8ffbf?raw)