# Stellar Tokens

Source: https://developers.bitgo.com/docs/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 | <a href="https://aqua.network" target="_blank" rel="noreferrer">aqua.network</a>               |
| Stellar Mainnet | xlm:VELO-GDM4RQUQQUVSKQA7S6EM7XBZP3FCGH4Q7CL6TABQ7B2BEJ5ERARM2M5M | VELO | <a href="https://velo.org" target="_blank" rel="noreferrer">velo.org</a>                       |
| Stellar Mainnet | xlm:SLT-GCKA6K5PCQ6PNF5RQBF7PQDJWRHO6UOGFMRLK3DYHDOI244V47XKQ4GP  | SLT  | <a href="https://slt.finance/" target="_blank" rel="noreferrer">slt.finance</a>             |
| Stellar Mainnet | xlm:USD-GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX  | USD  | <a href="https://www.tryanchor.com" target="_blank" rel="noreferrer">tryanchor.com</a>         |
| Stellar Mainnet | xlm:ETH-GBVOL67TMUQBGL4TZYNMY3ZQ5WGQYFPFD5VJRWXR72VA33VFNL225PL5  | ETH  | <a href="https://stellarport.io" target="_blank" rel="noreferrer">stellarport.io</a>           |
| Stellar Mainnet | xlm:WXT-GASBLVHS5FOABSDNW5SPPH3QRJYXY5JHA2AOA2QHH2FJLZBRXSG4SWXT  | WXT  | <a href="https://www.wirexapp.com/" target="_blank" rel="noreferrer">wirexapp.com</a>           |
| Stellar Mainnet | xlm:USDC-GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN | USDC | <a href="https://www.centre.io/" target="_blank" rel="noreferrer">centre.io</a>                |
| Stellar Mainnet | xlm:SIX-GDMS6EECOH6MBMCP3FYRYEVRBIV3TQGLOFQIPVAITBRJUMTI6V7A2X6Z  | SIX  | <a href="https://six.network/" target="_blank" rel="noreferrer">six.network</a>                |
| Stellar Mainnet | xlm:ARST-GCSAZVWXZKWS4XS223M5F54H2B6XPIIXZZGP7KEAIU6YSL5HDRGCI3DG | ARST |                                                                                                 |
| Stellar Mainnet | xlm:BRLT-GCHQ3F2BF5P74DMDNOOGHT5DUCKC773AW5DTOFINC26W4KGYFPYDPRSO | BRLT |                                                                                                 |
| Stellar Mainnet | xlm:GYEN-GDF6VOEGRWLOZ64PQQGKD2IYWA22RLT37GJKS2EJXZHT2VLAGWLC5TOB | GYEN | <a href="https://stablecoin.z.com" target="_blank" rel="noreferrer">stablecoin.z</a> |
| Stellar Mainnet | xlm:USDM1-GDM5QWWXCMDTQMZAKMYTCI52LA7FWBHAZMU5NJLMIFHDJISJRP2ZWPKC | USDM1 |                                                                                                |
| Stellar Mainnet | xlm:ZUSD-GDF6VOEGRWLOZ64PQQGKD2IYWA22RLT37GJKS2EJXZHT2VLAGWLC5TOB | ZUSD | <a href="https://stablecoin.z.com" target="_blank" rel="noreferrer">stablecoin.z</a> |
| Stellar Mainnet | xlm:EURS-GC5FGCDEOGOGSNWCCNKS3OMEVDHTE3Q5A5FEQWQKV3AXA7N6KDQ2CUZJ | EURS |  |
| Stellar Mainnet | xlm:VEUR-GDXLSLCOPPHTWOQXLLKSVN4VN3G67WD2ENU7UMVAROEYVJLSPSEWXIZN | VEUR | <a href="https://vnx.li" target="_blank" rel="noreferrer">vnx.li</a> |
| Stellar Mainnet | xlm:VCHF-GDXLSLCOPPHTWOQXLLKSVN4VN3G67WD2ENU7UMVAROEYVJLSPSEWXIZN | VCHF | <a href="https://vnx.li" target="_blank" rel="noreferrer">vnx.li</a> |
| Stellar Mainnet | xlm:AUDD-GDC7X2MXTYSAKUUGAIQ7J7RPEIM7GXSAIWFYWWH4GLNFECQVJJLB2EEU | AUDD | <a href="https://audd.digital" target="_blank" rel="noreferrer">audd.digital</a> |
| 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](/reference/v2walletget)
2.  [List Wallets](/reference/v2walletlist)
3.  [List Pending Approvals](/reference/v2approvallist)
4.  [List Wallet Webhooks](/reference/v2walletlistwebhooks)
5.  [List Transfers](/reference/v2walletlisttransfers)
6.  [Add Wallet Webhook](/reference/v2walletaddwebhook)

### Wallet trust lines (trusted tokens)

The receiving wallet must trust Stellar tokens on-chain by sending a <a href="https://developers.stellar.org/docs/learn/fundamentals/stellar-data-structures/accounts#trustlines" target="_blank" rel="noreferrer">trustline</a> transaction to authorize holding the token.

For self-custody wallets, use [Build transaction](/reference/v2wallettxbuild) and
[Send half-signed transaction](/reference/v2wallettxsend) with the `type` and `trustlines` parameters.

For custody wallets, contact [support@bitgo.com](mailto: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 (<code>10<sup> </sup>7</code>). To view token balances, call
[Get Wallet by Coin and ID](/reference/v2walletget) 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](/reference/v2walletgettransfer) route to
check the amount transferred and other details (for example,
`/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.
