Create Buy Order
This sub-resource allows the user to purchase loans on the market, in bulk.
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
- {
- ]
}
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"
]
}
{
- "orderId": 64106,
- "items": [
{- "id": 76279,
- "statusDate": "2020-05-26T19:10:59.179Z",
- "status": "RECEIVED",
- "loanId": "181932125",
- "bidPricePercent": 1.0
]
}