> For the complete documentation index, see [llms.txt](https://docs.expand.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.expand.network/integrations/blockchains/non-evm-based-chains/xrp-ledger.md).

# XRP Ledger

### Available Endpoints:

*Click on the endpoint to jump to the section with full details*

* [<mark style="color:blue;">/getbalance</mark>](#getbalance) <mark style="color:blue;">`GET`</mark> <mark style="color:blue;"></mark><mark style="color:blue;">-</mark> Get the balance or number of the given token in the requested public address.
* [<mark style="color:blue;">/getblock</mark>](#getblock) <mark style="color:blue;">`GET`</mark> <mark style="color:blue;"></mark><mark style="color:blue;">-</mark> Get details of a block(ledger).
* [<mark style="color:blue;">/getgasprice</mark>](#getgasprice) <mark style="color:blue;">`GET`</mark> <mark style="color:blue;"></mark><mark style="color:blue;">-</mark> Get the current gas price from the XRPL.
* [<mark style="color:blue;">/gettransaction</mark>](#gettransaction) <mark style="color:blue;">`GET`</mark> <mark style="color:blue;"></mark><mark style="color:blue;">-</mark> Get details of a specified transaction.
* [<mark style="color:blue;">/portfolio</mark>](#portfolio) <mark style="color:blue;">`GET`</mark> <mark style="color:blue;"></mark><mark style="color:blue;">-</mark> Get comprehensive information about the assets/ tokens a user owns, including their name, balance, symbol, address, and their equivalent USD price.
* [<mark style="color:blue;">/getusertransactions</mark>](#getusertransactions) <mark style="color:blue;">`GET`</mark> <mark style="color:blue;"></mark><mark style="color:blue;">-</mark> Get the historical transaction details for a specific user address.&#x20;
* [<mark style="color:blue;">/getlatestledger</mark> ](#getlatestledger)<mark style="color:blue;">`GET`</mark> <mark style="color:blue;"></mark><mark style="color:blue;">-</mark> Get details for the current latest known ledger of the node.
* [<mark style="color:blue;">/sendtransaction</mark>](#sendtransaction) <mark style="color:green;">`POST`</mark> <mark style="color:blue;">-</mark> Submit a signed transaction to XRPL for processing.
* [<mark style="color:blue;">/createaccount</mark>](#createaccount) <mark style="color:green;">`POST`</mark> <mark style="color:blue;">-</mark> Initiates a transaction to fund a newly created account 10 XRP using the public key as the account ID.
* [<mark style="color:blue;">/decodetransaction</mark> ](#decodetransaction)<mark style="color:green;">`POST`</mark> <mark style="color:blue;">-</mark> Get the decoded transaction(sender, recipient, gas limit, method signature, and more) for the provided raw transaction.&#x20;

*Also, see* [Error Handling Details](#error-handling-details)

### Chain IDs

Please use Chain ID <mark style="color:orange;">**1600**</mark> for the XRP Ledger Mainnet and <mark style="color:orange;">**1601**</mark> for the XRP Ledger Testnet\
\
See the  [Chain ID](/ids/chain-ids.md) for a complete list of DEX IDs.&#x20;

## Endpoint Details

### /getbalance

Get the balance or number of the given token in the requested public address.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/chain/getbalance`

#### Query Parameters

| Name                                      | Type   | Description                                                                                                                   |
| ----------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| rpc                                       | String | Remote procedural call URL                                                                                                    |
| chainId<mark style="color:red;">\*</mark> | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details.                                                                  |
| chainSymbol                               | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details.                                                                  |
| address<mark style="color:red;">\*</mark> | String | The public address to get the balance of.                                                                                     |
| issuer                                    | String | The public address of the issuer.                                                                                             |
| assetCode                                 | String | <p>The code of asset to get the balance of.<br><mark style="color:red;">\*</mark>Required, if issuer address is provided.</p> |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/chain/getbalance?chainId=1600&address=rogue5HnPRSszD9CWGSUz8UGHMVwSSKF6&assetCode=USD&issuer=rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "assetCode": "USD",
        "issuer": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
        "balance": "409832045505"
    }
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /getblock

Get details of a block(ledger).

<mark style="color:blue;">`GET`</mark> `https://historicallp.api.expand.network/chain/getblock`

#### Query Parameters

| Name                                          | Type   | Description                                                  |
| --------------------------------------------- | ------ | ------------------------------------------------------------ |
| rpc                                           | String | Remote procedural call URL.                                  |
| chainId<mark style="color:red;">\*</mark>     | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| chainSymbol                                   | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| blockNumber<mark style="color:red;">\*</mark> | String | Sequence number of the ledger.                               |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://historicallp.api.expand.network/chain/getblock?chainId=1600&blockNumber=89475323
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
  "status": 200,
  "msg": "success",
  "data": {
    "difficulty": null,
    "gasLimit": null,
    "gasUsed": null,
    "hash": "CD0165E3895A50A6BF7B663BEBFA2F4D71B74877576B9E5E98F4952128CA0685",
    "miner": null,
    "nonce": null,
    "number": 89475323,
    "parentHash": "2F5640ABEADEF6D6CDBB37744579C917505B25BB6818A0B547DC1192C6725CDF",
    "size": null,
    "timestamp": "774725511",
    "totalDifficulty": null,
    "transactions": [
      {
        "Account": "rL72YxzbBv43isRYakrfTUzCaGbg4pWbs4",
        "Amount": "43",
        "DeliverMax": "43",
        "Destination": "rHcXrn8joXL2Qe7BaMnhB5VRuj1XKEmUW6",
        "DestinationTag": 2760758033,
        "Fee": "10",
        "Sequence": 89271357,
        "SigningPubKey": "ED0026C5C2EB6FB2048A960ACDF73695F316B7BAE0DFD999D24C0A2075F7A73037",
        "TransactionType": "Payment",
        "TxnSignature": "8958A0BE36F878C94C02A658647A0E5AA81E32CB1986CC967F1FB1F6728B26DC347D973CABB5EF49D7DFDADC24ABD83ECE116E8206F6DE943ECF945168265C05",
        "hash": "01452A92792C71FD3E3ACC9F024535F777FF2D85B607AA7A924E9E13A25CF50E",
        "metaData": {
          "AffectedNodes": [
            {
              "ModifiedNode": {
                "FinalFields": {
                  "Account": "rHcXrn8joXL2Qe7BaMnhB5VRuj1XKEmUW6",
                  "Balance": "1059808075",
                  "Flags": 0,
                  "OwnerCount": 0,
                  "Sequence": 73560948
                },
                "LedgerEntryType": "AccountRoot",
                "LedgerIndex": "9EDF161DF605EA574DEE5E5B8FEB76315736D7FB038D5586A85575D64F8F8F43",
                "PreviousFields": {
                  "Balance": "1059808032"
                },
                "PreviousTxnID": "2F429C147463DA4DFA7FD5894D990BD0E654AA6B04F01052FCF29EDF77C6B6D8",
                "PreviousTxnLgrSeq": 89475323
              }
            },
            {
              "ModifiedNode": {
                "FinalFields": {
                  "Account": "rL72YxzbBv43isRYakrfTUzCaGbg4pWbs4",
                  "Balance": "63645870",
                  "Flags": 0,
                  "OwnerCount": 0,
                  "Sequence": 89271358
                },
                "LedgerEntryType": "AccountRoot",
                "LedgerIndex": "AC35635B8AEDC6378ADFAFBE2F3386D42D04CBFD651E7CB4687BEB9008427C12",
                "PreviousFields": {
                  "Balance": "63645923",
                  "Sequence": 89271357
                },
                "PreviousTxnID": "04A00FE6A74C89BB96CE3FEEDB25DB7AAA20EAFFE2C5771B881B527546673C9A",
                "PreviousTxnLgrSeq": 89475323
              }
            }
          ],
          "TransactionIndex": 52,
          "TransactionResult": "tesSUCCESS",
          "delivered_amount": "43"
        }
      }
    ],
    "transactionsRoot": null,
    "uncles": null
  }
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /getgasprice

Get the current gas price from the XRPL.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/chain/getgasprice`

#### Query Parameters

| Name                                      | Type   | Description                                                  |
| ----------------------------------------- | ------ | ------------------------------------------------------------ |
| rpc                                       | String | Remote procedural call URL.                                  |
| chainId<mark style="color:red;">\*</mark> | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| chainSymbol                               | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/chain/getgasprice?chainId=1600
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "gasPrice": "10"
    }
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /gettransaction

Get details of a specified transaction.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/chain/gettransaction`

#### Query Parameters

| Name                                              | Type   | Description                                                  |
| ------------------------------------------------- | ------ | ------------------------------------------------------------ |
| rpc                                               | String | Remote procedural call URL.                                  |
| chainId<mark style="color:red;">\*</mark>         | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| chainSymbol                                       | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| transactionHash<mark style="color:red;">\*</mark> | String | The transaction hash.                                        |

{% tabs %}
{% tab title="Sample Request" %}

```uri
https://api.expand.network/chain/gettransaction?chainId=1600&transactionHash=478061849940F06D822BF28A0D3FF6EE9832729E79DDD10C05967FB0C86B3C5E
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "hash": "478061849940F06D822BF28A0D3FF6EE9832729E79DDD10C05967FB0C86B3C5E",
        "transactionStatus": true,
        "blockNumber": "89475741",
        "timestamp": "774727140",
        "from": "rs3RZsga1KbhSZetRsL22pkTyWyFU86Kkf",
        "to": "rEzdn46Gjxh8YJNAZrmMUsFh1QDfT8uuTs",
        "value": "44",
        "transactionFees": "10",
        "transactionType": "Payment",
        "gas": null,
        "gasPrice": null,
        "input": null,
        "nonce": 89345903,
        "network": null,
        "meta": {
            "AffectedNodes": [
                {
                    "ModifiedNode": {
                        "FinalFields": {
                            "Account": "rs3RZsga1KbhSZetRsL22pkTyWyFU86Kkf",
                            "Balance": "60430731",
                            "Flags": 0,
                            "OwnerCount": 0,
                            "Sequence": 89345904
                        },
                        "LedgerEntryType": "AccountRoot",
                        "LedgerIndex": "054427CEEE4A008A9E92FC26DEEDB5FEAE6F915D5FD7836B047335C6A20AE7FA",
                        "PreviousFields": {
                            "Balance": "60430785",
                            "Sequence": 89345903
                        },
                        "PreviousTxnID": "2AB13EC6BFA96520B054617121413CB88BF4752E05DEE555F71A1766910368BC",
                        "PreviousTxnLgrSeq": 89475740
                    }
                },
                {
                    "ModifiedNode": {
                        "FinalFields": {
                            "Account": "rEzdn46Gjxh8YJNAZrmMUsFh1QDfT8uuTs",
                            "Balance": "366727618",
                            "Flags": 0,
                            "OwnerCount": 0,
                            "Sequence": 89221292
                        },
                        "LedgerEntryType": "AccountRoot",
                        "LedgerIndex": "51C728407B1A8B3037D6B40ADB49013ABD9F62FB12ED8981D6575C722A176EB1",
                        "PreviousFields": {
                            "Balance": "366727574"
                        },
                        "PreviousTxnID": "AAB53A2D2CA8953EA6C6A21BE1C0F2CB14D7E5302262699134BBCA38656BEEF4",
                        "PreviousTxnLgrSeq": 89475740
                    }
                }
            ],
            "TransactionIndex": 0,
            "TransactionResult": "tesSUCCESS",
            "delivered_amount": "44"
        },
        "TxnSignature": "367F6D98E2EE0F9901C2A0FA494AEDCDB6D83F0744BB32D39E9BAF526DA42DAB72D73294EA57BB098032D37495A06B6ED0546C7342F738EC3814077799B2820B"
    }
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /portfolio

Get the comprehensive information about the assets/ tokens owned by a user, including their name, balance, symbol, address, and their equivalent USD price.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/chain/portfolio`

#### Query Parameters

| Name                                      | Type    | Description                                                                   |
| ----------------------------------------- | ------- | ----------------------------------------------------------------------------- |
| rpc                                       | String  | Remote procedural call URL.                                                   |
| chainId<mark style="color:red;">\*</mark> | String  | Refer to the [Chain ID ](/ids/chain-ids.md)page for details.                  |
| chainSymbol                               | String  | Refer to the [Chain ID ](/ids/chain-ids.md)page for details.                  |
| address<mark style="color:red;">\*</mark> | String  | Public addess of the user.                                                    |
| assetType                                 | String  | `fungible`/`nonFungible` standard choice. By default, `all`.                  |
| availableOnly                             | Boolean | <p>By default, true. <br>If true, tokens with balance > 0 will be listed.</p> |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/chain/chain/portfolio?chainId=1600&address=rogue5HnPRSszD9CWGSUz8UGHMVwSSKF6&assetType=fungible&availableOnly=true
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
  "status": 200,
  "msg": "success",
  "data": {
    "native": "991378078",
    "assets": [
      {
        "assetCode": "BTC",
        "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
        "balance": "818138018",
        "assetType": "fungible"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### **/getusertransactions**

Get the historical transaction details for a specific user address.&#x20;

<mark style="color:blue;">`GET`</mark> `https://historicallp.api.expand.network/chain/getusertransactions`

#### Query Parameters

| Name                                      | Type   | Description                                                                                                      |
| ----------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------- |
| rpc                                       | String | Remote procedural call URL.                                                                                      |
| chainId<mark style="color:red;">\*</mark> | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details.                                                     |
| chainSymbol                               | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details.                                                     |
| address<mark style="color:red;">\*</mark> | String | The public address of the user.                                                                                  |
| pageToken                                 | String | A string ID that points to a specific location in a collection of responses, present at the end of the response. |
| sortOrder                                 | String | <p>The transaction sorting order. <br>asc or desc. <br>By default, desc.</p>                                     |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://historicallp.api.expand.network/chain/getusertransactions?chainId=1600&address=r3KFdr7FTU1hxo9DbS1h65Wq8MXG7e9cgK&pageToken=89465257:45&sortOrder=asc
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
  "status": 200,
  "msg": "success",
  "data": {
    "transactions": [
      {
        "hash": "81DD457F8A93F5461595C783B3E2CF096D37FA61BEA5586237F6793640E1CCD3",
        "transactionStatus": false,
        "blockNumber": "89406864",
        "timestamp": "774458731",
        "from": "rXSYHuUUrFsk8CABEf6PtrYwFWoAfUMrK",
        "to": "r3KFdr7FTU1hxo9DbS1h65Wq8MXG7e9cgK",
        "value": {
          "currency": "457665724275726E000000000000000000000000",
          "issuer": "rhUHDGG5po5Dg6oxtaodMPTR4xytToSL1Y",
          "value": "0.139436"
        },
        "transactionFees": "20",
        "transactionType": "Payment",
        "gas": null,
        "gasPrice": null,
        "input": null,
        "nonce": 83654435,
        "network": null,
        "meta": {
          "AffectedNodes": [
            {
              "ModifiedNode": {
                "FinalFields": {
                  "Balance": {
                    "currency": "457665724275726E000000000000000000000000",
                    "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                    "value": "-10.03493459156791"
                  },
                  "Flags": 2228224,
                  "HighLimit": {
                    "currency": "457665724275726E000000000000000000000000",
                    "issuer": "r3KFdr7FTU1hxo9DbS1h65Wq8MXG7e9cgK",
                    "value": "10937302.217631"
                  },
                  "HighNode": "3",
                  "LowLimit": {
                    "currency": "457665724275726E000000000000000000000000",
                    "issuer": "rhUHDGG5po5Dg6oxtaodMPTR4xytToSL1Y",
                    "value": "0"
                  },
                  "LowNode": "9"
                },
                "LedgerEntryType": "RippleState",
                "LedgerIndex": "4F75D88429A8A5B3007291D2B0DBA5F0344C4F5BD1202C79A194A338F322A353",
                "PreviousFields": {
                  "Balance": {
                    "currency": "457665724275726E000000000000000000000000",
                    "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                    "value": "-9.89549859156791"
                  }
                },
                "PreviousTxnID": "A2B4708FB335E089F9C8FE00CE75B8DB0357982EF781C7BAA37929A191C8031B",
                "PreviousTxnLgrSeq": 89406849
              }
            },
            {
              "ModifiedNode": {
                "FinalFields": {
                  "Account": "rXSYHuUUrFsk8CABEf6PtrYwFWoAfUMrK",
                  "Balance": "103760378",
                  "Flags": 0,
                  "OwnerCount": 5,
                  "Sequence": 83654436
                },
                "LedgerEntryType": "AccountRoot",
                "LedgerIndex": "8A884B57E13846DA2275DDC4EEA6ED8838E436225799CA5F0FE77F16739BFF85",
                "PreviousFields": {
                  "Balance": "103760398",
                  "Sequence": 83654435
                },
                "PreviousTxnID": "71692EBA11C73E8D6175E32901E51CBC781BC5A7BA080DFE7160CD99CCE54739",
                "PreviousTxnLgrSeq": 89406863
              }
            },
            {
              "ModifiedNode": {
                "FinalFields": {
                  "Balance": {
                    "currency": "457665724275726E000000000000000000000000",
                    "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                    "value": "1611629.0842435"
                  },
                  "Flags": 1114112,
                  "HighLimit": {
                    "currency": "457665724275726E000000000000000000000000",
                    "issuer": "rhUHDGG5po5Dg6oxtaodMPTR4xytToSL1Y",
                    "value": "0"
                  },
                  "HighNode": "3",
                  "LowLimit": {
                    "currency": "457665724275726E000000000000000000000000",
                    "issuer": "rXSYHuUUrFsk8CABEf6PtrYwFWoAfUMrK",
                    "value": "18053707.5234989"
                  },
                  "LowNode": "0"
                },
                "LedgerEntryType": "RippleState",
                "LedgerIndex": "8AFBB525423C5467E47BF8FD594283D46F9881EA9054413B99B341E48F65D4E2",
                "PreviousFields": {
                  "Balance": {
                    "currency": "457665724275726E000000000000000000000000",
                    "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                    "value": "1611629.2933975"
                  }
                },
                "PreviousTxnID": "71692EBA11C73E8D6175E32901E51CBC781BC5A7BA080DFE7160CD99CCE54739",
                "PreviousTxnLgrSeq": 89406863
              }
            }
          ],
          "TransactionIndex": 48,
          "TransactionResult": "tesSUCCESS",
          "delivered_amount": {
            "currency": "457665724275726E000000000000000000000000",
            "issuer": "rhUHDGG5po5Dg6oxtaodMPTR4xytToSL1Y",
            "value": "0.139436"
          }
        },
        "memos": [
          {
            "Memo": {
              "MemoData": "4578747261204661726D696E67207265776172642066726F6D204D61676E6574696320666F722070726F766964696E67206C697175696469747920746F20746865204D41475F585250202B20457665724275726E5F58525020706F6F6C73"
            }
          }
        ],
        "TxnSignature": "3045022100C0076774DFC94F5F019AF7AF53BD9D386653B0E4CAEC614F9311E64ED75B09D102203AFA6C2B2EA3C969959C95A1BE11779D0B6A407A3DE6383019DDBE3A8F7B1728"
      }
    ],
    "nextPageToken": "89406849:89"
  }
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /getlatestledger

Get details for the current latest known ledger of the node.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/chain/getlatestledger`

#### Query Parameters

| Name        | Type   | Description                                                  |
| ----------- | ------ | ------------------------------------------------------------ |
| rpc         | String | Remote procedural call URL.                                  |
| chainId     | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| chainSymbol | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/chain/getlatestledger?chainId=1600
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
  "status": 200,
  "msg": "success",
  "data": {
    "difficulty": null,
    "gasLimit": null,
    "gasUsed": null,
    "miner": null,
    "nonce": null,
    "number": "89515194",
    "parentHash": "CA7174CA0D0D6D8250C95B07B525BF543B9FDF63CB1405B8DBA36FB38A306E0C",
    "size": null,
    "timestamp": null,
    "totalDifficulty": null,
    "transactions": [
      {
        "Account": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah",
        "Fee": "20",
        "Flags": 0,
        "LastLedgerSequence": 89515196,
        "OfferSequence": 145028949,
        "Sequence": 145028958,
        "SigningPubKey": "0253C1DFDCF898FE85F16B71CCE80A5739F7223D54CC9EBA4749616593470298C5",
        "TakerGets": "36570000000",
        "TakerPays": {
          "currency": "USD",
          "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
          "value": "21693.50385126"
        },
        "TransactionType": "OfferCreate",
        "TxnSignature": "3044022055CE8A031FC49FFDA2D329FB5523EDD6893C1E969CC84BD27D6336DB31D5086202206152BED621E4013E2C49CEC62FA9E01964E0426B93E936D121D7A1D77E9997D1",
        "hash": "044A0DFED659DF5D310726ED07D83BD53AD83DFA6ADD22336BF01EF1DF52977F"
      }
    ],
    "transactionsRoot": null,
    "uncles": null
  }
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /sendtransaction

Submit a signed transaction to XRPL for processing.

<mark style="color:green;">`POST`</mark> `https://api.expand.network/chain/sendtransaction`

#### Request Body

| Name                                             | Type   | Description                                                                                   |
| ------------------------------------------------ | ------ | --------------------------------------------------------------------------------------------- |
| rpc                                              | String | Remote procedural call URL.                                                                   |
| chainId                                          | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details.                                  |
| chainSymbol                                      | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details.                                  |
| rawTransaction<mark style="color:red;">\*</mark> | String | The signed transaction to broadcast for inclusion in a ledger, serialized as a base64 string. |

{% tabs %}
{% tab title="Sample Request" %}

```json
{
  "chainId": "1600",
  "rawTransaction": "12000022000000002405594454201B055945D261400000000000271068400000000000000C73210330A70B8D820332240B97477520296FD5A8F2E531B17DF54C6DE13F8737012E8374473045022100C32E02C67EEA80379EFBCF450E5BB66F62122B57D0F91F0694F5D5BE840D738802202536AAC1568EAE56BD2F04B8822E580D325C367468455B2475C81F4F3D08B4018114A682E02A8BDB803AB509F3BE5D384841A7227CE583149901A6A96D83F029FB8BCF116527AD19A6EEA803"
}
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1600",
        "transactionHash": "CE0EE218F817D29472CEBA606A4C532EC8C04452EFA7D9E30E9639BF018597D9"
    }
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /createaccount

Initiates a transaction to fund a newly created account 10 XRP using the public key as the account ID.

<mark style="color:green;">`POST`</mark> `https://api.expand.network/chain/createaccount`

#### Request body

| Name                                      | Type   | Description                                                  |
| ----------------------------------------- | ------ | ------------------------------------------------------------ |
| rpc                                       | String | Remote procedural call URL.                                  |
| chainId<mark style="color:red;">\*</mark> | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| chainSymbol                               | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| from<mark style="color:red;">\*</mark>    | String | Public address of the sender who funds the account.          |
| to<mark style="color:red;">\*</mark>      | String | Public address of the recipient who will get funded.         |
| destinationTag                            | String |                                                              |

{% tabs %}
{% tab title="Sample Request" %}

```json
{
    "chainId": "1600",
    "from": "rogue5HnPRSszD9CWGSUz8UGHMVwSSKF6",
    "to": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah"
}
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1600",
        "from": "rogue5HnPRSszD9CWGSUz8UGHMVwSSKF6",
        "to": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah",
        "fee": "12",
        "data": "eyJUcmFuc2FjdGlvblR5cGUiOiJQYXltZW50IiwiQWNjb3VudCI6InJvZ3VlNUhuUFJTc3pEOUNXR1NVejhVR0hNVndTU0tGNiIsIkFtb3VudCI6IjEwMDAwMDAwIiwiRGVzdGluYXRpb24iOiJyQlR3TGdhM2kyZ3ozZG9YNkd2YTNNZ0VWOFpDRDhqamFoIiwiRmxhZ3MiOjAsIkZlZSI6IjEyIiwiU2VxdWVuY2UiOjU1MDA5MDAsIkxhc3RMZWRnZXJTZXF1ZW5jZSI6ODk1MTgwMjF9",
        "referenceId": "11a8db27d6a3411c8ab18abf27375699"
    }
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /decodetransaction

Get the decoded transaction(sender, recipient, gas limit, method signature, and more) for the provided raw transaction.&#x20;

<mark style="color:green;">`POST`</mark> `https://api.expand.network/chain/decodetransaction`

#### Request Body

| Name                                             | Type   | Description                                                                        |
| ------------------------------------------------ | ------ | ---------------------------------------------------------------------------------- |
| chainId<mark style="color:red;">\*</mark>        | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. By default, Ethereum. |
| chainSymbol                                      | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details.                       |
| rawTransaction<mark style="color:red;">\*</mark> | String | A signed XRPL transaction, serialized as a base64 string.                          |

{% tabs %}
{% tab title="Sample Request" %}

```json
{
  "chainId": "1600",
  "rawTransaction": "12000022000000002405594454201B055945D261400000000000271068400000000000000C73210330A70B8D820332240B97477520296FD5A8F2E531B17DF54C6DE13F8737012E8374473045022100C32E02C67EEA80379EFBCF450E5BB66F62122B57D0F91F0694F5D5BE840D738802202536AAC1568EAE56BD2F04B8822E580D325C367468455B2475C81F4F3D08B4018114A682E02A8BDB803AB509F3BE5D384841A7227CE583149901A6A96D83F029FB8BCF116527AD19A6EEA803"
}
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "TransactionType": "Payment",
        "Flags": 0,
        "Sequence": 89736276,
        "LastLedgerSequence": 89736658,
        "Amount": "10000",
        "Fee": "12",
        "SigningPubKey": "0330A70B8D820332240B97477520296FD5A8F2E531B17DF54C6DE13F8737012E83",
        "TxnSignature": "3045022100C32E02C67EEA80379EFBCF450E5BB66F62122B57D0F91F0694F5D5BE840D738802202536AAC1568EAE56BD2F04B8822E580D325C367468455B2475C81F4F3D08B401",
        "Account": "rGBRxEf5GAZyLwHUXvspivv8JNejp58QyN",
        "Destination": "rNxp4h8apvRis6mJf9Sh8C6iRxfrDWN7AV"
    }
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### Error Handling Details

<table><thead><tr><th width="253">Error</th><th>Description</th></tr></thead><tbody><tr><td>400 (Bad Request)</td><td>Indicates the request is invalid or missing the required parameters. The msg field will contain details about the error.</td></tr><tr><td>401 (Unauthorised)</td><td>Indicates the request lacks valid authentication credentials (API key). Ensure that you provide a valid API key in the request headers.</td></tr><tr><td>404 (Not Found)</td><td>Indicates that the specified endpoint or resource does not exist.</td></tr><tr><td>500 (Server Error)</td><td>Indicates an internal server error.</td></tr></tbody></table>

[<mark style="color:blue;">back to top</mark>](#endpoints-available)
