# APIAcre Base Contract Read

> APIAcre Base Contract Read is a paid API for AI agents from apiacre.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Executes a single read-only eth_call against a specified Base mainnet contract at a resolved block, returning call results with optional ABI decoding and block evidence.

## Facts

- Endpoint: POST https://apiacre.com/v1/crypto/base-contract-read
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apiacre-base-contract-read-d5a7b954
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VdmxCe-5F6284FbEZgVr7

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 apiacre-base-contract-read-d5a7b954 -d '<json body>'
```

Example prompt: Call the Base mainnet contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 with the calldata for totalSupply() and decode the result as a uint256 — give me the raw value and the resolved block number as evidence.

## When to prefer this

Choose this endpoint when you need a single, auditable, read-only call to a Base mainnet smart contract without operating your own Ethereum node, especially when you need block-level evidence or optional ABI decoding of the response. Prefer it over full node RPC when you want a verifiable, bounded call with retained evidence suitable for compliance or audit trails.

## Known failure modes

- Contract address does not exist on Base mainnet — returns error indicating no contract at address
- Invalid or malformed calldata — call reverts or returns empty data
- ABI output type mismatch — decoding fails if specified types don't match actual return data
- Block resolution failure — specified block not yet finalized or not available
- Rate limit or payment failure — call rejected if x402 payment not provided or insufficient

## How this service works

Execute one bounded read-only eth_call against a resolved Base mainnet block, retain call and block evidence, and optionally decode caller-specified ABI output types.

## Output

Returns the raw hex return data from eth_call, optionally ABI-decoded into typed values matching the caller-supplied output types, along with the resolved block number, block hash, and call parameters as verifiable evidence of the query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "contract": {
   "type": "string"
  },
  "block_tag": {
   "enum": [
    "latest",
    "safe",
    "finalized"
   ],
   "type": "string"
  },
  "call_data": {
   "type": "string"
  },
  "gas_limit": {
   "type": "integer"
  },
  "from_address": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "output_types": {
   "type": "array",
   "items": {
    "type": "string"
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "call": {
    "from": null,
    "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "gasLimit": 2000000,
    "selector": "0x313ce567",
    "dataBytes": 4
   },
   "block": {
    "hash": "0x1111111111111111111111111111111111111111111111111111111111111111",
    "number": 34567890,
    "timestamp": "2026-08-10T16:00:00+00:00",
    "requestedTag": "safe"
   },
   "result": {
    "hex": "0x0000000000000000000000000000000000000000000000000000000000000006",
    "bytes": 32,
    "sha256": "d1ec675902ef1633427ca360b290b0b3045a0d9058ddb5e648b4c3c3224c5c68",
    "truncated": false,
    "returnedBytes": 32
   },
   "source": "https://docs.base.org/base-chain/api-reference/ethereum-json-rpc-api/eth_call",
   "network": "eip155:8453",
   "success": true,
   "readOnly": true,
   "rpcError": null,
   "warnings": [],
   "disclaimer": "Read-only public Base mainnet execution at one resolved block. No transaction...",
   "outputTypes": [
    "uint8"
   ],
   "decodeStatus": "decoded",
   "decodedValues": [
    6
   ],
   "transactionBroadcast": false
  },
  "meta": {
   "cached": false,
   "sources": [],
   "warnings": [],
   "duration_ms": 42,
   "next_actions": []
  },
  "service": "crypto.base-contract-read",
  "version": "1",
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/apiacre-base-contract-read-d5a7b954/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apiacre.com](https://www.zero.xyz/host/apiacre.com/llms.txt)