Fiat Withdraw Pre-check

Frequency limit: 20 times/1s (UID)

Description

Pre-check for fiat withdrawal. Returns the user's withdrawal limits, available balance, KYC status, and other eligibility information before submitting a withdrawal order.

HTTP Request

• POST /api/v2/fiat/withdraw-precheck

Request Example

curl -X POST "https://api.cointr.com/api/v2/fiat/withdraw-precheck" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json" \
   -d '{"currency":"TRY","paymentMethod":"BANK_TRANSFER","withdrawAmount":"1000","bankCardId":123456}'

Request Parameters

Parameter	Type	Required	Description
currency	String	Yes	Fiat currency code, e.g. TRY. Defaults to TRY if not provided.
withdrawAmount	String	Yes	Withdrawal amount
bankCode	String	No	Bank code
bankCardId	Long	No	Bank card ID

Response Example

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1750055923070,
    "data": {
        "minAmountLimit": "100",
        "maxAmountLimit": "50000",
        "ableAmount": "10000",
        "status": "INSCOPE",
        "depsoitDailyLimit": "100000",
        "withdrawlDailyLimit": "50000",
        "depsoitDailyAccumulatedAmount": "0",
        "withdrawlDailyAccumulatedAmount": "1000",
        "mobileAndEmailState": "BOUND",
        "recordCode": "123456",
        "newMainKyc": false,
        "country": "TR",
        "kycVerifyType": 1,
        "account": "user@example.com",
        "city": "Istanbul",
        "address": "***",
        "userType": "INDIVIDUAL",
        "userName": "***",
        "mobileState": 1,
        "registerSubState": "noAccountOpened",
        "ableCurrency": "TRY",
        "toCurrency": "USDT",
        "toAmount": "0.032",
        "grade": "L1",
        "channelCode": "BIRAPI"
    }
}

Response Parameters

Parameter	Type	Description
minAmountLimit	String	Minimum single withdrawal amount limit
maxAmountLimit	String	Maximum single withdrawal amount limit
ableAmount	String	Available balance for withdrawal
status	String	User scope status, e.g. INSCOPE (eligible), NOTSCOPE (not eligible)
depsoitDailyLimit	String	Daily deposit limit
withdrawlDailyLimit	String	Daily withdrawal limit
depsoitDailyAccumulatedAmount	String	User's accumulated deposit amount for the current day
withdrawlDailyAccumulatedAmount	String	User's accumulated withdrawal amount for the current day
kycFields	Map	KYC required fields map
mobileAndEmailState	String	Mobile and email binding status
recordCode	String	Pre-check record code, used when submitting the withdrawal confirm request
newMainKyc	Boolean	Whether the user has a new main KYC
country	String	KYC country code, e.g. TR
kycVerifyType	Integer	KYC verification type: 1 Onfido, 2 Pluto, 0 Manual review
account	String	User account (email or mobile)
city	String	User city
address	String	User address (masked)
userType	String	User type, e.g. INDIVIDUAL
userName	String	User name (masked)
mobileState	Integer	Mobile binding status
registerSubState	String	Account registration sub-status: noAccountOpened not yet opened, channelAuthenticationFailed channel KYC failed, accountFailed account opening failed
ableCurrency	String	Available balance currency
toCurrency	String	Estimated received currency
toAmount	String	Estimated received amount
grade	String	KYC level, e.g. L1
channelCode	String	Channel code