Poloniex API解説（Lending編）

1. ビットコインとか勉強会#8
Poloniex API解説
（Lending編）
セブンバニーズ株式会社
代表取締役 古酒 慎也
@7bunnies_bot

2. Public API Methods
returnLoanOrders
https://poloniex.com/public?command=returnLoanOrders&
offers, demandsそれぞれ50件まで
GETパラメータで与えられたcurrencyのloan offersの

3. Trading API Methods
returnAvailableAccountBalances
account : exchange, margin, lending
アカウント毎の通貨別残高を返す。
accountを指定することも出来る。
marginアカウントが取得できないときはopen
margin positionやordersがあるか確認する。

4. transferBalance
Trading API Methods
アカウント間の残高を移動させる。
currency, amount, fromAccount, toAccountをPOSTパ
ラメータに指定する。

5. Trading API Methods
createLoanOffer
与えられたcurrencyでloan offerを作成する。
currency, amount, duration, autoRenew (0 or 1),
lendingRateをPOSTパラメータに指定する。
amount >= 0.01 (BTCの場合)
duration : 2~60 (days)
lendingRate : 0.0001~5 (%)

6. Trading API Methods
returnOpenLoanOffers
通貨毎に自身のopen loan offersを返す。

7. Trading API Methods
cancelLoanOffer
orderNumber :
createLoanOfferのorderID
または
returnOpenLoanOffersのid
POSTパラメータにorderNumberを指定してloan
offerをキャンセルする。

8. Trading API Methods
returnActiveLoans
通貨毎に自身のactive loansを返す。

9. Trading API Methods
returnLendingHistory
UNIX timestamps（秒）
“2017-06-02 00:00:00” => 1496329200
“2017-06-03 00:00:00” => 1496415600
自身のlending historyを期間（start, end）と件数（limit
）をPOSTパラメータに指定して取得する。
startとendはUNIX timestampsで指定する。

10. Trading API Methods
toggleAutoRenew
active loanに設定されているautoRenewの値を切り換
える。
POSTパラメータにorderNumberを指定する。
返り値のmessageの値が変更後の値となる。

11. FAQ
Question
Lendingの対象となる通貨のリストを取得する
APIはあるのか？
Answer
ない。
Lendingの対象となるのは以下の12通貨のみ。
BTC, BTS, CLAM, DASH, DOGE, ETH, FCT,
LTC, MAID, STR, XMR, XRP（アルファベット順）

12. FAQ
Question
duration=60daysのLoanがすぐに返済された。
満額もらえるのか？
Answer
もらえない。
返済された時点までのdurationで計算される。
計算結果は全て小数点8桁（端数は切り捨て）
rate x amount x duration = interest
interest x 15% = fee
interest - fee = earned（実際貰える額）

13. { id: 359558251,
currency: 'BTC',
rate: '0.00288800',
amount: '0.32617852',
duration: '0.02840000',
interest: '0.00002675',
fee: '-0.00000401',
earned: '0.00002274',
open: '2017-06-01 10:43:34',
close: '2017-06-01 11:24:27' }
returnLendingHistoryの例

14. FAQ
Question
誰が借りているのか？
Answer
ユーザー同士が貸し借りしている。
Margin TradingのLoanRateが関係している。

15. 例として、XRPのMargin Tradeする場合、
XRPをMargin Buy => BTCを借りる。
XRPをMargin Sell => XRPを借りる。
BTC及びALTのLoanRateが上昇する要因
BTCのLoanRateが高くなるとき
=> ALTがMargin Buyされている。
ALTのLoanRateが高くなるとき
=> ALTがMargin Sellされている。
Margin TradingとLendingの関係性

16. FAQ
Question
LoanDemandsとは？
Answer
LoanOffersのBestRate以下でMargin Buy or Margin Sell
すると、LoanDemandsに表示される。
createLoanOfferでLoanDemandsに表示されている
LoanRateをorderすれば即約定する。

17. FAQ
Question
openLoanOffersが約定するタイミングは？
Answer
BTCのopenLoanOffersの場合、ALTのMargin Buyが約定
したときに、その注文のLoanRate以下の
openLoanOffersがAmount分だけ約定する。