This sub-resource allows the user to purchase loans on LCX SM.
Operation: POST
URL: https://api.lendingclub.com/api/lcx/v1/secondary/investors/{investor-id}/orders/buy-order
Path Parameters:
Name | Type | Required | Description |
---|---|---|---|
Investor-id | Integer | Yes | Investor’s Actor ID |
Query Parameters: None
Supported formats: JSON
Request Payload: JSON request for submit order
Body Parameters:
Name | Type | Required | Description |
---|---|---|---|
investorId | Integer | Yes | The unique id of the investor account |
orderType | String | Yes | LIMIT |
noteId | Integer | Yes | Unique LC assigned id for the Note |
loanId | Integer | Yes | Unique LC assigned id for the loan. This is the same as the id loan attribute returned in the loan Listing result operation |
bidPricePercent | BigDecimal | Yes | Bid price percentage vs par 1.0 is 100% or par |
Basket Parameters:
In a buy order request, the user can bid on individual and basket orders at the same time.
In a basket section, for each basket the user intends to buy, the user must match id for the basket. For each item in the basket, the user must provide noteId, loanId and bidPricePercent. No items in a basket can be excluded for the bid to be accepted.
In a basket sale bid, if an item fails or is rejected for any reason, the bid on the whole basket will follow.
If any item has a new price in a basket, the entire basket enters a random window for 15 minutes.
Payload Schema:
{
"orderType": "LIMIT",
“roomName” : “ROOM-123”,
"items": [
{
"noteId": 162194222,
"loanId": 113065757,
"bidPricePercent": 1
}
],
"baskets": [
{
"id": 249002,
"items": [
{
"noteId": 55913782
"loanId": 25476991,
"bidPricePercent": 0.97
},
{
"noteId": 56002388
"loanId": 25467121,
"bidPricePercent": 0.98
},
{
"noteId": 55844949
"loanId": 25317980,
"bidPricePercent": 0.97
},
{
"noteId": 55532800
"loanId": 25216385,
"bidPricePercent": 0.99
}
]
}
]
}
Response Parameters:
Name | Type | Description |
---|---|---|
orderId | String | Unique ID of a successfully listed order |
status | String | Status of the order – values can be: PENDING LISTED CONFIRMED EXECUTED EXECUTION_FAILED CANCELED REJECTED |
failReason | String | If the buy order has failed, the reason for the failure will be displayed in the response |
noteId | Integer | Unique LC assigned ID for the Note |
loanId | Integer | Unique LC assigned id for the loan. This is the same as the id loan attribute returned in the loan Listing result operation |
bidPricePercent | BigDecimal | Bid price percentage vs par 1.0 is 100% or par |
Sample Response:
{
"statusDate": "2019-12-05T20:56:08.987Z",
"status": "CONFIRMED",
"failReason": null,
"noteId": "2025901",
"loanId": "544084",
"bidPricePercent": 1.00
}
HTTP status summary:
Code | Description |
---|---|
200 | Success |
400 | Validation or business error |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
452 | Market closed |
500 | Unexpected failure |