Capabilities
The Crypto Lending API supports two plan types with distinct yield mechanics.- Fixed plans — lock assets for 10-360 day terms. Interest paid at maturity. Interest ratio conversion when target currency differs from source currency.
- Flexible plans — deposit and withdraw anytime. Interest calculated hourly, credited daily.
- ~90 supported assets — invest in a wide range of crypto assets (check available plans dynamically via the plans endpoint)
- Auto-reinvestment — enable or disable automatic reinvestment of Flex plan returns for an existing investment
- Full lifecycle API — create, monitor, withdraw, and close investments programmatically
Who uses this
- Treasury operations — exchanges and trading firms putting idle Main balance assets to work in Flex plans between active trading periods.
- Yield integrators — fintechs and platforms offering yield to end users.
Common Integration Patterns
Idle asset management — Monitor Main balance for idle assets. Invest surplus into Flex plans (withdraw anytime, no lock-up). Enable auto-reinvestment to compound returns. Withdraw back to Main balance before trading. Yield-as-a-service — Delivering yield to many end users is a partner program with its own model and lifecycle — see Yield-as-a-Service.Plan Types
Lending API access: Both Fixed (
/api/v4/main-account/smart/) and Flex
(/api/v4/main-account/smart-flex/) lending endpoints require B2B partner permissions. Complete the
institutional services form to request access.
Until access is granted, these endpoints return 403
with "You don't have permission to use this endpoint. Please contact support for more details".With a sub-account’s API key (type: 2), these endpoints operate on that sub-account’s own Main balance. Lending is not enabled on sub-accounts by default and is enabled per sub-account on request; see YaaS integration.Technical Overview
- 13 endpoints total (5 fixed + 8 flex), all
POST, all authenticated - Authentication: HMAC-SHA512 (guide)
- Rate limits: 1000 requests per 10 seconds per endpoint (details)
Platform Context
The WhiteBIT platform brands lending products as U EARN. The platform also offers Staking and Auto-Invest for recurring purchases — available via the platform UI, not the API.What’s Next
Quickstart
Create a first Flex investment in under 5 minutes.
Yield-as-a-Service
Offer this yield to end users as a partner program.
API Reference
Full endpoint documentation for all 13 lending endpoints.