Logo

Create BUY Order

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

Unless otherwise specified, all credit and deposit products are provided by LendingClub Bank, N.A., Member FDIC, Equal Housing Lender (“LendingClub Bank”), a wholly-owned subsidiary of LendingClub Corporation, NMLS ID 167439. Credit products are subject to credit approval and may be subject to sufficient investor commitment. Credit union membership may be required. Deposit accounts are subject to approval. Deposit products are FDIC-insured up to $250,000 per depositor, per ownership category.

LendingClub,” the “LC” symbol, “TopUp,” and “DebtIQ” are trademarks of LendingClub Bank.

© 2024 LendingClub Bank. All rights reserved.