Stellar Tokens

Stellar Tokens

Stellar tokens can be accessed with the following coin types:

EnvironmentCoin TypeCodeIssuer Website
Stellar Mainnetxlm:AQUA-GBNZILSTVQZ4R7IKQDGHYGY2QXL5QOFJYQMXPKWRRM5PAV7Y4M67AQUAAQUAaqua.network
Stellar Testnettxlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644LBST
Stellar Mainnetxlm:VELO-GDM4RQUQQUVSKQA7S6EM7XBZP3FCGH4Q7CL6TABQ7B2BEJ5ERARM2M5MVELOvelo.org
Stellar Mainnetxlm:SLT-GCKA6K5PCQ6PNF5RQBF7PQDJWRHO6UOGFMRLK3DYHDOI244V47XKQ4GPSLTsmartlands.io
Stellar Mainnetxlm:USD-GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEXUSDanchorusd.com
Stellar Mainnetxlm:ETH-GBVOL67TMUQBGL4TZYNMY3ZQ5WGQYFPFD5VJRWXR72VA33VFNL225PL5ETHstellarport.io
Stellar Mainnetxlm:WXT-GASBLVHS5FOABSDNW5SPPH3QRJYXY5JHA2AOA2QHH2FJLZBRXSG4SWXTWXTwxt.wirexapp.com
Stellar Mainnetxlm:USDC-GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVNUSDCcentre.io
Stellar Mainnetxlm:SIX-GDMS6EECOH6MBMCP3FYRYEVRBIV3TQGLOFQIPVAITBRJUMTI6V7A2X6ZSIXsix.network
Stellar Mainnetxlm:ARST-GCSAZVWXZKWS4XS223M5F54H2B6XPIIXZZGP7KEAIU6YSL5HDRGCI3DGARSTanchors.stablex.org
Stellar Mainnetxlm:BRLT-GCHQ3F2BF5P74DMDNOOGHT5DUCKC773AW5DTOFINC26W4KGYFPYDPRSOBRLTanchors.stablex.org

Wallet functionality

Stellar tokens are stored in Stellar wallets. As a result certain wallet functionality available to other coins is not available to supported tokens. It is not possible to create wallets, create/list/get receive addresses, or share wallets for Stellar tokens. All these functions will have to be done with the coin set to xlm or txlm since that is the actual coin type being used. In order to retrieve all token details associated with a Stellar wallet, such as balance, pending approvals, policies, and webhooks, set the "allTokens" parameter to true with the following calls:

  1. Get Wallet
  2. List Wallets
  3. List Pending Approvals
  4. List Wallet Webhooks
  5. List Transfers
  6. Add Wallet Webhook

Wallet trust lines (trusted tokens)

Stellar tokens must be "trusted" on-chain by sending a

trustline

transaction from the receiving wallet authorizing holding the token.

For self-managed wallets, use Build transaction and Send half-signed transaction with the type and trustlines parameters.

For custodial wallets, contact us at support@bitgo.com.

Keychains

Stellar tokens do not have a direct association with keys or keychains. Instead, all tokens share the same keys/keychains which belong to the Stellar wallet.

Balances

Stellar tokens share the same precision as Lumen (10 7). To view token balances, call Get Wallet with expandBalance=true and allTokens=true:

{{baseUrl}}/api/v2/xlm/wallet/{walletId}}?expandBalance=true&allTokens=true

Transactions

Stellar token transactions spend two types of assets: the token itself being sent and XLM (Lumens) paid in transaction fees. For this reason, BitGo will generate two transfers on the sending wallet with the same txid to track changes in both balances.

Stellar Tokens Webhooks

By setting the "allTokens" parameter to true, a generic webhook is created which will trigger on all Stellar token and XLM transactions. It will send an http request to your webhook url and specify whether it is Stellar or a token using the field "coin". Here's an example response for a test token called "txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L".

{
    "hash":"26683ffb83b86f29c9c0ccd14e8cbebf17fa903dab286320b3ef2e36f5d9a924",
    "transfer":"5b612d25c9067f2a1db11a15f165989e",
    "coin":"txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L",
    "type":"transfer",
    "state":"confirmed",
    "wallet":"5a13adcab70f2c284fdd9682db5e6d64"
}

To get additional details about this transfer, you will then need to get the transfer details using the token name and transfer id. For the above transfer you'd need to call the Get Transfer route to check the amount transferred and other details (e.g. /api/v2/txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L/wallet/5a13adcab70f2c284fdd9682db5e6d64/transfer/5b612d25c9067f2a1db11a15f165989e).

Note: A transaction that sends both XLM and a Stellar token will cause one webhook notification for each asset.