ToolAssay

Call when an agent needs an ERC-20 balance_raw and human balance for token and o

Call when an agent needs an ERC-20 balance_raw and human balance for token and owner on Base. Example token is Circle USDC. decimals() scales the human balance. Distinct from base-balance (native ETH). Read-only. No spend. Send JSON {"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","owner":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}. Exact $0.003 USDC on Base. Try unpaid POST /v1/sandbox/base-erc20-balance first.

Not tested: has real-world effectsour last check, 2026-10-11
0 of 0checks answered this week
n/amedian answer time
$0.003listed price per call
n/aprice it asked us

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://agentshelf.syntexa.ch/v1/base-erc20-balance

CategoryCode and developer
Provider hostagentshelf.syntexa.ch
Networkseip155:8453
Payment schemesexact
Self-reported calls, 30 days1 from 1 payers (the provider's figure, not ours)

Our checks, last 30 days

We never call tools that send, buy, move money or file anything, not even without paying.

Example input (from the provider)

{
  "body": {
    "owner": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "additionalProperties": false,
          "examples": [
            {
              "owner": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
              "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
            }
          ],
          "properties": {
            "owner": {
              "description": "Wallet whose token balance is read. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045. EIP-55 or all one case. Returns balance_raw and a human balance from decimals().",
              "examples": [
                "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
              ],
              "type": "string"
            },
            "token": {
              "description": "ERC-20 contract on Base mainnet. Example: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (Circle USDC). EIP-55 or all one case. Paired with owner. Distinct from base-balance, which reads native ETH.",
              "examples": [
                "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
              ],
              "type": "string"
            }
          },
          "required": [
            "token",
            "owner"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "additionalProperties": false,
          "examples": [
            {
              "balance": "2.5",
              "balance_raw": "2500000",
              "billed": true,
              "decimals": 6,
              "network": "eip155:8453",
              "ok": true,
              "owner": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
              "receipt_id": "rcpt_01EXAMPLE000000000000000",
              "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "warnings": []
            }
          ],
          "properties": {
            "balance": {
              "examples": [
                "2.5"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "balance_raw": {
              "examples": [
                "2500000"
              ],
              "type": "string"
            },
            "billed": {
              "examples": [
                true
              ],
              "type": "boolean"
            },
            "decimals": {
              "anyOf": [
                {
                  "minimum": 0,
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "examples": [
                6
              ]
            },
            "network": {
              "const": "eip155:8453",
              "examples": [
                "eip155:8453"
              ],
              "type": "string"
            },
            "ok": {
              "const": true,
              "examples": [
                true
              ],
              "type": "boolean"
            },
            "owner": {
              "examples": [
                "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
              ],
              "type": "string"
            },
            "receipt_id": {
              "examples": [
                "rcpt_01EXAMPLE000000000000000"
              ],
              "type": "string"
            },
            "token": {
              "examples": [
                "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
              ],
              "type": "string"
            },
            "warnings": {
              "default": [],
              "examples": [
                []
              ],
              "items": {
                "type": "string"
              },
              "type": "array"
            }
          },
          "required": [
            "ok",
            "receipt_id",
            "billed",
            "token",
            "owner",
            "network",
            "decimals",
            "balance_raw",
            "balance"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON