# Zerion API - Wallet Transaction Simulation

> Zerion API - Wallet Transaction Simulation is a paid API for AI agents from api.zerion.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-01).

Simulates transactions for a given wallet address across 40+ EVM chains and Solana, returning interpreted simulation results before execution

## Facts

- Endpoint: GET https://api.zerion.io/v1/wallets/simulation/transactions?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zerion-api-wallet-transaction-simulation-c1d8f1d6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jKeUVcQnWKNvyOk6A2FLZ

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 zerion-api-wallet-transaction-simulation-c1d8f1d6
```

Example prompt: Before I confirm this swap on my wallet 0x742d35Cc6634C0532925a3b8D4C9C6A7e2F1d23b, can you simulate the transaction and show me exactly what tokens I'll receive and what the impact on my portfolio will be?

## When to prefer this

Use this endpoint when you need to preview or validate a blockchain transaction before it is submitted to the chain — particularly for high-value DeFi interactions, smart contract calls, or any scenario where the user wants to confirm expected token flows and portfolio impact without risking real funds. Prefer this over reading raw on-chain state when you need interpreted, human-readable simulation output across multiple chains in a single API call with pay-per-use x402 pricing.

## Known failure modes

- Invalid or malformed wallet address returns 400 Bad Request
- Unsupported chain or address format returns validation error
- Payment required (402) if x402 micropayment header not included
- Rate limiting or authentication errors (401/429) for unauthenticated requests
- Simulation failure if transaction parameters are invalid or contract call would revert
- Network timeouts for complex multi-step DeFi simulations

## How this service works

Interpreted wallet data for more than 40 chains and Solana: portfolios, DeFi positions, PnL, transactions and NFTs. REST for apps, x402 pay-per-call for agents.

## Output

An array of JSON:API resource objects describing the simulated transaction outcome, including expected token transfers, portfolio changes, and transaction effects, along with pagination links. The response shows what would happen to the wallet if the transaction were executed, without actually submitting it to the blockchain.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "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",
       "description": "Wallet address (EVM 0x or Solana base58)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "id": {
          "type": "string",
          "description": "Resource ID."
         },
         "type": {
          "type": "string",
          "description": "Resource type."
         },
         "attributes": {
          "type": "object",
          "description": "Resource attributes; see https://developers.zerion.io"
         }
        }
       },
       "description": "Array of JSON:API resource objects."
      },
      "links": {
       "type": "object",
       "description": "Self and pagination links."
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "id": "<resource id>",
   "type": "<resource type>",
   "attributes": {}
  },
  "links": {
   "self": "https://api.zerion.io/v1/..."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zerion-api-wallet-transaction-simulation-c1d8f1d6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.zerion.io](https://www.zero.xyz/host/api.zerion.io/llms.txt)