OpenAPI Specification
openapi: 3.0.3
info:
title: LBank Spot Market REST Account Wallet API
description: Public REST endpoints providing real-time and historical market data for all LBank spot trading pairs. All endpoints are unauthenticated and suitable for market data aggregators, dashboards, and trading bots.
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)
- url: https://api.lbank.info
description: LBank REST API (tertiary)
tags:
- name: Wallet
description: Deposit and withdrawal management endpoints
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:
schemas:
WithdrawResponse:
type: object
properties:
result:
type: string
enum:
- 'true'
- 'false'
withdrawId:
type: integer
description: Withdrawal ID
fee:
type: number
description: Withdrawal fee charged
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'
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
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'
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)