# SignalHarness Token Units Converter

> SignalHarness Token Units Converter is a paid API for AI agents from signalharness.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Converts token unit representations (e.g. wei to ETH, satoshis to BTC) given a natural-language or structured conversion request string

## Facts

- Endpoint: POST https://signalharness.ai/api/agent/services/token_units_convert/invoke
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/signalharness-token-units-converter-d1ef1dc8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uieilBkKxEvFMwD9EM4x3

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability signalharness-token-units-converter-d1ef1dc8 -d '<json body>'
```

Example prompt: Can you convert 5000 atomic USDC units on Base into the standard decimal USDC amount for me?

## When to prefer this

Choose this endpoint when an AI agent needs to programmatically convert raw blockchain token amounts (atomic/base units) into human-readable decimal representations, or vice versa, especially for on-chain payment flows where USDC or other ERC-20 token amounts need to be normalized. It is particularly useful in DeFi, wallet, or payment agent workflows where displaying or validating token amounts in the correct unit is critical. Prefer this over manual calculation when the unit system is ambiguous or the agent needs an auditable receipt of the conversion.

## Known failure modes

- Invalid or ambiguous token_units_request string — returns error or unhelpful conversion
- Unsupported token type or unit system — may return warnings or empty conversion
- Request string too short (below minLength of 2) or too long (above maxLength of 65536) — validation error
- Payment failure on x402 micropayment channel — request not processed
- Ambiguous denomination with no canonical resolution — warnings populated but conversion may be approximate

## How this service works

Explore 330 pay-per-call x402 API services and 27 agent-native digital products, with Base USDC pricing, secure Polar checkout, and free discovery.

## Output

Returns a JSON object containing the converted token unit value as a string in 'token_unit_conversion', any warnings about the conversion, the evidence scope indicating the data source was caller-supplied, and a receipt with payment and execution metadata including paymentId, receiptId, latency, and a SHA-256 hash of the result for verification.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "token_units_request": {
   "type": "string",
   "maxLength": 65536,
   "minLength": 2
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "replay": false,
  "result": {
   "warnings": [
    "Token decimals are caller supplied and not independently verified."
   ],
   "service_id": "token_units_convert",
   "evidence_scope": "caller_supplied_data",
   "token_unit_conversion": "{\"atomic\":\"1234567\",\"decimal\":\"1.234567\"}"
  },
  "status": "succeeded",
  "receipt": {
   "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "usage": [],
   "status": "succeeded",
   "network": "eip155:8453",
   "artifacts": [],
   "endedAtMs": 0,
   "latencyMs": 0,
   "paymentId": "example-payment",
   "receiptId": "example-receipt",
   "requestId": "example-request",
   "serviceId": "token_units_convert",
   "executionId": "example-execution",
   "startedAtMs": 0,
   "amountAtomic": "5000",
   "resultSha256": "e00f1c341205a8beaf38f69bfac923c8df292200543ffbe21c701f4979e5c114",
   "serviceVersion": "1.0.0",
   "settlementReference": "0x0000000000000000000000000000000000000000000000000000000000000000"
  },
  "artifacts": [],
  "requestId": "example-request",
  "executionId": "example-execution"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/signalharness-token-units-converter-d1ef1dc8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from signalharness.ai](https://www.zero.xyz/host/signalharness.ai/llms.txt)