Create / Update / Delete XRP trust line

/v3/xrp/trust

10 credits per API call.


Create / Update / Delete XRP trust line between accounts to transfer private assets. By creating trustline for the first time, the asset is created automatically and can be used in the transactions.
Account setting rippling must be enabled on the issuer account before the trust line creation to asset work correctly. Creating a trust line will cause an additional 5 XRP to be blocked on the account.

This operation needs the private key of the blockchain address. Every time the funds are transferred, the transaction must be signed with the corresponding private key. No one should ever send it's own private keys to the internet because there is a strong possibility of stealing keys and loss of funds. In this method, it is possible to enter privateKey or signatureId. PrivateKey should be used only for quick development on testnet versions of blockchain when there is no risk of losing funds. In production, Tatum KMS should be used for the highest security standards, and signatureId should be present in the request. Alternatively, using the Tatum client library for supported languages.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length between 33 and 34

XRP account address. Must be the one used for generating deposit tags.

string
required
length between 33 and 34

Blockchain address of the issuer of the assets to create trust line for.

string
required

Amount of the assets to be permitted to send over this trust line. 0 means deletion of the trust line.

string
required
length between 40 and 40

Asset name. Must be 160bit HEX string, e.g. SHA1.

string
required
length between 29 and 100

Secret for account. Secret, or signature Id must be present.

string

Fee to be paid, in XRP. If omitted, current fee will be calculated.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json