Authenticated REST endpoints for managing cryptocurrency deposits and withdrawals on LBank. Developers can query deposit history, initiate withdrawals, retrieve asset details including available networks and minimum withdrawal amounts, fetch withdrawal fee rates, query withdrawal history, and manage API key permissions. Supports multi-chain deposits and withdrawals across all assets listed on the exchange.
{
"openapi": "3.0.3",
"info": {
"title": "LBank Wallet REST API",
"description": "Authenticated REST endpoints for managing cryptocurrency deposits and withdrawals on LBank. IP binding is required for withdrawal operations.",
"version": "1.0.0",
"contact": {
"url": "https://www.lbank.com/en-US/docs/"
},
"termsOfService": "https://www.lbank.com/en-US/agreement/"
},
"servers": [
{
"url": "https://api.lbkex.com",
"description": "LBank REST API (primary)"
},
{
"url": "https://api.lbkex.net",
"description": "LBank REST API (secondary)"
}
],
"paths": {
"/v1/withdrawConfigs.do": {
"get": {
"operationId": "getWithdrawConfigs",
"summary": "Get withdrawal configurations",
"description": "Returns withdrawal configuration for all assets or a specific asset, including minimum amounts, fee, and whether withdrawal is currently available.",
"tags": ["Wallet"],
"parameters": [
{
"name": "assetCode",
"in": "query",
"required": false,
"description": "Asset code to filter (e.g. eth). Returns all assets if not specified.",
"schema": {
"type": "string",
"example": "eth"
}
}
],
"responses": {
"200": {
"description": "List of withdrawal configurations",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/WithdrawConfig"
}
}
}
}
}
}
}
},
"/v1/withdraw.do": {
"post": {
"operationId": "withdraw",
"summary": "Submit a withdrawal",
"description": "Initiates a cryptocurrency withdrawal. IP binding is required. Supports both internal (email/mobile) and external (blockchain address) withdrawals.",
"tags": ["Wallet"],
"requestBody": {
"required": true,
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/AuthRequest"
},
{
"type": "object",
"required": ["account", "assetCode", "amount"],
"properties": {
"account": {
"type": "string",
"description": "Withdrawal address. For internal transfers, use email or mobile account."
},
"assetCode": {
"type": "string",
"description": "Asset code (e.g. btc, eth)"
},
"amount": {
"type": "string",
"description": "Withdrawal amount (must be integer for NEO)"
},
"memo": {
"type": "string",
"description": "Required for BTS and DCT"
},
"mark": {
"type": "string",
"description": "User memo (max 255 characters)"
},
"type": {
"type": "string",
"enum": ["1", "2"],
"description": "Withdrawal type: 1=internal, 2=normal (blockchain)"
}
}
}
]
}
}
}
},
"responses": {
"200": {
"description": "Withdrawal submission result",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WithdrawResponse"
}
}
}
}
},
"security": [
{
"ApiKeyAuth": []
}
]
}
},
"/v1/withdrawCancel.do": {
"post": {
"operationId": "cancelWithdraw",
"summary": "Cancel a withdrawal",
"description": "Revokes a pending withdrawal by withdrawal ID. IP binding is required.",
"tags": ["Wallet"],
"requestBody": {
"required": true,
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/AuthRequest"
},
{
"type": "object",
"required": ["withdrawId"],
"properties": {
"withdrawId": {
"type": "string",
"description": "Withdrawal ID to cancel"
}
}
}
]
}
}
}
},
"responses": {
"200": {
"description": "Withdrawal cancellation result",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"result": {
"type": "string",
"enum": ["true", "false"]
},
"withdrawId": {
"type": "string",
"description": "Cancelled withdrawal ID"
}
}
}
}
}
}
},
"security": [
{
"ApiKeyAuth": []
}
]
}
},
"/v1/withdraws.do": {
"post": {
"operationId": "getWithdrawalHistory",
"summary": "Get withdrawal history",
"description": "Returns paginated withdrawal records for a specific asset, filtered by status. IP binding is required.",
"tags": ["Wallet"],
"requestBody": {
"required": true,
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/AuthRequest"
},
{
"type": "object",
"required": ["assetCode", "status", "pageNo", "pageSize"],
"properties": {
"assetCode": {
"type": "string",
"description": "Asset code (e.g. btc)"
},
"status": {
"type": "string",
"enum": ["0", "1", "2", "3", "4"],
"description": "Withdrawal status filter: 0=All, 1=Applying, 2=Revoked, 3=Failed, 4=Completed"
},
"pageNo": {
"type": "string",
"description": "Page number (default 1)"
},
"pageSize": {
"type": "string",
"description": "Records per page (max 100, default 20)"
}
}
}
]
}
}
}
},
"responses": {
"200": {
"description": "Paginated withdrawal history",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WithdrawalHistoryResponse"
}
}
}
}
},
"security": [
{
"ApiKeyAuth": []
}
]
}
}
},
"components": {
"securitySchemes": {
"ApiKeyAuth": {
"type": "apiKey",
"in": "query",
"name": "api_key",
"description": "LBank API key with HMAC or RSA request signing"
}
},
"schemas": {
"AuthRequest": {
"type": "object",
"required": ["api_key", "sign"],
"properties": {
"api_key": {
"type": "string",
"description": "User's API key"
},
"sign": {
"type": "string",
"description": "Request signature (RSA or HmacSHA256)"
}
}
},
"WithdrawConfig": {
"type": "object",
"properties": {
"assetCode": {
"type": "string",
"description": "Asset code (e.g. eth, btc)"
},
"min": {
"type": "string",
"description": "Minimum withdrawal amount"
},
"canWithDraw": {
"type": "boolean",
"description": "Whether withdrawal is currently available"
},
"fee": {
"type": "string",
"description": "Withdrawal fee amount"
}
}
},
"WithdrawResponse": {
"type": "object",
"properties": {
"result": {
"type": "string",
"enum": ["true", "false"]
},
"withdrawId": {
"type": "integer",
"description": "Withdrawal ID"
},
"fee": {
"type": "number",
"description": "Withdrawal fee charged"
}
}
},
"WithdrawalRecord": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Withdrawal record ID"
},
"assetCode": {
"type": "string",
"description": "Asset code"
},
"address": {
"type": "string",
"description": "Withdrawal address"
},
"amount": {
"type": "number",
"description": "Withdrawal amount"
},
"fee": {
"type": "number",
"description": "Withdrawal fee"
},
"time": {
"type": "integer",
"description": "Withdrawal timestamp (milliseconds)"
},
"txHash": {
"type": "string",
"description": "Blockchain transaction hash"
},
"status": {
"type": "string",
"description": "Status: 1=Applying, 2=Revoked, 3=Failed, 4=Completed"
}
}
},
"WithdrawalHistoryResponse": {
"type": "object",
"properties": {
"totalPages": {
"type": "integer",
"description": "Total number of pages"
},
"pageNo": {
"type": "integer",
"description": "Current page number"
},
"pageSize": {
"type": "integer",
"description": "Records per page"
},
"list": {
"type": "array",
"items": {
"$ref": "#/components/schemas/WithdrawalRecord"
}
}
}
}
}
},
"tags": [
{
"name": "Wallet",
"description": "Deposit and withdrawal management endpoints"
}
]
}