> For the complete documentation index, see [llms.txt](https://docs.terragon.io/documents/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.terragon.io/documents/terragon-api-document/wallet.md).

# Wallet

Player wallet operations

## Get vault wallets

> Retrieve player's vault wallets

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"Wallet","description":"Player wallet operations"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/v1/vault-wallets":{"get":{"tags":["Wallet"],"summary":"Get vault wallets","description":"Retrieve player's vault wallets","operationId":"getVaultWallets","responses":{"200":{"description":"Vault wallets retrieved successfully","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"player_id":{"type":"integer"},"currency_id":{"type":"integer"},"balance":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"currency":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"code":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer"}}}}}}}}}}}}}}
```

## Get player wallets

> Retrieve all wallets for the current player

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"Wallet","description":"Player wallet operations"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PlayerWallet":{"type":"object","properties":{"type":{"type":"integer","description":"Wallet type ID"},"type_name":{"type":"string","description":"Wallet type name"},"type_constant":{"type":"string","description":"Wallet type constant"},"activated":{"type":"integer","description":"Whether the wallet is activated (1 = active, 0 = inactive)"},"balance":{"type":"string","description":"Wallet balance with formatting"},"total_main_bonus_balance":{"type":"string","description":"Total main bonus balance with formatting"},"total_bonus_balance":{"type":"string","description":"Total bonus balance with formatting"},"total_bonus_locked_balance":{"type":"string","description":"Total bonus locked balance with formatting"},"total_bonus_locked_bonus_balance":{"type":"string","description":"Total bonus locked bonus balance with formatting"},"total_withdraw_balance":{"type":"string","description":"Total withdrawable balance with formatting"},"total_locked_balance":{"type":"string","description":"Total locked balance with formatting"},"total_main_bonus_locked_balance":{"type":"string","description":"Total main bonus locked balance with formatting"},"total_main_bonus_locked_bonus_balance":{"type":"string","description":"Total main bonus locked bonus balance with formatting"},"total_balance":{"type":"string","description":"Total balance with formatting"},"game_provider":{"type":"string","nullable":true,"description":"Game provider (if associated with a specific provider)"},"activated_betting_from_main":{"type":"boolean","description":"Whether betting from main wallet is activated"},"currency":{"type":"object","properties":{"name":{"type":"string","description":"Currency name"},"code":{"type":"string","description":"Currency code"},"symbol":{"type":"string","description":"Currency symbol"},"decimals":{"type":"integer","description":"Number of decimal places"},"order":{"type":"integer","description":"Display order"},"type":{"type":"integer","description":"Currency type ID"},"type_name":{"type":"string","description":"Currency type name"},"is_default":{"type":"integer","description":"Whether this is the default currency (1 = default, 0 = not default)"}}},"converted":{"type":"object","description":"Balance converted to default currency","properties":{"balance":{"type":"string","description":"Converted balance with formatting"},"total_main_bonus_balance":{"type":"string","description":"Converted total main bonus balance with formatting"},"total_bonus_balance":{"type":"string","description":"Converted total bonus balance with formatting"},"total_withdraw_balance":{"type":"string","description":"Converted total withdrawable balance with formatting"},"total_locked_balance":{"type":"string","description":"Converted total locked balance with formatting"},"total_balance":{"type":"string","description":"Converted total balance with formatting"},"total_balance_in_float":{"type":"number","format":"float","description":"Converted total balance as float"},"total_main_bonus_balance_in_float":{"type":"number","format":"float","description":"Converted total main bonus balance as float"},"total_bonus_locked_balance":{"type":"string","description":"Converted total bonus locked balance with formatting"},"total_bonus_locked_bonus_balance":{"type":"string","description":"Converted total bonus locked bonus balance with formatting"},"total_main_bonus_locked_balance":{"type":"string","description":"Converted total main bonus locked balance with formatting"},"total_main_bonus_locked_bonus_balance":{"type":"string","description":"Converted total main bonus locked bonus balance with formatting"},"currency":{"type":"object","properties":{"name":{"type":"string","description":"Currency name"},"code":{"type":"string","description":"Currency code"},"symbol":{"type":"string","description":"Currency symbol"},"decimals":{"type":"integer","description":"Number of decimal places"},"order":{"type":"integer","description":"Display order"},"type":{"type":"integer","description":"Currency type ID"},"type_name":{"type":"string","description":"Currency type name"},"is_default":{"type":"integer","description":"Whether this is the default currency (1 = default, 0 = not default)"}}}}}}},"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}}}},"paths":{"/v1/wallets":{"get":{"tags":["Wallet"],"summary":"Get player wallets","description":"Retrieve all wallets for the current player","operationId":"getPlayerWallets","responses":{"200":{"description":"Player wallets retrieved successfully","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlayerWallet"}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Activate wallet

> Activate a wallet for a specific currency

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"Wallet","description":"Player wallet operations"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PlayerWallet":{"type":"object","properties":{"type":{"type":"integer","description":"Wallet type ID"},"type_name":{"type":"string","description":"Wallet type name"},"type_constant":{"type":"string","description":"Wallet type constant"},"activated":{"type":"integer","description":"Whether the wallet is activated (1 = active, 0 = inactive)"},"balance":{"type":"string","description":"Wallet balance with formatting"},"total_main_bonus_balance":{"type":"string","description":"Total main bonus balance with formatting"},"total_bonus_balance":{"type":"string","description":"Total bonus balance with formatting"},"total_bonus_locked_balance":{"type":"string","description":"Total bonus locked balance with formatting"},"total_bonus_locked_bonus_balance":{"type":"string","description":"Total bonus locked bonus balance with formatting"},"total_withdraw_balance":{"type":"string","description":"Total withdrawable balance with formatting"},"total_locked_balance":{"type":"string","description":"Total locked balance with formatting"},"total_main_bonus_locked_balance":{"type":"string","description":"Total main bonus locked balance with formatting"},"total_main_bonus_locked_bonus_balance":{"type":"string","description":"Total main bonus locked bonus balance with formatting"},"total_balance":{"type":"string","description":"Total balance with formatting"},"game_provider":{"type":"string","nullable":true,"description":"Game provider (if associated with a specific provider)"},"activated_betting_from_main":{"type":"boolean","description":"Whether betting from main wallet is activated"},"currency":{"type":"object","properties":{"name":{"type":"string","description":"Currency name"},"code":{"type":"string","description":"Currency code"},"symbol":{"type":"string","description":"Currency symbol"},"decimals":{"type":"integer","description":"Number of decimal places"},"order":{"type":"integer","description":"Display order"},"type":{"type":"integer","description":"Currency type ID"},"type_name":{"type":"string","description":"Currency type name"},"is_default":{"type":"integer","description":"Whether this is the default currency (1 = default, 0 = not default)"}}},"converted":{"type":"object","description":"Balance converted to default currency","properties":{"balance":{"type":"string","description":"Converted balance with formatting"},"total_main_bonus_balance":{"type":"string","description":"Converted total main bonus balance with formatting"},"total_bonus_balance":{"type":"string","description":"Converted total bonus balance with formatting"},"total_withdraw_balance":{"type":"string","description":"Converted total withdrawable balance with formatting"},"total_locked_balance":{"type":"string","description":"Converted total locked balance with formatting"},"total_balance":{"type":"string","description":"Converted total balance with formatting"},"total_balance_in_float":{"type":"number","format":"float","description":"Converted total balance as float"},"total_main_bonus_balance_in_float":{"type":"number","format":"float","description":"Converted total main bonus balance as float"},"total_bonus_locked_balance":{"type":"string","description":"Converted total bonus locked balance with formatting"},"total_bonus_locked_bonus_balance":{"type":"string","description":"Converted total bonus locked bonus balance with formatting"},"total_main_bonus_locked_balance":{"type":"string","description":"Converted total main bonus locked balance with formatting"},"total_main_bonus_locked_bonus_balance":{"type":"string","description":"Converted total main bonus locked bonus balance with formatting"},"currency":{"type":"object","properties":{"name":{"type":"string","description":"Currency name"},"code":{"type":"string","description":"Currency code"},"symbol":{"type":"string","description":"Currency symbol"},"decimals":{"type":"integer","description":"Number of decimal places"},"order":{"type":"integer","description":"Display order"},"type":{"type":"integer","description":"Currency type ID"},"type_name":{"type":"string","description":"Currency type name"},"is_default":{"type":"integer","description":"Whether this is the default currency (1 = default, 0 = not default)"}}}}}}},"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}}}},"paths":{"/v1/wallets/{currencyCode}/activate":{"put":{"tags":["Wallet"],"summary":"Activate wallet","description":"Activate a wallet for a specific currency","operationId":"activateWallet","parameters":[{"name":"currencyCode","in":"path","required":true,"description":"Currency code","schema":{"type":"string"}}],"responses":{"200":{"description":"Wallet activated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlayerWallet"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Currency not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Mark main wallet as betting wallet

> Set the main wallet as the betting wallet

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"Wallet","description":"Player wallet operations"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PlayerWallet":{"type":"object","properties":{"type":{"type":"integer","description":"Wallet type ID"},"type_name":{"type":"string","description":"Wallet type name"},"type_constant":{"type":"string","description":"Wallet type constant"},"activated":{"type":"integer","description":"Whether the wallet is activated (1 = active, 0 = inactive)"},"balance":{"type":"string","description":"Wallet balance with formatting"},"total_main_bonus_balance":{"type":"string","description":"Total main bonus balance with formatting"},"total_bonus_balance":{"type":"string","description":"Total bonus balance with formatting"},"total_bonus_locked_balance":{"type":"string","description":"Total bonus locked balance with formatting"},"total_bonus_locked_bonus_balance":{"type":"string","description":"Total bonus locked bonus balance with formatting"},"total_withdraw_balance":{"type":"string","description":"Total withdrawable balance with formatting"},"total_locked_balance":{"type":"string","description":"Total locked balance with formatting"},"total_main_bonus_locked_balance":{"type":"string","description":"Total main bonus locked balance with formatting"},"total_main_bonus_locked_bonus_balance":{"type":"string","description":"Total main bonus locked bonus balance with formatting"},"total_balance":{"type":"string","description":"Total balance with formatting"},"game_provider":{"type":"string","nullable":true,"description":"Game provider (if associated with a specific provider)"},"activated_betting_from_main":{"type":"boolean","description":"Whether betting from main wallet is activated"},"currency":{"type":"object","properties":{"name":{"type":"string","description":"Currency name"},"code":{"type":"string","description":"Currency code"},"symbol":{"type":"string","description":"Currency symbol"},"decimals":{"type":"integer","description":"Number of decimal places"},"order":{"type":"integer","description":"Display order"},"type":{"type":"integer","description":"Currency type ID"},"type_name":{"type":"string","description":"Currency type name"},"is_default":{"type":"integer","description":"Whether this is the default currency (1 = default, 0 = not default)"}}},"converted":{"type":"object","description":"Balance converted to default currency","properties":{"balance":{"type":"string","description":"Converted balance with formatting"},"total_main_bonus_balance":{"type":"string","description":"Converted total main bonus balance with formatting"},"total_bonus_balance":{"type":"string","description":"Converted total bonus balance with formatting"},"total_withdraw_balance":{"type":"string","description":"Converted total withdrawable balance with formatting"},"total_locked_balance":{"type":"string","description":"Converted total locked balance with formatting"},"total_balance":{"type":"string","description":"Converted total balance with formatting"},"total_balance_in_float":{"type":"number","format":"float","description":"Converted total balance as float"},"total_main_bonus_balance_in_float":{"type":"number","format":"float","description":"Converted total main bonus balance as float"},"total_bonus_locked_balance":{"type":"string","description":"Converted total bonus locked balance with formatting"},"total_bonus_locked_bonus_balance":{"type":"string","description":"Converted total bonus locked bonus balance with formatting"},"total_main_bonus_locked_balance":{"type":"string","description":"Converted total main bonus locked balance with formatting"},"total_main_bonus_locked_bonus_balance":{"type":"string","description":"Converted total main bonus locked bonus balance with formatting"},"currency":{"type":"object","properties":{"name":{"type":"string","description":"Currency name"},"code":{"type":"string","description":"Currency code"},"symbol":{"type":"string","description":"Currency symbol"},"decimals":{"type":"integer","description":"Number of decimal places"},"order":{"type":"integer","description":"Display order"},"type":{"type":"integer","description":"Currency type ID"},"type_name":{"type":"string","description":"Currency type name"},"is_default":{"type":"integer","description":"Whether this is the default currency (1 = default, 0 = not default)"}}}}}}},"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}}}},"paths":{"/v1/wallets/mark-main-as-betting-wallet":{"put":{"tags":["Wallet"],"summary":"Mark main wallet as betting wallet","description":"Set the main wallet as the betting wallet","operationId":"markMainAsBettingWallet","responses":{"200":{"description":"Main wallet marked as betting wallet successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlayerWallet"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Transfer funds into vault wallet

> Transfer funds from main wallet to vault wallet

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"Wallet","description":"Player wallet operations"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"VaultWallet":{"type":"object","properties":{"id":{"type":"integer","description":"Vault wallet ID"},"player_id":{"type":"integer","description":"Player ID"},"currency_id":{"type":"integer","description":"Currency ID"},"balance":{"type":"string","description":"Vault wallet balance with formatting"},"created_at":{"type":"string","format":"date-time","description":"Vault wallet creation timestamp"},"updated_at":{"type":"string","format":"date-time","description":"Vault wallet last update timestamp"},"currency":{"$ref":"#/components/schemas/Currency"}}},"Currency":{"type":"object","properties":{"code":{"type":"string","description":"Currency code"},"name":{"type":"string","description":"Currency name"},"symbol":{"type":"string","description":"Currency symbol"},"decimal_places":{"type":"integer","description":"Decimal places"},"type":{"type":"string","enum":["fiat","crypto"],"description":"Currency type"},"is_default":{"type":"boolean","description":"Whether this is the default currency"},"conversion_rate":{"type":"number","format":"float","description":"Conversion rate to base currency"}}},"PlayerWallet":{"type":"object","properties":{"type":{"type":"integer","description":"Wallet type ID"},"type_name":{"type":"string","description":"Wallet type name"},"type_constant":{"type":"string","description":"Wallet type constant"},"activated":{"type":"integer","description":"Whether the wallet is activated (1 = active, 0 = inactive)"},"balance":{"type":"string","description":"Wallet balance with formatting"},"total_main_bonus_balance":{"type":"string","description":"Total main bonus balance with formatting"},"total_bonus_balance":{"type":"string","description":"Total bonus balance with formatting"},"total_bonus_locked_balance":{"type":"string","description":"Total bonus locked balance with formatting"},"total_bonus_locked_bonus_balance":{"type":"string","description":"Total bonus locked bonus balance with formatting"},"total_withdraw_balance":{"type":"string","description":"Total withdrawable balance with formatting"},"total_locked_balance":{"type":"string","description":"Total locked balance with formatting"},"total_main_bonus_locked_balance":{"type":"string","description":"Total main bonus locked balance with formatting"},"total_main_bonus_locked_bonus_balance":{"type":"string","description":"Total main bonus locked bonus balance with formatting"},"total_balance":{"type":"string","description":"Total balance with formatting"},"game_provider":{"type":"string","nullable":true,"description":"Game provider (if associated with a specific provider)"},"activated_betting_from_main":{"type":"boolean","description":"Whether betting from main wallet is activated"},"currency":{"type":"object","properties":{"name":{"type":"string","description":"Currency name"},"code":{"type":"string","description":"Currency code"},"symbol":{"type":"string","description":"Currency symbol"},"decimals":{"type":"integer","description":"Number of decimal places"},"order":{"type":"integer","description":"Display order"},"type":{"type":"integer","description":"Currency type ID"},"type_name":{"type":"string","description":"Currency type name"},"is_default":{"type":"integer","description":"Whether this is the default currency (1 = default, 0 = not default)"}}},"converted":{"type":"object","description":"Balance converted to default currency","properties":{"balance":{"type":"string","description":"Converted balance with formatting"},"total_main_bonus_balance":{"type":"string","description":"Converted total main bonus balance with formatting"},"total_bonus_balance":{"type":"string","description":"Converted total bonus balance with formatting"},"total_withdraw_balance":{"type":"string","description":"Converted total withdrawable balance with formatting"},"total_locked_balance":{"type":"string","description":"Converted total locked balance with formatting"},"total_balance":{"type":"string","description":"Converted total balance with formatting"},"total_balance_in_float":{"type":"number","format":"float","description":"Converted total balance as float"},"total_main_bonus_balance_in_float":{"type":"number","format":"float","description":"Converted total main bonus balance as float"},"total_bonus_locked_balance":{"type":"string","description":"Converted total bonus locked balance with formatting"},"total_bonus_locked_bonus_balance":{"type":"string","description":"Converted total bonus locked bonus balance with formatting"},"total_main_bonus_locked_balance":{"type":"string","description":"Converted total main bonus locked balance with formatting"},"total_main_bonus_locked_bonus_balance":{"type":"string","description":"Converted total main bonus locked bonus balance with formatting"},"currency":{"type":"object","properties":{"name":{"type":"string","description":"Currency name"},"code":{"type":"string","description":"Currency code"},"symbol":{"type":"string","description":"Currency symbol"},"decimals":{"type":"integer","description":"Number of decimal places"},"order":{"type":"integer","description":"Display order"},"type":{"type":"integer","description":"Currency type ID"},"type_name":{"type":"string","description":"Currency type name"},"is_default":{"type":"integer","description":"Whether this is the default currency (1 = default, 0 = not default)"}}}}}}},"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string","description":"Error message"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Validation errors by field"}}}}},"paths":{"/v1/vault-wallets/transfer-in":{"post":{"tags":["Wallet"],"summary":"Transfer funds into vault wallet","description":"Transfer funds from main wallet to vault wallet","operationId":"transferToVaultWallet","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount","currency_code"],"properties":{"amount":{"type":"number","format":"float","description":"Amount to transfer"},"currency_code":{"type":"string","description":"Currency code"}}}}}},"responses":{"200":{"description":"Transfer successful","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Success message"},"vault_wallet":{"$ref":"#/components/schemas/VaultWallet"},"main_wallet":{"$ref":"#/components/schemas/PlayerWallet"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}}}}}
```

## Transfer funds out of vault wallet

> Transfer funds from vault wallet to main wallet

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"Wallet","description":"Player wallet operations"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"VaultWallet":{"type":"object","properties":{"id":{"type":"integer","description":"Vault wallet ID"},"player_id":{"type":"integer","description":"Player ID"},"currency_id":{"type":"integer","description":"Currency ID"},"balance":{"type":"string","description":"Vault wallet balance with formatting"},"created_at":{"type":"string","format":"date-time","description":"Vault wallet creation timestamp"},"updated_at":{"type":"string","format":"date-time","description":"Vault wallet last update timestamp"},"currency":{"$ref":"#/components/schemas/Currency"}}},"Currency":{"type":"object","properties":{"code":{"type":"string","description":"Currency code"},"name":{"type":"string","description":"Currency name"},"symbol":{"type":"string","description":"Currency symbol"},"decimal_places":{"type":"integer","description":"Decimal places"},"type":{"type":"string","enum":["fiat","crypto"],"description":"Currency type"},"is_default":{"type":"boolean","description":"Whether this is the default currency"},"conversion_rate":{"type":"number","format":"float","description":"Conversion rate to base currency"}}},"PlayerWallet":{"type":"object","properties":{"type":{"type":"integer","description":"Wallet type ID"},"type_name":{"type":"string","description":"Wallet type name"},"type_constant":{"type":"string","description":"Wallet type constant"},"activated":{"type":"integer","description":"Whether the wallet is activated (1 = active, 0 = inactive)"},"balance":{"type":"string","description":"Wallet balance with formatting"},"total_main_bonus_balance":{"type":"string","description":"Total main bonus balance with formatting"},"total_bonus_balance":{"type":"string","description":"Total bonus balance with formatting"},"total_bonus_locked_balance":{"type":"string","description":"Total bonus locked balance with formatting"},"total_bonus_locked_bonus_balance":{"type":"string","description":"Total bonus locked bonus balance with formatting"},"total_withdraw_balance":{"type":"string","description":"Total withdrawable balance with formatting"},"total_locked_balance":{"type":"string","description":"Total locked balance with formatting"},"total_main_bonus_locked_balance":{"type":"string","description":"Total main bonus locked balance with formatting"},"total_main_bonus_locked_bonus_balance":{"type":"string","description":"Total main bonus locked bonus balance with formatting"},"total_balance":{"type":"string","description":"Total balance with formatting"},"game_provider":{"type":"string","nullable":true,"description":"Game provider (if associated with a specific provider)"},"activated_betting_from_main":{"type":"boolean","description":"Whether betting from main wallet is activated"},"currency":{"type":"object","properties":{"name":{"type":"string","description":"Currency name"},"code":{"type":"string","description":"Currency code"},"symbol":{"type":"string","description":"Currency symbol"},"decimals":{"type":"integer","description":"Number of decimal places"},"order":{"type":"integer","description":"Display order"},"type":{"type":"integer","description":"Currency type ID"},"type_name":{"type":"string","description":"Currency type name"},"is_default":{"type":"integer","description":"Whether this is the default currency (1 = default, 0 = not default)"}}},"converted":{"type":"object","description":"Balance converted to default currency","properties":{"balance":{"type":"string","description":"Converted balance with formatting"},"total_main_bonus_balance":{"type":"string","description":"Converted total main bonus balance with formatting"},"total_bonus_balance":{"type":"string","description":"Converted total bonus balance with formatting"},"total_withdraw_balance":{"type":"string","description":"Converted total withdrawable balance with formatting"},"total_locked_balance":{"type":"string","description":"Converted total locked balance with formatting"},"total_balance":{"type":"string","description":"Converted total balance with formatting"},"total_balance_in_float":{"type":"number","format":"float","description":"Converted total balance as float"},"total_main_bonus_balance_in_float":{"type":"number","format":"float","description":"Converted total main bonus balance as float"},"total_bonus_locked_balance":{"type":"string","description":"Converted total bonus locked balance with formatting"},"total_bonus_locked_bonus_balance":{"type":"string","description":"Converted total bonus locked bonus balance with formatting"},"total_main_bonus_locked_balance":{"type":"string","description":"Converted total main bonus locked balance with formatting"},"total_main_bonus_locked_bonus_balance":{"type":"string","description":"Converted total main bonus locked bonus balance with formatting"},"currency":{"type":"object","properties":{"name":{"type":"string","description":"Currency name"},"code":{"type":"string","description":"Currency code"},"symbol":{"type":"string","description":"Currency symbol"},"decimals":{"type":"integer","description":"Number of decimal places"},"order":{"type":"integer","description":"Display order"},"type":{"type":"integer","description":"Currency type ID"},"type_name":{"type":"string","description":"Currency type name"},"is_default":{"type":"integer","description":"Whether this is the default currency (1 = default, 0 = not default)"}}}}}}},"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string","description":"Error message"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Validation errors by field"}}}}},"paths":{"/v1/vault-wallets/transfer-out":{"post":{"tags":["Wallet"],"summary":"Transfer funds out of vault wallet","description":"Transfer funds from vault wallet to main wallet","operationId":"transferFromVaultWallet","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount","currency_code"],"properties":{"amount":{"type":"number","format":"float","description":"Amount to transfer"},"currency_code":{"type":"string","description":"Currency code"}}}}}},"responses":{"200":{"description":"Transfer successful","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Success message"},"vault_wallet":{"$ref":"#/components/schemas/VaultWallet"},"main_wallet":{"$ref":"#/components/schemas/PlayerWallet"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}}}}}
```