This sub-resource allows the user to purchase loans on the market, in bulk.
Operation: POST
URL: https://api.lendingclub.com/api/lcx/v1/primary/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 |
|---|---|---|---|
orderType | String | Yes | LIMIT |
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 |
Payload Schema:
{
"orderType": "LIMIT",
"items": [
{
"loanId": 113065757,
"bidPricePercent": 1
}
],
"baskets": [
{
"id": 249002,
"items": [
{
"loanId": 25476991,
"bidPricePercent": 0.97
},
{
"loanId": 25467121,
"bidPricePercent": 0.98
},
{
"loanId": 25317980,
"bidPricePercent": 0.97
},
{
"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 |
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 |
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 |
Sample Request:
https://api.lendingclub.com/api/lcx/v1/primary/investors/123123123/ /orders/buy-order
Sample Body:
{
"orderType": "LIMIT",
"items": [
{
"loanId": "181932125",
"bidPricePercent": "1.0"
}
]
}
Sample Response:
{
"orderId": 64106,
"items": [
{
"id": 76279,
"statusDate": "2020-05-26T19:10:59.179Z",
"status": "RECEIVED",
"loanId": "181932125",
"bidPricePercent": 1.0
}
]
}
Your Privacy Choices
