Transaction simulation

Run a read-only, hypothetical transaction (sender, receiver, calldata, value, gas) before you sign or send it.

POSThttps://triport.io/v1/intelligence/simulate

Network: Ethereum
Scope: intelligence:read
Auth: x-token: $TRIPORT_API_KEY header (or Authorization: Bearer)
Rate limit: Business — 30 rps (intelligence, burst ×2); Enterprise — 150 rps

Request

cURLJavaScriptPython

curl -X POST "https://triport.io/v1/intelligence/simulate" \
  -H "x-token: $TRIPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain":"eth","value":"0","sender":"0x28c6c06298d514db089934071355e5743bf21d60","receiver":"0x6b175474e89094c44da98b954eedeac495271d0f","inputData":"0x70a0823100000000000000000000000028c6c06298d514db089934071355e5743bf21d60","gasPrice":"0","gasLimit":100000,"isPrerun":true}'

const res = await fetch("https://triport.io/v1/intelligence/simulate", {
  method: "POST",
  headers: {
    "x-token": process.env.TRIPORT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "chain": "eth",
    "value": "0",
    "sender": "0x28c6c06298d514db089934071355e5743bf21d60",
    "receiver": "0x6b175474e89094c44da98b954eedeac495271d0f",
    "inputData": "0x70a0823100000000000000000000000028c6c06298d514db089934071355e5743bf21d60",
    "gasPrice": "0",
    "gasLimit": 100000,
    "isPrerun": true
  }),
});
const data = await res.json();
console.log(data);

import os


import requests


resp = requests.post(
    "https://triport.io/v1/intelligence/simulate",
    headers={
        "x-token": os.environ["TRIPORT_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "chain": "eth",
        "value": "0",
        "sender": "0x28c6c06298d514db089934071355e5743bf21d60",
        "receiver": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "inputData": "0x70a0823100000000000000000000000028c6c06298d514db089934071355e5743bf21d60",
        "gasPrice": "0",
        "gasLimit": 100000,
        "isPrerun": True,
    },
)
data = resp.json()
print(data)

Response

JSON

Example

{
  "state": "ok",
  "meta": {
    "observedAt": "2026-11-06T09:50:15.986943553Z",
    "cached": false,
    "complete": false
  },
  "data": {
    "reference": "116120d0975be6d06d859ae2a58f1dbf707234c66112a9dff7fbee3b1ff8378f",
    "outcome": "unknown"
  }
}

Run a read-only, hypothetical transaction (sender, receiver, calldata, value, gas) before you sign or send it.

Nothing is signed or broadcast. The answer is a simulation reference with outcome: unknown; it is not a receipt and does not mean the real transaction will succeed.

Released on Ethereum. Any other chain value answers 422 with state unsupported. More chains are coming; see the changelog.

Every answer is an envelope with state, meta, optional data and optional error. Read state first: ok, empty, partial, stale, unsupported or unavailable (see response states). meta.cached tells you whether the answer came from cache.

Parameters

blockNumberintegeroptional

Optional block number to simulate against.

chainstringrequired

Chain id, see Network above (eth, and for labels also solana and avalanche). Aliases: ethereum → eth, sol → solana, avax → avalanche.

freshbooleanoptional

Optional. true skips the cache and asks for a new lookup (GET routes: ?fresh=1).

gasLimitintegerrequired

Gas limit (integer).

gasPricestringrequired

Gas price, as a decimal string.

inputDatastringrequired

Calldata of the hypothetical transaction (0x…).

isPrerunbooleanrequired

Set true for a pre-execution run.

positionintegeroptional

Optional transaction position inside the block.

receiverstringrequired

Receiver (to) address.

senderstringrequired

Sender (from) address.

valuestringrequired

Value sent with the call, as a decimal string.

Response

Response recorded on 2026-11-06 through https://triport.io (long lists shortened). Values change over time.

Errors

HTTP	`error.code`	When
400	`invalid_request`	Malformed address, unknown field, `null` value or invalid JSON.
401	`unauthorized`	Missing or invalid API key.
403	`scope_missing` / `tier_insufficient`	The key lacks `intelligence:read`, or the plan is below Business.
405	`method_not_allowed`	Wrong HTTP method; the `Allow` header names `POST`.
422	`unsupported`	The chain (or the contract) is not supported by this method.
429	`rate_limited`	Over the `intelligence` per-second limit; wait `Retry-After` seconds.
503	`unavailable`	The lookup could not be completed right now; retry later.
504	`timeout`	The lookup took too long; retry, or retry later with the same input.

See errors, limits and states for the full rules and the code examples.