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:
NameTypeRequiredDescription
Investor-idIntegerYesInvestor’s Actor ID

Query Parameters: None

Supported formats: JSON

Request Payload: JSON request for submit order

Body Parameters:
NameTypeRequiredDescription
orderTypeStringYesLIMIT
loanIdIntegerYesUnique LC assigned id for the loan. This is the same as the id loan attribute returned in the loan Listing result operation
bidPricePercentBigDecimalYesBid 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:
NameTypeDescription
orderIdStringUnique ID of a successfully listed order
statusStringStatus of the order – values can be: PENDING, LISTED, CONFIRMED, EXECUTED, EXECUTION_FAILED, CANCELED, REJECTED
failReasonStringIf the buy order has failed, the reason for the failure will be displayed in the response
loanIdIntegerUnique LC assigned id for the loan. This is the same as the id loan attribute returned in the loan Listing result operation
bidPricePercentBigDecimalBid price percentage vs par 1.0 is 100% or par

HTTP Status Summary:
CodeDescription
200Success
400Validation or business error
401Unauthorized
403Forbidden
404Not found
452Market closed
500Unexpected 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
    }
    ]

}