Skip to main content
Earn yield on crypto assets through fixed-term and flexible lending plans — 13 API endpoints for full lifecycle management.

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)
For full endpoint documentation, see the Crypto Lending API Reference.

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.