account_currencies

[ソース]

account_currenciesコマンドは、アカウントのトラストラインに基づいてそのアカウントが送金または受領できる通貨のリストを返します。（このリストは完全に確認されたリストではありませんが、ユーザーインターフェイスへの入力に使用できます。）

要求フォーマット

要求フォーマットの例:

WebSocket
JSON-RPC

{
   "command": "account_currencies",
   "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
   "strict": true,
   "ledger_index": "validated"
}

{
   "method": "account_currencies",
   "params": [
       {
           "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
           "account_index": 0,
           "ledger_index": "validated",
           "strict": true
       }
   ]
}

試してみる

要求には以下のパラメーターが含まれます。

`Field`	型	説明
`account`	文字列	アカウントの一意のIDであり、通常はアカウントのアドレスです。
`strict`	ブール値	（省略可） trueの場合は、アカウントパラメーターにアドレスまたは公開鍵だけを受け入れます。デフォルトではfalseです。
`ledger_hash`	文字列	（省略可）使用するレジャーバージョンの20バイトの16進文字列。（レジャーの指定を参照してください）
`ledger_index`	文字列または符号なし整数	（省略可）使用するレジャーインデックス、またはレジャーを自動的に選択するためのショートカット文字列。（レジャーの指定を参照してください）

以下のフィールドは廃止予定であるため、指定しないでください。account_index.

応答フォーマット

処理が成功した応答の例:

WebSocket
JSON-RPC

{
   "result": {
       "ledger_index": 11775844,
       "receive_currencies": [
           "BTC",
           "CNY",
           "DYM",
           "EUR",
           "JOE",
           "MXN",
           "USD",
           "015841551A748AD2C1F76FF6ECB0CCCD00000000"
       ],
       "send_currencies": [
           "ASP",
           "BTC",
           "CHF",
           "CNY",
           "DYM",
           "EUR",
           "JOE",
           "JPY",
           "MXN",
           "USD"
       ],
       "validated": true
   },
   "status": "success",
   "type": "response"
}

200 OK
{
   "result": {
       "ledger_index": 11775823,
       "receive_currencies": [
           "BTC",
           "CNY",
           "DYM",
           "EUR",
           "JOE",
           "MXN",
           "USD",
           "015841551A748AD2C1F76FF6ECB0CCCD00000000"
       ],
       "send_currencies": [
           "ASP",
           "BTC",
           "CHF",
           "CNY",
           "DYM",
           "EUR",
           "JOE",
           "JPY",
           "MXN",
           "USD"
       ],
       "status": "success",
       "validated": true
   }
}

この応答は標準フォーマットに従っており、正常に完了した場合は結果に次のフィールドが含まれています。

`Field`	型	説明
`ledger_hash`	文字列 - ハッシュ	（省略される場合があります）このデータの取得に使用するレジャーバージョンの識別用ハッシュ（16進数）。
`ledger_index`	整数 - レジャーインデックス	このデータの取得に使用するレジャーバージョンのシーケンス番号。
`receive_currencies`	文字列の配列	このアカウントが受領できる通貨の通貨コードの配列。
`send_currencies`	文字列の配列	このアカウントが送金できる通貨の通貨コードの配列。
`validated`	ブール値	`true`の場合、このデータは検証済みレジャーから取得されます。

注記: アカウントが送金または受領できる通貨は、アカウントのトラストラインのチェックに基づいて定義されます。アカウントに通貨のトラストラインがあり、残高を増額できる余裕がある場合、その通貨を受領できます。トラストラインの残高を減らせる場合、アカウントはその通貨を送金できます。このメソッドでは、トラストラインが凍結または承認されているかどうかは確認 されません 。

考えられるエラー

汎用エラータイプのすべて。
invalidParams - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。
actNotFound - 要求のaccountフィールドに指定されているアドレスが、レジャーのアカウントに対応していません。
lgrNotFound - ledger_hashまたはledger_indexで指定したレジャーが存在しないか、存在してはいるもののサーバーが保有していません。