# Xbit ## Docs - [Welcome](https://docs.xbit.pro/welcome-2020670m0.md): ## API Docs - Account Data [Get account balances](https://docs.xbit.pro/get-account-balances-30637929e0.md): Retrieve all currency balances for the authenticated user account. Returns an array of balance objects containing currency code and amount in cents for each supported currency. - Account Data [Get activation code history](https://docs.xbit.pro/get-activation-code-history-30637930e0.md): Retrieve a paginated list of activation codes for the authenticated user. Supports filtering by currency and redemption status, as well as text search within code values. Use pagination parameters (limit/offset) to navigate through results. - Account Data [Activate a redeemable code](https://docs.xbit.pro/activate-a-redeemable-code-30637931e0.md): Redeem an activation code and add its value to the authenticated user balance. Once activated, the code cannot be used again. The balance is updated immediately upon successful activation. - Account Data [Get activation code details](https://docs.xbit.pro/get-activation-code-details-30637932e0.md): Retrieve detailed information about a specific activation code including its value, currency, redemption status, and creation date. Use this endpoint to check code validity before attempting activation. - Account Data [Get card withdrawal history](https://docs.xbit.pro/get-card-withdrawal-history-30637933e0.md): Retrieve a paginated list of card withdrawals for the authenticated user. Supports filtering by currency and status. Card numbers are obfuscated for security (e.g., 411111******1111). - Account Data [Get cryptocurrency withdrawal history](https://docs.xbit.pro/get-cryptocurrency-withdrawal-history-30637934e0.md): Retrieve a paginated list of cryptocurrency withdrawals for the authenticated user. Supports filtering by currency and status, as well as text search within wallet addresses. Includes details such as wallet address, crypto amount, crypto type, and transaction status. - Account Data [Get deposit (payment) history](https://docs.xbit.pro/get-deposit-payment-history-30637935e0.md): Retrieve a paginated list of deposits (payments) for the authenticated user. Supports filtering by currency and status, as well as text search within payment IDs. Includes payment details such as amount, currency, status, activation code, and timestamps. - Payment [Calculate payment amount with commission](https://docs.xbit.pro/calculate-payment-amount-with-commission-30637936e0.md): Calculate the total amount including commission before creating a payment. Shows how much the customer needs to pay (including fees) for a specific amount. For certain payment types (e.g., KZT crosspay), the final amount must be divisible by 100. If the amount is invalid, the API returns suggested valid amounts (nearestLower and nearestHigher). - Payment [Create a new payment](https://docs.xbit.pro/create-a-new-payment-30637937e0.md): Creates a payment request and returns a payment URL where the customer should be redirected to complete the payment. After successful payment, a webhook notification will be sent to your configured webhook URL, and the customer will be redirected to your web redirect URL. For EUR payments, additional customer information (address, birthDate, countryCode, zipCode, city) is required. - Payment [Get payment details by payment ID](https://docs.xbit.pro/get-payment-details-by-payment-id-30637938e0.md): Retrieve the current status and details of a payment including status, code ID (if successful), amount, currency, and creation timestamp. Use this endpoint to check if a payment has been completed or is still pending. - Withdraw [Get minimum cryptocurrency withdrawal amounts](https://docs.xbit.pro/get-minimum-cryptocurrency-withdrawal-amounts-30637939e0.md): Retrieve the minimum amounts required for cryptocurrency withdrawals. Returns both the minimum fiat currency amount (in cents) and the minimum cryptocurrency amount. Use this endpoint before creating a crypto withdrawal to ensure the amount meets minimum requirements. - Withdraw [Calculate cryptocurrency withdrawal amounts](https://docs.xbit.pro/calculate-cryptocurrency-withdrawal-amounts-30637940e0.md): Calculate cryptocurrency withdrawal amounts including fees. You can provide either amountInCents (to calculate how much crypto you will receive) or cryptoAmount (to calculate how much fiat is needed), but NOT both. The calculation includes all applicable fees and exchange rates. - Withdraw [Calculate fiat withdrawal commission](https://docs.xbit.pro/calculate-fiat-withdrawal-commission-30637941e0.md): Calculate the commission for fiat currency withdrawal. Returns the total amount that will be charged including system commission. Use this endpoint before creating a withdrawal to show the customer the final amount. - Withdraw [Get withdrawal details by ID](https://docs.xbit.pro/get-withdrawal-details-by-id-30637942e0.md): Retrieve the current status and details of a withdrawal including type, status, currency, and amount. The data object varies based on withdrawal type: For card withdrawals, it includes the obfuscated card number. For code withdrawals, it includes the activation code. For crypto withdrawals, it includes wallet address, transaction hash, and real withdrawal amount. - Withdraw [Create withdrawal to bank card](https://docs.xbit.pro/create-withdrawal-to-bank-card-30637943e0.md): Create a withdrawal request to a bank card. After successful creation, a webhook notification will be sent to your configured webhook URL when the withdrawal status changes. For EUR withdrawals, additional customer information (firstName, lastName, address, birthDate, countryCode, zipCode, city) is required. - Withdraw [Create withdrawal as redeemable code](https://docs.xbit.pro/create-withdrawal-as-redeemable-code-30637944e0.md): Create a withdrawal as a redeemable code that can be activated later. The code can be used to add funds to another account or shared with another user. After successful creation, a webhook notification will be sent to your configured webhook URL when the withdrawal is processed. - Withdraw [Create withdrawal to cryptocurrency wallet](https://docs.xbit.pro/create-withdrawal-to-cryptocurrency-wallet-30637945e0.md): Create a withdrawal to a cryptocurrency wallet address. The fiat amount (amountInCents) is automatically converted to cryptocurrency at the current exchange rate. Supports BTC, USDT TRC20, and USDT ERC20. After successful creation, a webhook notification will be sent to your configured webhook URL when the withdrawal is processed and the blockchain transaction is confirmed. ## Schemas - [GeneralApiRequestDto](https://docs.xbit.pro/generalapirequestdto-13484616d0.md): - [BalanceItemDto](https://docs.xbit.pro/balanceitemdto-13484617d0.md): - [AccountBalancesResponseDto](https://docs.xbit.pro/accountbalancesresponsedto-13484618d0.md): - [ApiCodesFilterDto](https://docs.xbit.pro/apicodesfilterdto-13484619d0.md): - [ApiGetCodeHistoryRequestDto](https://docs.xbit.pro/apigetcodehistoryrequestdto-13484620d0.md): - [ApiGetCodeHistoryResponseDto](https://docs.xbit.pro/apigetcodehistoryresponsedto-13484621d0.md): - [CodeActivationRequestDto](https://docs.xbit.pro/codeactivationrequestdto-13484622d0.md): - [CodeDetailsRequestDto](https://docs.xbit.pro/codedetailsrequestdto-13484623d0.md): - [CodeDetailsResponseDto](https://docs.xbit.pro/codedetailsresponsedto-13484624d0.md): - [ApiWithdrawToCardFilterDto](https://docs.xbit.pro/apiwithdrawtocardfilterdto-13484625d0.md): - [ApiGetWithdrawToCardRequestDto](https://docs.xbit.pro/apigetwithdrawtocardrequestdto-13484626d0.md): - [ApiGetWithdrawToCardResponseDto](https://docs.xbit.pro/apigetwithdrawtocardresponsedto-13484627d0.md): - [ApiWithdrawToCryptoFilterDto](https://docs.xbit.pro/apiwithdrawtocryptofilterdto-13484628d0.md): - [ApiGetWithdrawToCryptoRequestDto](https://docs.xbit.pro/apigetwithdrawtocryptorequestdto-13484629d0.md): - [ApiGetWithdrawToCryptoResponseDto](https://docs.xbit.pro/apigetwithdrawtocryptoresponsedto-13484630d0.md): - [ApiDepositFilterDto](https://docs.xbit.pro/apidepositfilterdto-13484631d0.md): - [ApiGetDepositHistoryRequestDto](https://docs.xbit.pro/apigetdeposithistoryrequestdto-13484632d0.md): - [ApiGetDepositHistoryResponseDto](https://docs.xbit.pro/apigetdeposithistoryresponsedto-13484633d0.md): - [CalculatePaymentRequestDto](https://docs.xbit.pro/calculatepaymentrequestdto-13484634d0.md): - [CalculatePaymentResponseDto](https://docs.xbit.pro/calculatepaymentresponsedto-13484635d0.md): - [CreatePaymentRequestDto](https://docs.xbit.pro/createpaymentrequestdto-13484636d0.md): - [CreatePaymentResponseDto](https://docs.xbit.pro/createpaymentresponsedto-13484637d0.md): - [GetPaymentDetailsRequestDto](https://docs.xbit.pro/getpaymentdetailsrequestdto-13484638d0.md): - [GetPaymentDetailsResponseDto](https://docs.xbit.pro/getpaymentdetailsresponsedto-13484639d0.md): - [ApiMinCryptoAmountsRequestDto](https://docs.xbit.pro/apimincryptoamountsrequestdto-13484640d0.md): - [ApiMinCryptoAmountsResponseDto](https://docs.xbit.pro/apimincryptoamountsresponsedto-13484641d0.md): - [ApiCalculateCryptoRequestDto](https://docs.xbit.pro/apicalculatecryptorequestdto-13484642d0.md): - [ApiCalculateCryptoResponseDto](https://docs.xbit.pro/apicalculatecryptoresponsedto-13484643d0.md): - [ApiCalculateFiatRequestDto](https://docs.xbit.pro/apicalculatefiatrequestdto-13484644d0.md): - [ApiCalculateFiatResponseDto](https://docs.xbit.pro/apicalculatefiatresponsedto-13484645d0.md): - [ApiGetWithdrawDetailsRequestDto](https://docs.xbit.pro/apigetwithdrawdetailsrequestdto-13484646d0.md): - [ApiGetWithdrawDetailsResponseDto](https://docs.xbit.pro/apigetwithdrawdetailsresponsedto-13484647d0.md): - [ApiCreateCardWithdrawRequestDto](https://docs.xbit.pro/apicreatecardwithdrawrequestdto-13484648d0.md): - [WithdrawIdDto](https://docs.xbit.pro/withdrawiddto-13484649d0.md): - [ApiCreateCodeWithdrawRequestDto](https://docs.xbit.pro/apicreatecodewithdrawrequestdto-13484650d0.md): - [ApiCreateCryptoWithdrawRequestDto](https://docs.xbit.pro/apicreatecryptowithdrawrequestdto-13484651d0.md):