Stellar Tokens

Stellar Tokens

Stellar tokens can be accessed with the following coin types:

Environment	Coin Type	Code	Issuer Website
Stellar Mainnet	xlm:AQUA-GBNZILSTVQZ4R7IKQDGHYGY2QXL5QOFJYQMXPKWRRM5PAV7Y4M67AQUA	AQUA	aqua.network
Stellar Mainnet	xlm:VELO-GDM4RQUQQUVSKQA7S6EM7XBZP3FCGH4Q7CL6TABQ7B2BEJ5ERARM2M5M	VELO	velo.org
Stellar Mainnet	xlm:SLT-GCKA6K5PCQ6PNF5RQBF7PQDJWRHO6UOGFMRLK3DYHDOI244V47XKQ4GP	SLT	slt.finance
Stellar Mainnet	xlm:USD-GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX	USD	tryanchor.com
Stellar Mainnet	xlm:ETH-GBVOL67TMUQBGL4TZYNMY3ZQ5WGQYFPFD5VJRWXR72VA33VFNL225PL5	ETH	stellarport.io
Stellar Mainnet	xlm:WXT-GASBLVHS5FOABSDNW5SPPH3QRJYXY5JHA2AOA2QHH2FJLZBRXSG4SWXT	WXT	wirexapp.com
Stellar Mainnet	xlm:USDC-GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN	USDC	centre.io
Stellar Mainnet	xlm:SIX-GDMS6EECOH6MBMCP3FYRYEVRBIV3TQGLOFQIPVAITBRJUMTI6V7A2X6Z	SIX	six.network
Stellar Mainnet	xlm:ARST-GCSAZVWXZKWS4XS223M5F54H2B6XPIIXZZGP7KEAIU6YSL5HDRGCI3DG	ARST
Stellar Mainnet	xlm:BRLT-GCHQ3F2BF5P74DMDNOOGHT5DUCKC773AW5DTOFINC26W4KGYFPYDPRSO	BRLT
Stellar Mainnet	xlm:GYEN-GDF6VOEGRWLOZ64PQQGKD2IYWA22RLT37GJKS2EJXZHT2VLAGWLC5TOB	GYEN	stablecoin.z
Stellar Mainnet	xlm:USDM1-GDM5QWWXCMDTQMZAKMYTCI52LA7FWBHAZMU5NJLMIFHDJISJRP2ZWPKC	USDM1
Stellar Mainnet	xlm:ZUSD-GDF6VOEGRWLOZ64PQQGKD2IYWA22RLT37GJKS2EJXZHT2VLAGWLC5TOB	ZUSD	stablecoin.z
Stellar Mainnet	xlm:EURS-GC5FGCDEOGOGSNWCCNKS3OMEVDHTE3Q5A5FEQWQKV3AXA7N6KDQ2CUZJ	EURS
Stellar Mainnet	xlm:VEUR-GDXLSLCOPPHTWOQXLLKSVN4VN3G67WD2ENU7UMVAROEYVJLSPSEWXIZN	VEUR	vnx.li
Stellar Mainnet	xlm:VCHF-GDXLSLCOPPHTWOQXLLKSVN4VN3G67WD2ENU7UMVAROEYVJLSPSEWXIZN	VCHF	vnx.li
Stellar Mainnet	xlm:AUDD-GDC7X2MXTYSAKUUGAIQ7J7RPEIM7GXSAIWFYWWH4GLNFECQVJJLB2EEU	AUDD	audd.digital
Stellar Testnet	txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L	BST

Wallet features

Stellar wallets store Stellar tokens. As a result certain wallet features 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 must use xlm or txlm as the coin since that is the actual coin type in use. 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 by Coin and ID
2. List Wallets
3. List Pending Approvals
4. List Wallet Webhooks
5. List Transfers
6. Add Wallet Webhook

Wallet trust lines (trusted tokens)

The receiving wallet must trust Stellar tokens on-chain by sending a trustline transaction to authorize holding the token.

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

For custody wallets, contact 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 by Coin and ID 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 you send and XLM (Lumens) paid in transaction fees. For this reason, BitGo generates 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, BitGo creates a generic webhook that triggers on all Stellar token and XLM transactions. It sends an http request to your webhook URL and specifies 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 need to get the transfer details using the token name and transfer id. For the preceding transfer you'd need to call the Get Transfer route to check the amount transferred and other details (for example, /api/v2/txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L/wallet/5a13adcab70f2c284fdd9682db5e6d64/transfer/5b612d25c9067f2a1db11a15f165989e).