# Soren Chain Code Inspector

> Soren Chain Code Inspector is a paid API for AI agents from soren.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Reads whether an Ethereum/Base address is a contract and returns its bytecode size, live from Base mainnet, charged per successful call via x402.

## Facts

- Endpoint: GET https://soren.com/v1/chain/code
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/soren-chain-code-inspector-0e921df0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jX7cvKJZGb75pjhbcVhhj

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 soren-chain-code-inspector-0e921df0
```

Example prompt: Can you check whether 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 is a smart contract or a regular wallet on Base mainnet, and if it is a contract, what's its code size?

## When to prefer this

Use this endpoint when you need a live, real-time check of whether a Base mainnet address is a smart contract, without setting up an API key or account. Prefer it over full node RPC setups or general blockchain explorers when you want pay-per-use, frictionless access with block-stamped results. If you also need attestation/signing of the result, use the /v1/oracle/onchain variant instead.

## Known failure modes

- Invalid or malformed address format returns an error
- Address not found or network connectivity issues may return an error
- Payment failure (insufficient USDC balance or x402 rejection) means no charge and no result
- Call only succeeds and charges if the read completes — failed reads are not billed

## How this service works

Read whether an address is a contract, and its code size, live from Base mainnet, for a fraction of a cent. No API key, no account — a wallet is the only requirement, and you are charged only if the read succeeds. Plain unsigned data; the attested version of chain reads is /v1/oracle/onchain. Answers are read at the moment of the call and stamped with the block they came from where applicable.

## Output

Returns whether the given address has deployed contract code (true/false), the size of the bytecode in bytes, and the block number at which the read was taken from Base mainnet. If the address is an EOA, code size will be zero.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "examples": [
        "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       ],
       "description": "The 0x… address to inspect."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/soren-chain-code-inspector-0e921df0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from soren.com](https://www.zero.xyz/host/soren.com/llms.txt)