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 Testnet | txlm:BST-GBQTIOS3XGHB7LVYGBKQVJGCZ3R4JL5E4CBSWJ5ALIJUHBKS6263644L | BST | |
| 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 | 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 | anchors.stablex.org |
| Stellar Mainnet | xlm:BRLT-GCHQ3F2BF5P74DMDNOOGHT5DUCKC773AW5DTOFINC26W4KGYFPYDPRSO | BRLT | anchors.stablex.org |
| Stellar Mainnet | xlm:GYEN-GDF6VOEGRWLOZ64PQQGKD2IYWA22RLT37GJKS2EJXZHT2VLAGWLC5TOB | GYEN | stablecoin.z |
| Stellar Mainnet | xlm:ZUSD-GDF6VOEGRWLOZ64PQQGKD2IYWA22RLT37GJKS2EJXZHT2VLAGWLC5TOB | ZUSD | stablecoin.z |
| Stellar Mainnet | xlm:EURS-GC5FGCDEOGOGSNWCCNKS3OMEVDHTE3Q5A5FEQWQKV3AXA7N6KDQ2CUZJ | EURS | stasis.net |
| Stellar Mainnet | xlm:VEUR-GDXLSLCOPPHTWOQXLLKSVN4VN3G67WD2ENU7UMVAROEYVJLSPSEWXIZN | VEUR | vnx.li |
| Stellar Mainnet | xlm:VCHF-GDXLSLCOPPHTWOQXLLKSVN4VN3G67WD2ENU7UMVAROEYVJLSPSEWXIZN | VCHF | vnx.li |
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:
- Get Wallet
- List Wallets
- List Pending Approvals
- List Wallet Webhooks
- List Transfers
- 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.