Dividends
Holding income (acreencias) is a credit a user receives for holding an asset, typically bond coupons and amortizations, or dividends. The income arrives in one currency (incomeAsset) and may carry fees charged in another (finalClaimInfo.asset, usually ARS).
Types
The type depends on the asset generating the income:
| Type | Description |
|---|---|
DIVIDEND | Profit distributions companies pay to their shareholders (e.g. AAPL). |
BOND | Interest payments from governments or companies on borrowed money (e.g. AL30, MRCAO). |
MATURITY | Expiration of an asset (e.g. S31O4, T2X5). |
REDEMPTION | Capital repayments from governments or companies (e.g. AL30). |
Lifecycle
| Status | Description |
|---|---|
PENDING | Created, not yet processed. |
LOCKED_BY_FEES | Processed, but the user has no balance in the claim currency to cover the fees. |
PAID | Holding income executed and credits applied. |
When holding income carries fees in a currency different from the credit, it starts in LOCKED_BY_FEES and the corresponding webhook fires.
Processing flow
- A
holding-income-status-updatewebhook arrives withstatus: LOCKED_BY_FEES. - Check whether the user has the funds needed (balance in
finalClaimInfo.asset). - If they do, confirm execution by calling
POST /broker/v1/api/holdingIncome/{holdingIncomeId}. - Manteca processes it: it generates debt (for the fees) and credit (for the income received).
- Reserve those funds from the user's balance to cover the generated debt.
{
"id": "670d520139fa58ae89294c1b",
"userId": "65cfadf9da953feea0e29400",
"status": "PAID",
"type": "BOND",
"asset": "GD30",
"incomeAsset": "USD",
"amount": 5,
"finalCreditInfo": { "asset": "USD", "base": 5, "total": 5 },
"finalClaimInfo": { "asset": "ARS", "total": 124.37, "totalFees": 124.37, "holdingIncomeFee": 99, "marketRight": 4.58, "iva": 20.79 }
}Endpoint references
| Action | Endpoint |
|---|---|
| List dividends | GET /broker/v1/api/holdingIncome |
| Get dividend by ID | GET /broker/v1/api/holdingIncome/{holdingIncomeId} |
| Process dividend | POST /broker/v1/api/holdingIncome/{holdingIncomeId} |
Coupon and amortization dates for a bond are available in its instrument detail (paymentAt). See Instruments and pricing.
Updated 27 days ago
Did this page help you?