Ceffu OpenAPI Documentation Platform
  1. Development Tools and Resource
Ceffu OpenAPI Documentation Platform
  • Changes
    • Upcoming Changes
    • Change log
  • Development Tools and Resource
    • Overview
      • Welcome to Ceffu OpenAPI
    • Quickstart
      • Initial Setup
      • Using the Ceffu SDK
    • Authentication
    • Rate limit
    • Error Codes
    • Webhook Introduction
  • Concepts
    • Ceffu Custody
  • System Endpoints
    • Get System status
  • Wallet Management
    • Ceffu Supported Asset Endpoint
      • Get Prime Wallet supported coins list
      • Get Qualified Wallet supported coins list
      • Get Cosign Wallet supported coins list
    • Qualified Wallets and Prime Wallets Endpoint
      • Create Wallet
      • Update Wallet Details
      • Get Wallet List
      • Get Asset Details
      • Get Wallet Asset Summary
    • Deposits
      • Get Deposit Address
      • Get Deposit History
      • Get Deposit Detail
    • Withdrawals
      • Withdrawal
      • Get Withdrawal Fee (estimated)
      • Get Withdrawal History
      • Get Withdrawal Details
    • Whitelisted Addresses
      • Get Whitelisted Address List
      • Get Correspondent’s Options
      • Add/Edit Whitelisted Address
    • Transactions
      • Transaction History List
  • PW Sub Wallets
    • Sub-Wallet Management
      • Create Sub-Wallet
      • Update Sub-Wallet Details
      • Get Sub-Wallet List
      • Get Sub-Wallet Asset Details
      • Get Sub-Wallet Asset Summary
    • Sub-Wallet Deposits
      • Get Sub-Wallet Deposit Address
      • Get Deposit Address List under Prime Wallet
      • Get Deposit History under Sub-Wallet
      • Get Sub-Wallet Deposit History By Prime Wallet
    • Internal Transfers
      • Transfer between Sub Wallet and Prime Wallet
      • Get Transfer History between Sub-Wallet and Prime Wallet
    • Transactions
      • Get Transaction Details of Prime Wallet Internal Transfer
  • MirrorX
    • Link & Account
      • Get MirrorX LinkId List
    • Balances & Positions
      • Check MirrorX Available amount
      • Get MirrorX Asset Positions
    • Orders
      • Get MirrorX Orders
      • Place MirrorX Orders
  • Webhooks & Notifications
    • Resend webhook notifications
  • Archive
    • Mirror Endpoints
      • Get Mirror Linked Binance UID List
      • MIrror Assets Application
      • MIrror Assets Settlement
      • Get Mirror Operation Records
      • Get Mirrored Asset Positions
      • Get Mirrored Asset Summary
    • Wallet Endpoints
      • Get Transfer Detail with Exchange
      • Get Transfer History with Exchange
      • Transfer with Exchange
      • Get Withdrawal History
      • Get Withdrawal Details
      • Withdrawal
      • Get Sub-Wallet List (V1)
  1. Development Tools and Resource

Error Codes

Overview:#

List of error codes for the API, with explanations.This article explains the common error codes and HTTP status codes you may encounter when using the Ceffu API.

Error Code#

Code
MessageDescription
000000SuccessThe request was successful
G20001Internal system errorInternal system error, please contact us for troubleshooting
G20002Bad requestServer cannot or will not process the request due to something that is perceived to be a client error
G20003Exceeded pagination sizeThe request params exceeded the pagination size
G20004Exceeded pagination limitThe request params exceeded the pagination limit
G20005Invalid parameter valueInvalid input params value
G20006Timestamp is emptyRequest params timestamp is missing
G20007Request timestamp expiredRequest params timestamp is expired
G20008Missing API Key or SignatureMissisng API Key or Signature in the request
G20009Invalid SignInvalid Signature in the request
G20010Invalid API KeyInvalid API Key in the request
G20011Invalid IP addressInvalid IP Address in the request
G20012Rate limit exceededRate limit exceeded
G20013No wallet permissionAPI Key has no wallet permission
G20014Invalid request ID formatInvalid request ID format in the request
G20015Duplicated requestDuplicated request ID found in server
G20016No permission access this endpointAPI Key has no permission to access this endpoint
G20017Sub wallet does not support withdraw actionSub wallet does not support withdraw action
G20018Required Sub wallet IDSub wallet ID is required for this endpoint
G20019Required Prime wallet IDPrime wallet ID is required for this endpoint
G20020Wallet ID not foundWallet ID not found
G20021Invalid wallet relationshipInvalid wallet relationship
G20022Invalid amountInvalid amount
G20023Invalid request formatInvalid request format
G20024This feature is not available by custodian licenseFeature is not enabled under corresponding custodian license
G20025Wallet type is not supportedThis endpoint does not support the requested wallet type
G20026Duplicated requestDuplicated request
G20027Required Prime wallet ID or Sub wallet IDRequired Prime wallet ID or Sub wallet ID
G20028Wallet name too longLength of wallet name execeeded the limit
G20029Invalid parent walletInvalid parent wallet
G20030Sub-wallet ID is not allowed.Sub wallet ID is not allowed in this API endpoint
G20031Input param exceeds the maximum size limitLength of requestId exceeded the limit
G20032Invalid datetime range. Please adjustDate range params are out of range
G20033Hook Status Should Be openWebhook status is not open
G20034No permission access this webhook endpointAPI key has no permissionto access the corresponding webhook
G20035You have been offboarded, please contact your account manager if there is any problem.You have been offboarded, please contact your account manager if there is any problem.
G20036Invalid wallet relationship: Wallet not found in the workspace.Invalid wallet relationship: Wallet not found in the workspace.
G20037Invalid wallet relationship: Wallet not found in the institution.Invalid wallet relationship: Wallet not found in the institution.
G20038coinSymbol is required for Prime wallet.Param "coinSymbol" is required when query for coin list of prime wallet
G20039The API has been discontinued. Please use the upgraded API for new features and improvements.Switch to new version of api
BXXXX-Business error, refer to specific error message for more detail

HTTP status codes (Newly added)#

HTTP StatusMeaningsDescription
200SuccessThe operation succeeded
400Bad RequestThe client request is invalid
401UnauthorizedAuthentication failed (e.g., invalid token specified by the Authorization header)
403ForbiddenAuthentication failed, but the operation is not allowed
404Not FoundRequested resource does not exist
429Too Many RequestsClient request rate exceeded the limit
5xxSystem error
2xxBusiness error
Previous
Rate limit
Next
Webhook Introduction