​1​ Introduction

Quoine APIは、マーケットとユーザーデータに関する情報を取得するための簡単なREST APIを提供します。 Quoineは、次の2種類のAPIコンシューマへのアクセスを提供します。*オーダーの作成など、自分のアカウントの機能にアクセスするには、ユーザーAPIが推奨されます。 * App APIはアプリケーションから直接Quoine統合機能にアクセスするためのものです。

プロダクション用のベースURLはhttps://api.quoine.com/です。 すべてのレスポンスは、次のステータスコードを持つJSON形式です。

HTTP 200: OK
 応答は正しいです。 レスポンスの本文は、要求されたデータを含む。

HTTP 400: Bad Request
 リクエストにエラーがありました。 レスポンスの本文にはさらに詳しい情報があります

HTTP 401: Unauthorized
 トークンは無効です。 APIキーが間違っている場合は、401も配信されます。
 レスポンス本文を確認すると、API_KEYが無効かもしれません。。

HTTP 422: Unprocessable Entity
 これはリクエストに誤りがある場合の応答。
 レスポンスの本文にはより多くの情報があります。 考えられる理由:
  - パラメータがない
  - データの形式が間違っている

HTTP 503: Service Unavailable
 その他の場合、ボディには詳細が含まれます
 - Authyの内部エラー。
 - あなたのアプリケーションはアクセス権のないAPI呼び出しにもアクセスしています。
 - API使用制限。 APIの使用制限に達すると503が返されるので、もう一度呼び出しをかけることができるまでお待ちください。

JSON形式とXML形式の両方がすべてのAPI呼び出しでサポートされています常に形式(json | xml)を指定する必要があります/ api_keyをパラメータとして渡す必要があります。 )、それ以外の場合は、HTTPステータス401を取得します。

​2​ User API

​2.1​ Authentication(承認)

​2.1.1​ token-based(DEPRECATED) (トークンを使った方法(廃止予定))

認証は、Device、UserId、Tokenという3つのパラメータを使用して行われます。 これらのパラメータは[設定]ページから(https://accounts.quoinex.com/?continue=https://trade.quoinex.com/#/app/settings)取得できます.

これらのパラメータは、すべての要求のヘッダーにX-Quoine-Device、X-Quoine-User-Id、X-Quoine-User-Token を必要とします。

この認証方法は、新しいAPIユーザーには利用できなくなりました。 既存のユーザーはできるだけ早くシークレットベースに移行する必要があります。 トークンベースのバージョンは、未来のリリースで完全に削除されます。

​2.1.2​ Secret-based

認証は、User IDとUser Secretの2つのパラメータで実行されます。 これらのパラメータは[設定]ページから取得できます

これらのヘッダーを使用して手動で認証することも、このルビツールを使用することもできます。api_auth(Github quoineブランチ:https://github.com/chinh7/api_auth)

RequestHeaders:

例えば。 "application / json"

例えば。 "1B2M2Y8AsgTpgAmY7PhCfg =="

例えば。 "Sat、2014年9月27日04:55:17 GMT"

例えば。 "0599e5ed6cbb522053f4faf4eccfbd3a"

署名は、正規の文字列のBase64エンコードで符号化されたSHA1 HMACです。 標準文字列は、次のコンポーネントのコンマ区切りの結合です。

content-type、content-MD5、requestURI、date、nonce

例えば "application / json、1B2M2Y8AsgTpgAmY7PhCfg ==、/ api /invoices、Sat、27 Sep 2014 04:55:17 GMT、0599e5ed6cbb522053f4faf4eccfbd3a"

文字列コンポーネントをリクエストヘッダーと一致させることが重要です。 たとえば、Content-MD5がヘッダーに含まれていない場合は、正規の文字列に含めるべきではありません

​2.2​ Markets(市場)

​2.2.1​ Markets(Products)Summary

GET /products

Parameters:

Example response

[
 {
   id: "5",
   product_type: "CASH",
   code: "CASH",
   name: " CASH Trading",
   market_ask: 40039.753722,
   market_bid: 39300,
   indicator: 0,
   currency_pair_id: "3",
   currency: "JPY",
   currency_pair_code: "BTCJPY",
   symbol: "¥",
   btc_minimum_withdraw: 0.02,
   fiat_minimum_withdraw: 1500,
   taker_fee: 0.005,
   low_market_bid: 39300,
   high_market_ask: 40039.753722,
   volume_24h: 0,
   last_price_24h: 0
 },
 ...
]

​2.2.2​ Specific Market(Product)Summary

GET /products/:product_id

Parameters:

また、次の方法でも取得できます。

GET /products/code/:code/:currency_pair_code

Parameters:

Example response

{
 id: "5",
 product_type: "CASH",
 code: "CASH",
 name: " CASH Trading",
 market_ask: 40039.753722,
 market_bid: 39300,
 indicator: 0,
 currency_pair_id: "3",
 currency: "JPY",
 currency_pair_code: "BTCJPY",
 symbol: "¥",
 btc_minimum_withdraw: 0.02,
 fiat_minimum_withdraw: 1500,
 taker_fee: 0.005,
 low_market_bid: 39300,
 high_market_ask: 40039.753722,
 volume_24h: 0,
 last_price_24h: 0,
 last_traded_price: 236.07
}

​2.2.3​ Market Price Ladder(市場価格ラダー)

GET /products/:product_id/price_levels

Parameters:

Example response

{
 buy_price_levels: [
   [
     "49849.00000",
     "0.69500"
   ],
   ...
 ],
 sell_price_levels: [
   [
     "50533.00000",
     "1.47470"
   ],
   ...
 ]
}