---
title: "Simulate a bundle of transactions"
method: POST
path: "/v1/agents/{agent_id}/transactions/simulate-bundle"
tags: ["Transactions"]
---

# Simulate a bundle of transactions

`POST /v1/agents/{agent_id}/transactions/simulate-bundle`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/agents/{agent_id}/transactions/simulate-bundle`
- Auth: HTTP bearer

## Path parameters

- `agent_id` string, uuid, required

## Request body

- SimulateBundleRequest
  - `transactions` SimulateTransactionRequest[], required
    - `to` string, required
    - `value` string, required
    - `chain` string, required
    - `data` string
    - `signing_key_path` string: Vault path to signing key. Auto-resolves per-chain signing key if provisioned, otherwise keys/{chain}-signer.
    - `gas_limit` integer

## Response `200`

Bundle simulation results

- BundleSimulationResponse
  - `simulations` SimulationResponse[]
    - `simulation_id` string
    - `status` 'success' | 'reverted' | 'error'
    - `gas_used` integer
    - `gas_estimate_usd` string
    - `balance_changes` BalanceChange[]
      - `address` string
      - `token` string
      - `token_symbol` string
      - `before` string
      - `after` string
      - `change` string
    - `error` string
    - `error_code` string
    - `error_human_readable` string
    - `revert_reason` string
    - `tenderly_dashboard_url` string, uri
    - `simulated_at` string, date-time

## Other responses

- `400`: Invalid request
- `402`: x402 payment required

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/ae109b496830?raw)