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

# Simulate a transaction via Tenderly

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

## Request

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

## Path parameters

- `agent_id` string, uuid, required

## Request body

- SimulateTransactionRequest
  - `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`

Simulation result

- 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
- `403`: Insufficient permissions

---

[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)