Skip to content

LeoYeAI/agent-master-skills / skills/alchemy-official

alchemy-official

Verified

FileKindSize
AGENTIC-GATEWAY.mdmarkdown4.3 KB
SKILL.mdskill md24.0 KB
SOURCE.mdmarkdown188 B
_meta.jsonconfig466 B
references/data-nft-api.mdmarkdown15.8 KB
references/data-overview.mdmarkdown2.0 KB
references/data-portfolio-apis.mdmarkdown15.9 KB
references/data-prices-api.mdmarkdown6.3 KB
references/data-simulation-api.mdmarkdown10.2 KB
references/data-token-api.mdmarkdown5.4 KB
references/data-transfers-api.mdmarkdown5.1 KB
references/ecosystem-anchor.mdmarkdown632 B
references/ecosystem-ethers.mdmarkdown772 B
references/ecosystem-foundry.mdmarkdown654 B
references/ecosystem-hardhat.mdmarkdown795 B
references/ecosystem-metaplex.mdmarkdown652 B
references/ecosystem-overview.mdmarkdown2.3 KB
references/ecosystem-rainbowkit.mdmarkdown604 B
references/ecosystem-solana-web3js.mdmarkdown766 B
references/ecosystem-spl-token.mdmarkdown737 B
references/ecosystem-viem.mdmarkdown827 B
references/ecosystem-wagmi.mdmarkdown829 B
references/ecosystem-web3js.mdmarkdown689 B
references/node-debug-api.mdmarkdown5.0 KB
references/node-enhanced-apis.mdmarkdown2.7 KB
references/node-json-rpc.mdmarkdown10.4 KB
references/node-overview.mdmarkdown2.1 KB
references/node-trace-api.mdmarkdown5.7 KB
references/node-utility-api.mdmarkdown3.1 KB
references/node-websocket-subscriptions.mdmarkdown4.1 KB
references/operational-alerts.mdmarkdown765 B
references/operational-allowlists.mdmarkdown819 B
references/operational-auth-and-keys.mdmarkdown1.1 KB
references/operational-best-practices.mdmarkdown1.0 KB
references/operational-dashboard-tools.mdmarkdown700 B
references/operational-jwt-and-header-auth.mdmarkdown1.1 KB
references/operational-overview.mdmarkdown2.0 KB
references/operational-pricing-and-plans.mdmarkdown916 B
references/operational-rate-limits-and-compute-units.mdmarkdown1.1 KB
references/operational-request-logs.mdmarkdown680 B
references/operational-roles-and-sso.mdmarkdown686 B
references/operational-sandbox.mdmarkdown686 B
references/operational-supported-networks.mdmarkdown2.3 KB
references/recipes-get-nft-metadata.mdmarkdown1.2 KB
references/recipes-get-nft-ownership.mdmarkdown1.2 KB
references/recipes-get-portfolio.mdmarkdown1.5 KB
references/recipes-get-prices-current-historical.mdmarkdown1.1 KB
references/recipes-get-token-balances.mdmarkdown1.4 KB
references/recipes-get-token-metadata.mdmarkdown1.3 KB
references/recipes-get-transfers-history.mdmarkdown1.0 KB
references/recipes-overview.mdmarkdown1.4 KB
references/recipes-simulate-transaction.mdmarkdown1.1 KB
references/recipes-subscribe-pending-txs.mdmarkdown1.7 KB
references/recipes-webhook-address-activity.mdmarkdown1.4 KB
references/rollups-details.mdmarkdown1.1 KB
references/rollups-overview.mdmarkdown793 B
references/solana-das-api.mdmarkdown9.0 KB
references/solana-grpc-best-practices.mdmarkdown896 B
references/solana-grpc-details.mdmarkdown1.0 KB
references/solana-grpc-examples.mdmarkdown958 B
references/solana-grpc-overview.mdmarkdown1.5 KB
references/solana-grpc-subscribe-accounts.mdmarkdown733 B
references/solana-grpc-subscribe-blocks.mdmarkdown739 B
references/solana-grpc-subscribe-request.mdmarkdown969 B
references/solana-grpc-subscribe-slots.mdmarkdown642 B
references/solana-grpc-subscribe-transactions.mdmarkdown890 B
references/solana-overview.mdmarkdown1.3 KB
references/solana-rpc.mdmarkdown7.2 KB
references/solana-wallets.mdmarkdown921 B
references/wallets-account-kit.mdmarkdown1.2 KB
references/wallets-bundler.mdmarkdown832 B
references/wallets-details.mdmarkdown1.1 KB
references/wallets-gas-manager.mdmarkdown799 B
references/wallets-overview.mdmarkdown1.6 KB
references/wallets-smart-wallets.mdmarkdown1.1 KB
references/wallets-solana-notes.mdmarkdown692 B
references/wallets-supported-chains.mdmarkdown737 B
references/wallets-wallet-apis.mdmarkdown1.0 KB
references/webhooks-address-activity.mdmarkdown1.5 KB
references/webhooks-custom-webhooks.mdmarkdown1.2 KB
references/webhooks-details.mdmarkdown2.5 KB
references/webhooks-nft-activity.mdmarkdown1.4 KB
references/webhooks-overview.mdmarkdown1.5 KB
references/webhooks-verify-signatures.mdmarkdown1.5 KB
references/webhooks-webhook-payloads.mdmarkdown1.1 KB
references/webhooks-webhook-types.mdmarkdown1.0 KB
rules/authentication.mdmarkdown4.5 KB
rules/curl-workflow.mdmarkdown8.5 KB
rules/making-requests.mdmarkdown5.6 KB
rules/overview.mdmarkdown2.2 KB
rules/payment.mdmarkdown3.4 KB
rules/reference.mdmarkdown5.0 KB
rules/wallet-bootstrap.mdmarkdown2.4 KB

references/data-simulation-api.md

View on GitHub
---
id: references/data-simulation-api.md
name: 'Simulation API'
description: 'Simulate transactions before submitting them on-chain. Use this for safety checks and user previews.'
tags:
  - alchemy
  - data-apis
  - data
related:
  - node-debug-api.md
  - recipes-simulate-transaction.md
updated: 2026-02-23
---
# Simulation API

Simulate transactions before submitting them on-chain. Preview asset changes and execution traces. JSON-RPC POST requests.

**Base URL**: `https://<network>.g.alchemy.com/v2/$ALCHEMY_API_KEY`

**Supported chains**: Ethereum, Base, Polygon, Arbitrum, Optimism (and testnets).

---

## `alchemy_simulateAssetChanges`

Simulates a transaction and returns the predicted asset changes (tokens gained/lost).

### Parameters

Single parameter: a `transaction` object.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `transaction.from` | string | No | Sender address (hex) |
| `transaction.to` | string | Yes | Recipient/contract address (hex) |
| `transaction.value` | string | No | ETH value to send (hex, in wei) |
| `transaction.data` | string | No | Calldata (hex) |
| `transaction.gas` | string | No | Gas limit (hex) |
| `transaction.gasPrice` | string | No | Gas price (hex, legacy) |
| `transaction.maxFeePerGas` | string | No | Max fee per gas (hex, EIP-1559) |
| `transaction.maxPriorityFeePerGas` | string | No | Max priority fee (hex, EIP-1559) |

### Request

```bash
curl -s -X POST https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "alchemy_simulateAssetChanges",
    "params": [{
      "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "to": "0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "value": "0x0",
      "data": "0xa9059cbb000000000000000000000000ef4396d9ff8107086d215a1c9f8866c54795d7c700000000000000000000000000000000000000000000000000000000000f4240"
    }]
  }'
```

### Response

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "changes": [
      {
        "assetType": "ERC20",
        "changeType": "TRANSFER",
        "from": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "to": "0xef4396d9ff8107086d215a1c9f8866c54795d7c7",
        "rawAmount": "1000000",
        "contractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "tokenId": null,
        "decimals": 6,
        "symbol": "USDC",
        "name": "USD Coin",
        "logo": "https://static.alchemyapi.io/images/assets/3408.png",
        "amount": "1.0"
      }
    ],
    "gasUsed": "0xb4c8",
    "error": null
  }
}
```

### Response Fields

| Field | Type | Description |
|-------|------|-------------|
| `changes` | array | List of asset change objects |
| `changes[].assetType` | string | `"NATIVE"`, `"ERC20"`, `"ERC721"`, `"ERC1155"`, `"SPECIAL_NFT"` |
| `changes[].changeType` | string | `"TRANSFER"`, `"APPROVE"` |
| `changes[].from` | string | Sender address |
| `changes[].to` | string | Recipient address |
| `changes[].rawAmount` | string | Raw token amount (smallest unit) |
| `changes[].amount` | string | Human-readable amount (decimal-adjusted) |
| `changes[].contractAddress` | string | Token contract address (null for native) |
| `changes[].tokenId` | string | Token ID (for NFTs) |
| `changes[].decimals` | integer | Token decimals |
| `changes[].symbol` | string | Token symbol |
| `changes[].name` | string | Token name |
| `changes[].logo` | string | Token logo URL |
| `gasUsed` | string | Gas used (hex) |
| `error` | object | Error details if simulation reverted (null on success) |

---

## `alchemy_simulateExecution`

Simulates a transaction and returns detailed execution traces (call traces, logs, state overrides).

### Parameters

Ordered parameters: `transaction`, `blockTag`.

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `transaction` | object | Yes | — | Same transaction object as `simulateAssetChanges` |
| `blockTag` | string | No | `"latest"` | `"latest"`, `"safe"`, `"finalized"`, `"earliest"`, or hex block number |

### Request

```bash
curl -s -X POST https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "alchemy_simulateExecution",
    "params": [
      {
        "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "to": "0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "data": "0xa9059cbb000000000000000000000000ef4396d9ff8107086d215a1c9f8866c54795d7c700000000000000000000000000000000000000000000000000000000000f4240"
      },
      "latest"
    ]
  }'
```

### Response

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "calls": [
      {
        "type": "CALL",
        "from": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "to": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "value": "0x0",
        "gas": "0x...",
        "gasUsed": "0x...",
        "input": "0xa9059cbb...",
        "output": "0x0000...0001",
        "decoded": {
          "methodName": "transfer",
          "inputs": [
            { "name": "to", "value": "0xef4396d9ff8107086d215a1c9f8866c54795d7c7", "type": "address" },
            { "name": "value", "value": "1000000", "type": "uint256" }
          ],
          "outputs": [
            { "name": "", "value": "true", "type": "bool" }
          ]
        }
      }
    ],
    "logs": [
      {
        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "topics": ["0xddf252ad...", "0x000...d8da...", "0x000...ef43..."],
        "data": "0x00000000000000000000000000000000000000000000000000000000000f4240",
        "decoded": {
          "eventName": "Transfer",
          "inputs": [
            { "name": "from", "value": "0xd8da...", "type": "address", "indexed": true },
            { "name": "to", "value": "0xef43...", "type": "address", "indexed": true },
            { "name": "value", "value": "1000000", "type": "uint256", "indexed": false }
          ]
        }
      }
    ]
  }
}
```

### Response Fields

| Field | Type | Description |
|-------|------|-------------|
| `calls` | array | Execution trace entries |
| `calls[].type` | string | Call type: `"CALL"`, `"DELEGATECALL"`, `"STATICCALL"`, `"CREATE"`, `"CREATE2"` |
| `calls[].from` | string | Caller address |
| `calls[].to` | string | Target address |
| `calls[].value` | string | ETH value (hex) |
| `calls[].gas` | string | Gas allocated (hex) |
| `calls[].gasUsed` | string | Gas consumed (hex) |
| `calls[].input` | string | Input calldata (hex) |
| `calls[].output` | string | Return data (hex) |
| `calls[].decoded` | object | ABI-decoded method name, inputs, outputs, and authority (e.g., `"ETHERSCAN"`) |
| `calls[].calls` | array | Nested sub-calls (only in `NESTED` format) |
| `logs` | array | Event logs emitted |
| `logs[].address` | string | Emitting contract |
| `logs[].topics` | string[] | Log topics |
| `logs[].data` | string | Log data (hex) |
| `logs[].decoded` | object | ABI-decoded event name and inputs |

---

## `alchemy_simulateAssetChangesBundle`

Simulates a bundle of transactions sequentially and returns asset changes for each.

### Parameters

Single parameter: `transactions` array (same transaction object format). **Max 3 transactions per bundle.**

### Request

```bash
curl -s -X POST https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "alchemy_simulateAssetChangesBundle",
    "params": [[
      {
        "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "to": "0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "data": "0x095ea7b3..."
      },
      {
        "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "to": "0xdef1c0ded9bec7f1a1670819833240f027b25eff",
        "data": "0xd9627aa4..."
      }
    ]]
  }'
```

### Response

Returns an array of results, one per transaction. Each result has the same `changes`, `gasUsed`, and `error` fields as `simulateAssetChanges`.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    { "changes": [...], "gasUsed": "0x...", "error": null },
    { "changes": [...], "gasUsed": "0x...", "error": null }
  ]
}
```

---

## `alchemy_simulateExecutionBundle`

Simulates a bundle of transactions and returns execution traces for each.

### Parameters

Ordered parameters: `transactions`, `blockTag`. Same as `simulateExecution` but with a transactions array. **Max 3 transactions per bundle.**

### Request

```bash
curl -s -X POST https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "alchemy_simulateExecutionBundle",
    "params": [
      [
        { "from": "0xd8dA...", "to": "0xA0b8...", "data": "0x095ea7b3..." },
        { "from": "0xd8dA...", "to": "0xdef1...", "data": "0xd9627aa4..." }
      ],
      "latest"
    ]
  }'
```

### Response

Returns an array of results, one per transaction. Each result has `calls` and `logs` fields as in `simulateExecution`.

---

## Notes

- Simulation does not guarantee real execution outcome if on-chain state changes between simulation and submission.
- Bundle transactions execute sequentially — earlier transactions affect the state for later ones.
- Simulation is more compute-intensive than standard reads. Cache results where possible.
- Reverted simulations return an `error` object with the revert reason.

## Agentic Gateway

This API is also available via `https://x402.alchemy.com/{chainNetwork}/v2` without an API key.
See the `agentic-gateway` skill for SIWE authentication and x402 payment setup.

## Official Docs
- [Simulation API Overview](https://www.alchemy.com/docs/data/simulation-api)
- [alchemy_simulateAssetChanges](https://www.alchemy.com/docs/data/simulation-api/simulation-api-endpoints/alchemy-simulate-asset-changes)
- [alchemy_simulateExecution](https://www.alchemy.com/docs/data/simulation-api/simulation-api-endpoints/alchemy-simulate-execution)
- [alchemy_simulateAssetChangesBundle](https://www.alchemy.com/docs/data/simulation-api/simulation-api-endpoints/alchemy-simulate-asset-changes-bundle)
- [alchemy_simulateExecutionBundle](https://www.alchemy.com/docs/data/simulation-api/simulation-api-endpoints/alchemy-simulate-execution-bundle)
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall