Wealth (Fixed Income)
Subscribe to Alpha Ladder Fixed Income Products (FIP) — flexible and fixed-term — after completing the investor precheck via the MCP API.
Deploy idle balances into Alpha Ladder's Fixed Income Products (FIP). FIPs offer both flexible (open-term) and fixed-term options across fiat currencies such as USD, EUR, and SGD, each with an estimated APR.
Before you start
Call get_module_permissions and confirm the wealth module returns hasPermission: true. See Module permissions.
The flow
Run the investor precheck — call investor_precheck to verify the user has signed the required agreements and completed the investor declaration before any FIP subscription. Returns two boolean flags:
Master Brokerage Agreement & Trading Rules— must betrue.investorDeclarationTag— must betrue.
true before calling fip_subscribe. If either is false, direct the user to complete the outstanding agreement or declaration via the Alpha Ladder platform before continuing.List available products — call get_fip_products to list all available FIP products, both flexible (termType: 1) and fixed-term (termType: 2). Each product entry includes:
productCode,productName,term(human-readable label),estApr(estimated APR range).currencyItemList[]— per-currency options withid,currency,estApr,termDays,liquidity, andmhp(minimum holding period).- Negative
termDaysvalues indicate flexible settlement products (e.g. T+1).
Retrieve the agreement — call get_fip_agreement (productType, productCode, currency) to retrieve the PDF agreement documents for the selected product and currency. Present the show_name and url links to the user so they can review the agreement before subscribing.
Subscribe — call fip_subscribe (id, currency, termDays, subscriptionAmount) to submit the subscription order.
id— thecurrencyItemList[].idfrom the product listing.currency— must match the selected currency item.termDays— use thetermDaysvalue from the currency item; negative values are used for flexible products.subscriptionAmount— the amount to invest in the specified currency.
termType 1 = flexible / open term; termType 2 = fixed term.
Ask in chat
"I want to earn yield on my idle USD. What fixed income products are available?"
The agent will run investor_precheck to confirm eligibility, list products via get_fip_products, present the APR options and agreement links from get_fip_agreement, and then subscribe via fip_subscribe after your explicit confirmation.
What you get back
fip_subscribe returns a confirmation object with:
| Field | Description |
|---|---|
currency | Subscribed currency |
subscriptionAmount | Subscription amount |
subscriptionDate | Date the subscription was placed |
returnsAccrualStartDate | Date when yield begins to accrue |
initialRedemptionOpeningDay | Earliest date redemption is available |
settlementDate | Settlement date description |
For full response conventions, see Response Reference.