binance_get_earn_flexible_positions
Retrieve your Simple Earn Flexible subscriptions with live APR, tiered rates, and rewards. Decide whether to redeem or top up based on current returns.
Instructions
List the caller's Simple Earn Flexible subscriptions and their live APR.
Calls GET /sapi/v1/simple-earn/flexible/position (SIGNED, USER_DATA). IP weight
150 per call (S1 spec, 2024-10 — Binance's docs site renders the Simple Earn pages
empty, so this weight was not re-verified; treat it as approximate).
When to Use:
To see which Flexible products you are subscribed to, how much is deposited, and the current (and tiered, when Binance returns tiers) annual percentage rate.
Before deciding whether to redeem or top up a Flexible position.
When NOT to Use:
For time-locked Simple Earn products — use
binance_get_earn_locked_positions.For a single aggregate balance across all Earn products — use
binance_get_earn_account.
Returns:
A markdown list (or JSON with response_format="json") of positions: asset,
product id, deposited amount, latest APR, tiered APR breakdown (when present),
yesterday's airdrop rate, redeemability, auto-subscribe flag, and cumulative
rewards (yesterday, real-time, bonus, total).
Pagination:
limit (Binance size, max 100, default 20) and offset (house-style; see the
module docstring for the offset -> current page-number mapping). total from
Binance drives has_more. Display is additionally capped at MAX_DISPLAY_ROWS
(50) even when limit asked for more — a truncation note is appended when rows
were dropped.
Examples: params = {"asset": "USDT", "limit": 20} params = {"product_id": "BTC001"}
Error Handling:
-2015 means the key lacks Simple Earn / USER_DATA permission, or this machine's
IP is not on the key's allowlist. An empty rows list means no Flexible
subscriptions exist (or the asset/product_id filter matched nothing).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |