XRP Ledger RWA

Available Endpoints:

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

• /settrustline POST - Implement a trustline between an issuer and asset holder.

• /issue POST - Executes a payment operation to issue an asset (excluding XRP) to the distributor.

• /transfer POST - Trigger a payment operation to send an amount in a specific asset (XRP or non-XRP) to a destination account.

• /burn POST - Executes a transaction to burn or delete an asset.

• /freeze POST - Executes a transaction to revoke an existing trustline’s authorization, thereby freezing the asset held by an account.

Also, see Error Handling Details

Chain IDs

Please use Chain ID 1600 for the XRP Ledger Mainnet and 1601 for the XRP Ledger Testnet See the Chain ID for a complete list of DEX IDs.

Endpoint Details

/settrustline

Implement a trustline between issuer and distributor.

POST https://api.expand.network/rwa/settrustline

Request Body

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
from*	String	Public address of the distributor of asset.
amount*	String	The amount of asset to set trustline for.
issuer*	String	Public address of the issuer of the asset.
assetCode*	String	The code of asset to set trustline for.

Sample Request

{
    "chainId": "1600",
    "issuer": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
    "assetCode": "USD",
    "amount": "100",
    "from": "rogue5HnPRSszD9CWGSUz8UGHMVwSSKF6"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1600",
        "from": "rogue5HnPRSszD9CWGSUz8UGHMVwSSKF6",
        "fee": "12",
        "data": "eyJUcmFuc2FjdGlvblR5cGUiOiJUcnVzdFNldCIsIkFjY291bnQiOiJyb2d1ZTVIblBSU3N6RDlDV0dTVXo4VUdITVZ3U1NLRjYiLCJMaW1pdEFtb3VudCI6eyJjdXJyZW5jeSI6IlVTRCIsImlzc3VlciI6InJycE5uTkxLcmFydHVFcWZKR3BxeUR3UGoxQUZQZzl2bjEiLCJ2YWx1ZSI6IjAuMDAwMDAwMDAwMDAwMTAwIn0sIkZsYWdzIjowLCJGZWUiOiIxMiIsIlNlcXVlbmNlIjo1NTAwOTAwLCJMYXN0TGVkZ2VyU2VxdWVuY2UiOjg5NTE4MDU0fQ==",
        "referenceId": "bf64f21786364fe4b40687b1b1ea0226"
    }
}

back to top

/issue

Executes a payment operation to issue an asset (excluding XRP) to the distributor.

POST https://api.expand.network/rwa/issue

Request Body

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
issuer*	String	Public address of the issuer of the asset.
assetCode*	String	The code of asset to be issued.
amount*	String	The amount at asset to be issued.
to*	String	The public address of the distributor.
destinationTag	String

Sample Request

{
    "chainId": "1600",
    "to": "rogue5HnPRSszD9CWGSUz8UGHMVwSSKF6",
    "amount": "1000000",
    "assetCode": "USD",
    "issuer": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
    "destinationTag": "10"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1600",
        "from": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
        "fee": "12",
        "data": "eyJUcmFuc2FjdGlvblR5cGUiOiJQYXltZW50IiwiQWNjb3VudCI6InJycE5uTkxLcmFydHVFcWZKR3BxeUR3UGoxQUZQZzl2bjEiLCJBbW91bnQiOnsiY3VycmVuY3kiOiJVU0QiLCJ2YWx1ZSI6IjAuMDAwMDAwMDAxMDAwMDAwIiwiaXNzdWVyIjoicnJwTm5OTEtyYXJ0dUVxZkpHcHF5RHdQajFBRlBnOXZuMSJ9LCJEZXN0aW5hdGlvbiI6InJvZ3VlNUhuUFJTc3pEOUNXR1NVejhVR0hNVndTU0tGNiIsIkZsYWdzIjowLCJGZWUiOiIxMiIsIlNlcXVlbmNlIjo2MDMwMCwiTGFzdExlZGdlclNlcXVlbmNlIjo4OTUxODA4NX0=",
        "referenceId": "7b47c87345334b79837d013b55b37e41"
    }
}

back to top

/transfer

Trigger a payment operation to send an amount in a specific asset (XLM or non-XLM) to a destination account.

POST https://api.expand.network/rwa/transfer

Request Body

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
from*	String	Public address of sender of asset.
to*	String	Public address of the receiver of the asset.
amount*	String	Amount of asset to transfer.
issuer*	String	Public address of the issuer of the asset.
assetCode*	String	The code of the asset to transfer.

Sample Request

{
    "chainId": "1600",
    "from": "rogue5HnPRSszD9CWGSUz8UGHMVwSSKF6",
    "to": "r3KFdr7FTU1hxo9DbS1h65Wq8MXG7e9cgK",
    "amount": "100000",
    "assetCode": "USD",
    "issuer":"rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1600",
        "from": "rogue5HnPRSszD9CWGSUz8UGHMVwSSKF6",
        "to": "r3KFdr7FTU1hxo9DbS1h65Wq8MXG7e9cgK",
        "fee": "12",
        "data": "eyJUcmFuc2FjdGlvblR5cGUiOiJQYXltZW50IiwiQWNjb3VudCI6InJycE5uTkxLcmFydHVFcWZKR3BxeUR3UGoxQUZQZzl2bjEiLCJBbW91bnQiOnsiY3VycmVuY3kiOiJVU0QiLCJ2YWx1ZSI6IjAuMDAwMDAwMDAwMTAwMDAwIiwiaXNzdWVyIjoicnJwTm5OTEtyYXJ0dUVxZkpHcHF5RHdQajFBRlBnOXZuMSJ9LCJEZXN0aW5hdGlvbiI6InIzS0ZkcjdGVFUxaHhvOURiUzFoNjVXcThNWEc3ZTljZ0siLCJGbGFncyI6MCwiRmVlIjoiMTIiLCJTZXF1ZW5jZSI6NjAzMDAsIkxhc3RMZWRnZXJTZXF1ZW5jZSI6ODk1MTgxMDh9",
        "referenceId": "b30e2a560ae64ad6bb50e0f1929cf66c"
    }
}

back to top

/burn

Executes a transaction to burn or delete an asset.

POST https://api.expand.network/rwa/burn

Request Body

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
from*	String	Public address of the distributor of asset.
amount*	String	The amount of asset to burn
issuer*	String	Public address of the issuer of the asset.
assetCode*	String	The code of asset to burn

Sample Request

{
    "chainId": "1600",
    "issuer": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
    "assetCode": "USD",
    "amount": "10000",
    "from": "rogue5HnPRSszD9CWGSUz8UGHMVwSSKF6"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1600",
        "from": "rogue5HnPRSszD9CWGSUz8UGHMVwSSKF6",
        "fee": "12",
        "data": "eyJUcmFuc2FjdGlvblR5cGUiOiJQYXltZW50IiwiQWNjb3VudCI6InJvZ3VlNUhuUFJTc3pEOUNXR1NVejhVR0hNVndTU0tGNiIsIkFtb3VudCI6eyJjdXJyZW5jeSI6IlVTRCIsInZhbHVlIjoiMC4wMDAwMDAwMDAwMTAwMDAiLCJpc3N1ZXIiOiJycnBObk5MS3JhcnR1RXFmSkdwcXlEd1BqMUFGUGc5dm4xIn0sIkRlc3RpbmF0aW9uIjoicnJwTm5OTEtyYXJ0dUVxZkpHcHF5RHdQajFBRlBnOXZuMSIsIkZsYWdzIjowLCJGZWUiOiIxMiIsIlNlcXVlbmNlIjo1NTAwOTAwLCJMYXN0TGVkZ2VyU2VxdWVuY2UiOjg5NTE4MTI0fQ==",
        "referenceId": "d1f18b73e93e40a580abdd6bcb07cfde"
    }
}

back to top

/freeze

Executes a transaction to revoke an existing trustline’s authorization, thereby freezing the asset held by an account.

POST https://api.expand.network/rwa/freeze

Request Body

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
user*	String	Public address of user to be freezed.
issuer*	String	Public address of the issuer of the asset.
assetCode*	String	The code of the asset to freeze

Sample Request

{
    "chainId": "1600",
    "issuer": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
    "assetCode": "USD",
    "amount": "10000",
    "user": "rogue5HnPRSszD9CWGSUz8UGHMVwSSKF6"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1600",
        "from": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
        "fee": "12",
        "data": "eyJUcmFuc2FjdGlvblR5cGUiOiJUcnVzdFNldCIsIkFjY291bnQiOiJycnBObk5MS3JhcnR1RXFmSkdwcXlEd1BqMUFGUGc5dm4xIiwiTGltaXRBbW91bnQiOnsidmFsdWUiOiIwLjAwMDAwMDAwMDAxMDAwMCIsImN1cnJlbmN5IjoiVVNEIiwiaXNzdWVyIjoicm9ndWU1SG5QUlNzekQ5Q1dHU1V6OFVHSE1Wd1NTS0Y2In0sIkZsYWdzIjoxMDQ4NTc2LCJGZWUiOiIxMiIsIlNlcXVlbmNlIjo2MDMwMCwiTGFzdExlZGdlclNlcXVlbmNlIjo4OTUxODEzNX0=",
        "referenceId": "c71ff35024f3435f8262c858c117cb5a"
    }
}

back to top

Error Handling Details

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

back to top