Loans

Live Loans

GET https://api.liquid.com/loan_bids?currency={currency}

Get the live loans created.

Query Parameters

Name	Type	Description
currency	string	For example: BTC

200

{
  "models": [
    {
      "id": 3580,
      "bidask_type": "limit",
      "quantity": "0.1",
      "currency": "BTC",
      "side": "bid",
      "filled_quantity": "0.0",
      "status": "live",
      "rate": "0.0002",
      "user_id": 3020
    }
  ],
  "current_page": 1,
  "total_pages": 1
}

Loans by Currency

GET https://api.liquid.com/loans?currency={currency}

Get loans by specifying a currency.

Query Parameters

Name	Type	Description
currency	string	For example: JPY

200

{
  "models": [
    {
      "id": 144825,
      "quantity": "495.1048",
      "rate": "0.0005",
      "created_at": 1464168246,
      "lender_id": 312,
      "borrower_id": 5712,
      "status": "open",
      "currency": "JPY",
      "fund_reloaned": true
    }
  ],
  "current_page": 1,
  "total_pages": 1
}

Trade's Loan

GET https://api.liquid.com/trades/{trade_id}/loans

Get a trade's loan data e.g loan interest rate.

Path Parameters

Name	Type	Description
trade_id	string	Example trade ID:103520

200

[
  {
    "id": 103520,
    "quantity": "42.302",
    "rate": "0.0002",
    "created_at": 1461998432,
    "lender_id": 100,
    "borrower_id": 3020,
    "status": "open",
    "currency": "USD",
    "fund_reloaned": true
  }
]

Create a Loan

POST https://api.liquid.com/loan_bids

Lend your crypto to other traders by specifying quantity and rate.

Request Body

Name	Type	Description
quantity	string	{"quantity": "0.2"}
currency	string	{"currency": "BTC"}
rate	string	{"rate": "0.0001"}

200 A loan has been created.

{
    "id": 3580,
    "bidask_type": "limit",
    "quantity": "0.2",
    "currency": "BTC",
    "side": "bid",
    "filled_quantity": "0.0",
    "status": "live",
    "rate": "0.0001",
    "user_id": 3020
}

Close a Live Loan

PUT https://api.liquid.com/loan_bids/{loan_id}/close

Close a live loan by loan ID.

Path Parameters

Name	Type	Description
loan_id	string	Example of a loan ID:3580

200

{
    "id": 3580,
    "bidask_type": "limit",
    "quantity": "0.1",
    "currency": "BTC",
    "side": "bid",
    "filled_quantity": "0.0",
    "status": "closed",
    "rate": "0.0002",
    "user_id": 3020
}

Stops Re-Loaning

PUT https://api.liquid.com/loans/{loan_id}

Stops a loan from re-loaning by specifying an ID.

Path Parameters

Name	Type	Description
loan_id	string	Example of a loan ID:144825

Request Body

Name	Type	Description
fund_reloaned	string	{"fund_reloaned": "false"}

200

{
    "id": 144825,
    "quantity": "495.1048",
    "rate": "0.0005",
    "created_at": 1464168246,
    "lender_id": 312,
    "borrower_id": 5712,
    "status": "open",
    "currency": "JPY",
    "fund_reloaned": false
}