> ## Documentation Index
> Fetch the complete documentation index at: https://docs.range.org/llms.txt
> Use this file to discover all available pages before exploring further.

> Simulate multiple Solana transactions in a single request to get balance changes, state updates, and risk analysis for each.


# Simulate Solana transactions

Simulate multiple Solana transactions in a single request. Returns the same
detailed analysis as the
[single transaction simulator](/risk-api/simulator/simulate-solana-transaction)
, instruction parsing, asset transfers, balance changes, state predictions, and
account risk scoring, for each transaction in the batch.

***

## When to Use Batch Simulation

* **Multi-step workflows**: Simulate a sequence of dependent transactions
  together.
* **Bulk validation**: Validate multiple independent transactions in one API
  call instead of separate requests.
* **Portfolio operations**: Analyze multiple swap or transfer transactions
  simultaneously.

***

## How to Use

Send a POST request with an array of transactions:

```json theme={null}
{
  "transactions": [
    {
      "payload": "<ENCODED_TRANSACTION_1>",
      "encoding_type": "base64"
    },
    {
      "payload": "<ENCODED_TRANSACTION_2>",
      "encoding_type": "base64"
    }
  ]
}
```

Each transaction in the array accepts the same `payload` and `encoding_type`
parameters as the
[single transaction endpoint](/risk-api/simulator/simulate-solana-transaction).

**Cluster support:** `devnet`, `testnet`, `mainnet-beta`

***

## Response Format

The response contains an array of results, one per submitted transaction. Each
result follows the same schema as the single transaction simulator:

| Field                    | Description                                                            |
| ------------------------ | ---------------------------------------------------------------------- |
| `instruction_groups`     | Hierarchical view of all instructions with parsed data.                |
| `asset_transfers`        | Detected SOL and token transfers.                                      |
| `lamport_changes`        | Balance changes by address.                                            |
| `expected_state_changes` | Predicted account-level state updates.                                 |
| `transaction_risk`       | Risk analysis with `accounts_risk_score` and `exploit_risks_detected`. |
| `returned_data`          | Data returned by programs during execution.                            |
| `logs`                   | Complete execution logs.                                               |
| `transaction_summary`    | Compute units, fee breakdown, programs invoked.                        |
| `error`                  | Failure reason if simulation failed for this transaction.              |

For full details on each field, see the
[single transaction simulator documentation](/risk-api/simulator/simulate-solana-transaction#response-breakdown).


## OpenAPI

````yaml post /v1/simulate/solana/transactions
openapi: 3.0.0
info:
  title: Range Risk API
  description: The Range Risk API for risk assessment of crypto addresses.
  version: 1.7.8
  contact: {}
servers:
  - url: https://api.range.org
    description: Range API Server
security:
  - Authorization: []
tags:
  - name: Risk
    description: Get risk information about a crypto address.
  - name: Risk v2
    description: >-
      Address risk assessment, workspace configuration, and signals catalogue
      (API v2).
  - name: Simulator
    description: Simulate a transaction on a network.
  - name: Alert Templates
    description: Browse alert rule templates available to the workspace.
  - name: Alert Rules
    description: Create and manage workspace alert rules.
  - name: Alert Events
    description: List and retrieve fired alert events.
  - name: Channels
    description: Configure alert delivery channels.
paths:
  /v1/simulate/solana/transactions:
    post:
      tags:
        - Simulator
      summary: Simulate Solana transactions
      description: >-
        Simulate multiple Solana transactions to get the address balance changes
        after the transactions are executed.
      operationId: simulateSolanaTxs
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                transactions:
                  type: array
                  items:
                    type: object
                    properties:
                      payload:
                        type: string
                      encoding_type:
                        type: string
                        enum:
                          - base64
                          - base58
                    required:
                      - payload
                      - encoding_type
              required:
                - transactions
            examples:
              request:
                value:
                  transactions:
                    - payload: >-
                        ASBmxvNLxR9UJImZ0AW5jg8dnPRJ4WrgTfVPzYJTw/dsdxJLQ2R3PL6sOGZRpm8Cvj3CCj487knAlkVDjrurJQ+AAQAHDwi27GhTZy4xU+no9CPSYfbdV1f7fPh2AZ8ugRR0lzY/NkTF/pcxbJ1GWhb/ojq1kpL45RJn2LGQqvS+DlQNKMJDuMya7qyNXnGZUaTmp2cnsKVtfo4Ls7tredY1eFVh/pL42Zv7ym+AgvHJQrwx2Uy3BthbLxxvtbLp7x4PC0b0lKed/Fk9s8DKxlNmWP+yQe4ZLmsyhIKUU9zZSCjcvGiv0erWb2FXM10++aHVXhcOjcwm3j+hU8QjFjPAG893CbFODeVen7qGOW6/1UjP+MkgEerHt1uqmy2caob1oXFB9fvkBoqq3bIiQD6qx3uSmgTZ1H+10FAQReZ/sk63f2sAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMGRm/lIRcy/+ytunLDm+e8jOW7xfcSayxDmzpAAAAABHnVW/IxwG7udMVuzmgVB/2xst6j9I5RArHNola8E48FSlNamSkhBk0k6HFg2jh8fDW13bySu4HkH6hAQQVEjYyXJY9OJInxuz0QKRSODYMLWhOZ2v8QhASOe9jb6fhZtD/6J/XX9kp0wJsfKVh53ksJqzbfyd1RSzIap7OM5ejl4fbczcd5b+eKD48WExJdmg2tkPhcrXKsnw6Eytv9rt7t5tBFxI1Qc4SYWt2OkQNrwLSbBkWaZ+daWcdmirykCQkABQKwcQsACAIABgwCAAAAYwgAAAAAAAAMBgAHACQIJgEBDAYAAwAqCCYBAQwGAAUALggmAQEMBgAHACQIJgEBDAYAAgAtCCYBAQpCJgAHBQouCg0KJwAPBwIQEQ4lJismJgsAIiotAyECHx4gBCMrJgAdAxkFGxwaGCwoAAAVKRMSFxYUBQcoKCYIKAEKNeUXy5d6460qBAAAAFYA+mQAAS8AAGQBAhEBZAIDJwFkAwAAtVsSAAAAAOvQWxIAAAAAAAAACwARci1mOjM1ODY0MTczOTpyYTIElfeMHpclyjALvoOYBNZHC6S6vuMHe9I5nP8MmmxUl0cDiISKBAyGAom8+jUvkKtv40MXcOaoCkpAbJnSTRzNhDSJRQydxNnFgwYLDhANCAoCDA+OaHTLsrJF6N6xUSsg3E+nAZQJes71crtX3lTKNrmUFQaYlJecnZYFkxWZi5vSaTvsE8UgBxGyDP8AGoLYuuKa0FyIvnJZ6Xhha+SUoAaIwIeFwYYA
                      encoding_type: base64
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                type: object
components:
  securitySchemes:
    Authorization:
      scheme: bearer
      bearerFormat: API Key
      description: 'Use Authorization: Bearer <api-key>'
      type: http

````