Create a trustline

Creates a trustline so a wallet can hold an asset, or updates the limit on an existing one. Networks that use trustlines, such as Stellar and XRPL, require one before AUDD can be sent to the wallet.

The wallet must be ACTIVE and on the same network as the asset. Posting a limit identical to the current one returns the existing trustline unchanged.

How quickly the trustline becomes usable depends on the network. Some return status ACTIVE straight away with a null transactionId; others return PENDING or UPDATING together with a transactionId you can follow using GET /transactions/{id}. Poll GET /assets/{id}/trustlines until status is ACTIVE.

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

Id of the asset the wallet should be able to hold, from GET /assets.

string
required

Id of the registered wallet that will hold the asset, from GET /wallets. It must be ACTIVE and on the same network as the asset.

number
required

Maximum amount of the asset the wallet is willing to hold. Up to 12 digits before the decimal point and 7 after. A new trustline must be created with a limit above zero, and the limit on an existing trustline cannot be lowered below the amount the wallet already holds.

Headers
string
required

Bearer JWT obtained from POST /mfa/login. Send as "Bearer ". Expires after 5 minutes.

Responses
200

Success

400

Invalid request. Returned when the body fails validation, when assetId or sourceId does not exist, when the wallet is not active or sits on a different network from the asset, or when the limit is outside the permitted range.

401

Unauthorized

403

Forbidden. The wallet or the asset does not belong to your company.

500

Internal server error

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here!