Create Buy Order

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
  }
  ]

}