# ledger_entry

[[ソース]](https://github.com/xrplf/rippled/blob/master/src/ripple/rpc/handlers/LedgerEntry.cpp)

`ledger_entry`メソッドは、XRP Ledgerの1つのレジャーエントリを生フォーマットで返します。取得可能な各種エントリについては、[レジャーフォーマット](/ja/docs/references/protocol/ledger-data/ledger-entry-types)をご覧ください。

## リクエストのフォーマット

このメソッドは複数の異なる種類のデータを取得することができます。以下に記載されている一般的なフィールドと特定のタイプのフィールドで構成される適切なパラメータを渡し、標準の[リクエストのフォーマット](/ja/docs/references/http-websocket-apis/api-conventions/request-formatting)に従うことで、取得するアイテムの種類を選択できます。(例えば、WebSocketリクエストは常に`command`フィールドとオプションで`id`フィールドを持ち、JSON-RPCリクエストは`method`フィールドと`params`フィールドを使います)。

注記
このメソッドにはコマンドライン構文がありません。代わりに[jsonメソッド](/ja/docs/references/http-websocket-apis/public-api-methods/utility-methods/json)を使って、コマンドラインからこのメソッドにアクセスすることができます。

### 一般的なフィールド

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `binary` | ブール値 | *（省略可）* `true`の場合、リクエストしたレジャーエントリの内容がXRP Ledgerの[バイナリ形式](/ja/docs/references/protocol/binary-format)の16進数の文字列として返されます。それ以外の場合はデータがJSONフォーマットで返されます。デフォルトは`false`です。更新: rippled 1.2.0 |
| `ledger_hash` | 文字列 | *（省略可）* 使用するレジャーバージョンの20バイトの16進数の文字列。（[レジャーの指定](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%81%AE%E6%8C%87%E5%AE%9A)をご覧ください。 |
| `ledger_index` | 文字列 または 符号なし整数 | *（省略可）* 使用するレジャーの[レジャーインデックス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%82%A4%E3%83%B3%E3%83%87%E3%83%83%E3%82%AF%E3%82%B9)、またはレジャーを自動的に選択するためのショートカット文字列("validated"や"closed"、"current"など)。（[レジャーの指定](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%81%AE%E6%8C%87%E5%AE%9A)をご覧ください。 |
| `include_deleted` | 真偽値 | *(省略可, Clioサーバのみ)* クエリされたオブジェクトが削除されている場合、その完全なデータを削除前の状態で返します。`false`または提供されていない場合、クエリされたオブジェクトが削除されている場合は`objectNotFound`を返します。 |


`generator`と`ledger`パラメータは非推奨であり、予告なく削除される可能性があります。

上記の一般的なフィールドに加えて、エントリを取得するタイプを示すために、以下のフィールドのうち *正確に1つ* を指定する必要があります。有効なフィールドは以下のとおりです。

- [ledger_entry](#ledger_entry)
  - [リクエストのフォーマット](#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%AE%E3%83%95%E3%82%A9%E3%83%BC%E3%83%9E%E3%83%83%E3%83%88)
    - [一般的なフィールド](#%E4%B8%80%E8%88%AC%E7%9A%84%E3%81%AA%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)
    - [IDからレジャーエントリを取得する](#id%E3%81%8B%E3%82%89%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%82%AA%E3%83%B3%E3%83%88%E3%83%AA%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [AccountRootエントリを取得する](#accountroot%E3%82%A8%E3%83%B3%E3%83%88%E3%83%AA%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [AMMエントリを取得する](#amm%E3%82%A8%E3%83%B3%E3%83%88%E3%83%AA%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [Bridgeエントリを取得する](#bridge%E3%82%A8%E3%83%B3%E3%83%88%E3%83%AA%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [Credentialエントリを取得する](#credential%E3%82%A8%E3%83%B3%E3%83%88%E3%83%AA%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [Directorynodeエントリを取得する](#directorynode%E3%82%A8%E3%83%B3%E3%83%88%E3%83%AA%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [Offerエントリを取得する](#offer%E3%82%A8%E3%83%B3%E3%83%88%E3%83%AA%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [Oracleエントリを取得する](#oracle%E3%82%A8%E3%83%B3%E3%83%88%E3%83%AA%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [RippleStateエントリを取得する](#ripplestate%E3%82%A8%E3%83%B3%E3%83%88%E3%83%AA%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [Checkエントリを取得する](#check%E3%82%A8%E3%83%B3%E3%83%88%E3%83%AA%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [Escrowエントリを取得する](#escrow%E3%82%A8%E3%83%B3%E3%83%88%E3%83%AA%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [Paychannelエントリを取得する](#paychannel%E3%82%A8%E3%83%B3%E3%83%88%E3%83%AA%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [DepositPreauthエントリを取得する](#depositpreauth%E3%82%A8%E3%83%B3%E3%83%88%E3%83%AA%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [Ticketエントリを取得する](#ticket%E3%82%A8%E3%83%B3%E3%83%88%E3%83%AA%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [Nft Pageを取得する](#nft-page%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [MPT Issuanceオブジェクトを取得する](#mpt-issuance%E3%82%AA%E3%83%96%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
    - [MPTokenオブジェクトを取得する](#mptoken%E3%82%AA%E3%83%96%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%82%92%E5%8F%96%E5%BE%97%E3%81%99%E3%82%8B)
  - [レスポンスのフォーマット](#%E3%83%AC%E3%82%B9%E3%83%9D%E3%83%B3%E3%82%B9%E3%81%AE%E3%83%95%E3%82%A9%E3%83%BC%E3%83%9E%E3%83%83%E3%83%88)
  - [考えられるエラー](#%E8%80%83%E3%81%88%E3%82%89%E3%82%8C%E3%82%8B%E3%82%A8%E3%83%A9%E3%83%BC)


リクエストでこれらの型固有のフィールドを1つ以上指定した場合、サーバはそのうちの1つだけの結果を取得します。サーバがどれを選択するかは定義されていないため、こうした指定方法は避けるべきです。

### IDからレジャーエントリを取得する



ユニークな ID を使用して、任意のタイプのレジャーエントリを取得します。

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `index` | 文字列 | レジャーから取得する1エントリの[レジャーエントリID](/ja/docs/references/protocol/ledger-data/common-fields)を、64文字(256ビット)の16進数の文字列。 |


WebSocket

```json
{
  "command": "ledger_entry",
  "index": "7DB0788C020F02780A673DC74757F23823FA3014C1866E72CC4CD8B226CD6EF4",
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
    "method": "ledger_entry",
    "params": [
        {
            "index": "7DB0788C020F02780A673DC74757F23823FA3014C1866E72CC4CD8B226CD6EF4",
            "ledger_index": "validated"
        }
    ]
}
```

コマンドライン

```sh
rippled json ledger_entry '{ "index": "7DB0788C020F02780A673DC74757F23823FA3014C1866E72CC4CD8B226CD6EF4", "ledger_index": "validated" }'
```

ヒント
このタイプのリクエストは、レジャーデータにシングルトンエントリが存在する場合、そのIDは常に同一であるため、任意のシングルトンエントリを取得するために使用できます。たとえば

- [`Amendments`](/ja/docs/references/protocol/ledger-data/ledger-entry-types/amendments) - `7DB0788C020F02780A673DC74757F23823FA3014C1866E72CC4CD8B226CD6EF4`
- [`FeeSettings`](/ja/docs/references/protocol/ledger-data/ledger-entry-types/feesettings) - `4BC50C9B0D8515D3EAAE1E74B29A95804346C491EE1A95BF25E4AAB854A6A651`
- [直近の`LedgerHashes`](/ja/docs/references/protocol/ledger-data/ledger-entry-types/ledgerhashes) - `B4979A36CDC7F3D3D5C31A4EAE2AC7D7209DDA877588B9AFC66799692AB0D66B`
- [`NegativeUNL`](/ja/docs/references/protocol/ledger-data/ledger-entry-types/negativeunl) - `2E8A59AA9D3B5B186B0B9E0F62E6C02587CA74A4D778938E957B6357D364B244`


### AccountRootエントリを取得する



アドレスから[AccountRootエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/accountroot)を取得します。これは[account_infoメソッド](/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/account_info)とほぼ同じです。

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `account_root` | 文字列 - [アドレス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9) | 取得する[AccountRootエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/accountroot)の標準アドレス。 |


WebSocket

```json
{
  "id": "example_get_accountroot",
  "command": "ledger_entry",
  "account_root": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
    "method": "ledger_entry",
    "params": [
        {
            "account_root": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
            "ledger_index": "validated"
        }
    ]
}
```

コマンドライン

```sh
rippled json ledger_entry '{ "account_root": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "ledger_index": "validated" }'
```

### AMMエントリを取得する



AMM
レジャーからAutomated Market-Maker(AMM)エントリを取得します。これは[amm_infoメソッド](/ja/docs/references/http-websocket-apis/public-api-methods/path-and-order-book-methods/amm_info)と似ていますが、`ledger_entry`は保存されているレジャーエントリのみを返します。

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `amm` | オブジェクトまたは文字列 | 取得する[AMM](/ja/docs/references/protocol/ledger-data/ledger-entry-types/amm)。文字列を指定する場合は、AMMの[レジャーエントリID](/ja/docs/references/protocol/ledger-data/common-fields)を16進数で指定しなければなりません。エントリを指定する場合は、`asset`と`asset2`のサブフィールドを含む必要があります。 |
| `amm.asset` | オブジェクト | このAMMのプールにある2つの資産のうちのひとつを、[金額なしの通貨エントリ](/ja/docs/references/protocol/data-types/currency-formats#%E9%87%91%E9%A1%8D%E3%81%AA%E3%81%97%E3%81%A7%E3%81%AE%E9%80%9A%E8%B2%A8%E3%81%AE%E6%8C%87%E5%AE%9A)として指定します。 |
| `amm.asset2` | オブジェクト | このAMMのプールにある2つの資産のうちのもうひとつを、[金額なしの通貨エントリ](/ja/docs/references/protocol/data-types/currency-formats#%E9%87%91%E9%A1%8D%E3%81%AA%E3%81%97%E3%81%A7%E3%81%AE%E9%80%9A%E8%B2%A8%E3%81%AE%E6%8C%87%E5%AE%9A)として指定します。 |


WebSocket

```json
{
  "id": 3,
  "command": "ledger_entry",
  "amm": {
    "asset": {
      "currency": "XRP"
    },
    "asset2": {
      "currency" : "TST",
      "issuer" : "rP9jPyP5kyvFRb6ZiRghAGw5u8SGAmU4bd"
    }
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
    "method": "ledger_entry",
    "params": [
        {
          "amm": {
            "asset": {
              "currency": "XRP"
            },
            "asset2": {
              "currency" : "TST",
              "issuer" : "rP9jPyP5kyvFRb6ZiRghAGw5u8SGAmU4bd"
            }
          },
          "ledger_index": "validated"
        }
    ]
}
```

Commandline

```sh
rippled json ledger_entry '{ "amm": { "asset": { "currency": "XRP" }, "asset2": { "currency" : "TST", "issuer" : "rP9jPyP5kyvFRb6ZiRghAGw5u8SGAmU4bd" } }, "ledger_index": "validated" }'
```

### Bridgeエントリを取得する



*([XChainBridge amendment](/ja/resources/known-amendments#xchainbridge)が必要です　)*

XRP Ledgerを他のブロックチェーンに接続する1つのクロスチェーンブリッジを表す[Bridgeエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/bridge)を取得します。

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `bridge_account` | 文字列 | ブロックチェーン上で`XChainCreateBridge`トランザクションを送信したアカウント。 |
| `bridge` | オブジェクト | 取得する[ブリッジ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/bridge)。ドアアカウントと発行・ロックチェーンの資産の情報を含みます。 |


WebSocket

```json
{
  "id": "example_get_bridge",
  "command": "ledger_entry",
  "bridge_account": "rnQAXXWoFNN6PEqwqsdTngCtFPCrmfuqFJ",
  "bridge": {
    "IssuingChainDoor": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
    "IssuingChainIssue": {
      "currency": "XRP"
    },
    "LockingChainDoor": "rnQAXXWoFNN6PEqwqsdTngCtFPCrmfuqFJ",
    "LockingChainIssue": {
      "currency": "XRP"
    }
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
    "method": "ledger_entry",
    "params": [
        {
            "bridge_account": "rnQAXXWoFNN6PEqwqsdTngCtFPCrmfuqFJ",
            "bridge": {
                "IssuingChainDoor": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
                "IssuingChainIssue": {
                    "currency": "XRP"
                },
                "LockingChainDoor": "rnQAXXWoFNN6PEqwqsdTngCtFPCrmfuqFJ",
                "LockingChainIssue": {
                    "currency": "XRP"
                }
            },
            "ledger_index": "validated"
        }
    ]
}
```

コマンドライン

```sh
rippled json ledger_entry '{ "bridge_account": "rnQAXXWoFNN6PEqwqsdTngCtFPCrmfuqFJ", "bridge": { "IssuingChainDoor": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh", "IssuingChainIssue": { "currency": "XRP" }, "LockingChainDoor": "rnQAXXWoFNN6PEqwqsdTngCtFPCrmfuqFJ", "LockingChainIssue": { "currency": "XRP" } }, "ledger_index": "validated" }'
```

### Credentialエントリを取得する

[Credentialエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/credential)を取得します。

| フィールド | 型 | 必須? | 説明 |
|  --- | --- | --- | --- |
| `credential` | オブジェクト または 文字列 | はい | 取得する[Credentialエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/credential)を指定します。文字列の場合は、エントリの[レジャーエントリID](/ja/docs/references/protocol/ledger-data/common-fields)を16進数で指定します。オブジェクトの場合は、`subject`, `issuer`, `credential_type`のサブフィールドが必要です。 |
| `credential.subject` | 文字列 - [Address][] | はい | 資格情報の対象となるアカウント。 |
| `credential.issuer` | 文字列 -  [Address][] | はい | 資格情報を発行したアカウント。 |
| `credential.credential_type` | 文字列 - 16進数文字列 | はい | 資格情報の種類。 |


WebSocket:


```json
{
  "id": "example_get_credential",
  "command": "ledger_entry",
  "credential": {
    "subject": "rsUiUMpnrgxQp24dJYZDhmV4bE3aBtQyt8",
    "issuer": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
    "credential_type": "6D795F63726564656E7469616C"
  },
  "ledger_index": "validated"
}
```

JSON-RPC:


```json
{
  "method": "ledger_entry",
  "params": [{
    "credential": {
      "subject": "rsUiUMpnrgxQp24dJYZDhmV4bE3aBtQyt8",
      "issuer": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
      "credential_type": "6D795F63726564656E7469616C"
    },
    "ledger_index": "validated"
  }]
}
```

Commandline:


```bash
rippled json ledger_entry '{ "credential": {"subject": "rsUiUMpnrgxQp24dJYZDhmV4bE3aBtQyt8", "issuer": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX","credential_type": "6D795F63726564656E7469616C"}, "ledger_index": "validated" }'
```

### DirectoryNodeエントリを取得する



他のレジャーエントリのリストを含む[DirectoryNode](/ja/docs/references/protocol/ledger-data/ledger-entry-types/directorynode)を取得します。文字列(DirectoryのレジャーエントリID)またはオブジェクトを指定します。

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `directory` | オブジェクト または 文字列 | 取得する[DirectoryNode](/ja/docs/references/protocol/ledger-data/ledger-entry-types/directorynode)。文字列の場合は、ディレクトリの[レジャーエントリID](/ja/docs/references/protocol/ledger-data/common-fields)を16進数で指定します。オブジェクトの場合は、サブフィールドとして`dir_root`または`owner`が必要で、オプションとして`sub_index`サブフィールドを指定可能です。 |
| `directory.sub_index` | 符号なし整数 | *(省略可)* 指定された場合、その"ページ"以降の[DirectoryNode](/ja/docs/references/protocol/ledger-data/ledger-entry-types/directorynode)にジャンプします。 |
| `directory.dir_root` | 文字列 | *(省略可)* 取得するディレクトリを表す一意のインデックス。 |
| `directory.owner` | 文字列 | *(省略可)* このディレクトリに関連付けられているアカウントの一意のアドレス。 |


WebSocket

```json
{
  "id": 3,
  "command": "ledger_entry",
  "directory": {
    "owner": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
    "sub_index": 0
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
    "method": "ledger_entry",
    "params": [
        {
            "directory": {
              "owner": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
              "sub_index": 0
            },
            "ledger_index": "validated"
        }
    ]
}
```

コマンドライン

```sh
rippled json ledger_entry '{ "directory": { "owner": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "sub_index": 0 }, "ledger_index": "validated" }'
```

### Offerエントリを取得する



通貨交換のオファーを定義した [Offer エントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/offer) を取得します。文字列 (オファーの一意なインデックス) あるいはオブジェクトを指定します。

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `offer` | オブジェクトまたは 文字列 | 取得する[オファーエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/offer)。文字列の場合、オファーに対する[一意のレジャーエントリID](/ja/docs/references/protocol/ledger-data/common-fields)を指定します。レジャーエントリの場合、オファーを一意に識別するためのサブフィールド`account`と`seq`を指定します。 |
| `offer.account` | 文字列 - [アドレス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9) | *(`offer`がオブジェクト形式で指定されている場合、必須)* オファーを作成したアカウント。 |
| `offer.seq` | 符号なし整数 | *(`offer`がオブジェクト形式で指定されている場合、必須)* オファーエントリを作成したトランザクションの[シーケンス番号](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E3%82%B7%E3%83%BC%E3%82%B1%E3%83%B3%E3%82%B9)。 |


WebSocket

```json
{
  "id": "example_get_offer",
  "command": "ledger_entry",
  "offer": {
    "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
    "seq": 359
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [
    {
      "offer": {
        "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
        "seq": 359
      },
      "ledger_index": "validated"
    }
  ]
}
```

コマンドライン

```sh
rippled json ledger_entry '{ "offer": { "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "seq": 359}, "ledger_index": "validated" }'
```

### Oracleエントリを取得する

*([PriceOracle amendment](/ja/resources/known-amendments#priceoracle)が必要です)*

[Oracleエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/oracle)を取得します。これは、トークン価格を保存できる単一の価格オラクルを表します。

| フィールド | 型 | 必須? | 説明 |
|  --- | --- | --- | --- |
| `oracle` | Object | はい | オラクルの識別子。 |
| `oracle.account` | String - [Address][] | はい | `Oracle`オブジェクトを制御するアカウント。 |
| `oracle.oracle_document_id` | Number | はい | `Account`のオラクルの一意の識別子。 |


WebSocket

```json
{
  "id": "example_get_oracle",
  "command": "ledger_entry",
  "oracle" : {
    "account": "rNZ9m6AP9K7z3EVg6GhPMx36V4QmZKeWds",
    "oracle_document_id":  34
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params" : [
    {
      "oracle" : {
        "account": "rNZ9m6AP9K7z3EVg6GhPMx36V4QmZKeWds",
        "oracle_document_id":  34
      },
      "ledger_index": "validated"
    }
  ]
}
```

Commandline

```sh
rippled json ledger_entry '{ "oracle": { "account": "rNZ9m6AP9K7z3EVg6GhPMx36V4QmZKeWds", "oracle_document_id": 34 }, "ledger_index": "validated" }'
```

[試してみる >](/resources/dev-tools/websocket-api-tool?server=wss%3A%2F%2Fs.devnet.rippletest.net%3A51233%2F#ledger_entry-oracle)

### RippleStateエントリを取得する



2つのアカウント間の（XRP以外の）通貨残高を追跡する[RippleStateエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/ripplestate)を取得します。

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `ripple_state` | オブジェクト | 取得するRippleState(trust line)エントリを指定するレジャーエントリ。取得するRippleStateエントリを一意に指定するには、`accounts`と`currency`のサブフィールドが必要です。 |
| `ripple_state.accounts` | 配列 | *(`ripple_state`が指定されている場合、必須)* この[RippleStateエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/ripplestate)によってリンクされた2つのアカウントを長さ2の配列で指定します。 |
| `ripple_state.currency` | 文字列 | *(`ripple_state`が指定されている場合、必須)* 取得する[RippleStateエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/ripplestate)の[通貨コード](/ja/docs/references/protocol/data-types/currency-formats#%E9%80%9A%E8%B2%A8%E3%82%B3%E3%83%BC%E3%83%89)を指定します。 |


WebSocket

```json
{
  "id": "example_get_ripplestate",
  "command": "ledger_entry",
  "ripple_state": {
    "accounts": [
      "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
      "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW"
    ],
    "currency": "USD"
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "ripple_state": {
      "accounts": [
        "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
        "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW"
      ],
      "currency": "USD"
    },
    "ledger_index": "validated"
  }]
}
```

コマンドライン

```sh
rippled json ledger_entry '{ "ripple_state": { "accounts": ["rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW"], "currency": "USD"}, "ledger_index": "validated" }'
```

### Checkエントリを取得する



[Checkエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/check)を取得します。新規: rippled 1.0.0.

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `check` | 文字列 | 取得する[Checkエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/check)の[レジャーエントリID](/ja/docs/references/protocol/ledger-data/common-fields)。 |


WebSocket

```json
{
  "id": "example_get_check",
  "command": "ledger_entry",
  "check": "C4A46CCD8F096E994C4B0DEAB6CE98E722FC17D7944C28B95127C2659C47CBEB",
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "check": "C4A46CCD8F096E994C4B0DEAB6CE98E722FC17D7944C28B95127C2659C47CBEB",
    "ledger_index": "validated"
  }]
}
```

コマンドライン

```sh
rippled json ledger_entry '{ "check": "C4A46CCD8F096E994C4B0DEAB6CE98E722FC17D7944C28B95127C2659C47CBEB", "ledger_index": "validated" }'
```

### Escrowエントリを取得する



[Escrowエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/escrow)を取得します。文字列(エスクローのエントリID)またはオブジェクトとして指定します。新規: rippled 1.0.0

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `escrow` | オブジェクト または 文字列 | 取得する[Escrowエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/escrow)を指定します。文字列の場合は、エスクローの[レジャーエントリID](/ja/docs/references/protocol/ledger-data/common-fields)を16進数で指定します。オブジェクトの場合、`owner`と`seq`サブフィールドを指定します。. |
| `escrow.owner` | 文字列 - [アドレス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9) | *(`escrow`がオブジェクト形式で指定されている場合、必須)* Escrowエントリの所有者（送信者）。 |
| `escrow.seq` | 符号なし整数 | *(`escrow`がオブジェクト形式で指定されている場合、必須)* エスクローエントリを作成したトランザクションの[シーケンス番号](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E3%82%B7%E3%83%BC%E3%82%B1%E3%83%B3%E3%82%B9)。 |


WebSocket

```json
{
  "id": "example_get_escrow",
  "command": "ledger_entry",
  "escrow": {
    "owner": "rL4fPHi2FWGwRGRQSH7gBcxkuo2b9NTjKK",
    "seq": 126
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "escrow": {
      "owner": "rL4fPHi2FWGwRGRQSH7gBcxkuo2b9NTjKK",
      "seq": 126
    },
    "ledger_index": "validated"
  }]
}
```

コマンドライン

```sh
rippled json ledger_entry '{ "escrow": { "owner": "rL4fPHi2FWGwRGRQSH7gBcxkuo2b9NTjKK", "seq": 126 }, "ledger_index": "validated" }'
```

### PayChannelエントリを取得する


非同期決済用のXRPを保持する[PayChannelエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/paychannel)を取得します。新規: rippled 1.0.0.

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `payment_channel` | 文字列 | 取得する[PayChannelエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/paychannel)の[エントリID](/ja/docs/references/protocol/ledger-data/common-fields)。 |


WebSocket

```json
{
  "id": "example_get_paychannel",
  "command": "ledger_entry",
  "payment_channel": "C7F634794B79DB40E87179A9D1BF05D05797AE7E92DF8E93FD6656E8C4BE3AE7",
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "payment_channel": "C7F634794B79DB40E87179A9D1BF05D05797AE7E92DF8E93FD6656E8C4BE3AE7",
    "ledger_index": "validated"
  }]
}
```

コマンドライン

```sh
rippled json ledger_entry '{ "payment_channel": "C7F634794B79DB40E87179A9D1BF05D05797AE7E92DF8E93FD6656E8C4BE3AE7", "ledger_index": "validated" }'
```

### DepositPreauthエントリを取得する



[DepositPreauthエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/depositpreauth)を取得します。このエントリは、[Deposit Authorization](/ja/docs/concepts/accounts/depositauth)を必要とする口座への支払いの事前承認を記録します。文字列（DepositPreauthのエントリID）またはオブジェクトとして指定します。

| フィールド | 型 | 必須? | 説明 |
|  --- | --- | --- | --- |
| `deposit_preauth` | オブジェクト または 文字列 | はい | 取得するDepositPreauthを指定します。文字列の場合は、DepositPreauthエントリの[レジャーエントリID][]を16進数で指定する必要があります。オブジェクトの場合は、`owner`サブフィールドと、`authorized`または`authorize_credentials`サブフィールドのいずれかが必要です。 |
| `deposit_preauth.owner` | 文字列 - [アドレス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9) | はい | 事前承認を行ったアカウント |
| `deposit_preauth.authorized` | 文字列 - [アドレス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9) | いいえ | 事前承認を受けたアカウント。 |
| `deposit_preauth.authorized_credentials` | 配列 | いいえ | 事前承認を受けた資格情報のセット |


`deposit_preauth.authorized_credentials`配列の各メンバは、提供されている場合、次のネストされたフィールドを含める必要があります。

| フィールド | 型 | 必須? | 説明 |
|  --- | --- | --- | --- |
| `issuer` | 文字列 - [アドレス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9) | はい | 資格情報の発行アカウントのアドレス |
| `credential_type` | 文字列 - 16進数 | はい | 発行された資格情報のタイプ |


WebSocket

```json
{
  "id": "example_get_deposit_preauth",
  "command": "ledger_entry",
  "deposit_preauth": {
    "owner": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
    "authorized": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX"
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "deposit_preauth": {
      "owner": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
      "authorized": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX"
    },
    "ledger_index": "validated"
  }]
}
```

コマンドライン

```sh
rippled json ledger_entry '{ "deposit_preauth": { "owner": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "authorized": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX" }, "ledger_index": "validated" }'
```

### Ticketエントリを取得する



将来の使用のために確保された[シーケンス番号](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E3%82%B7%E3%83%BC%E3%82%B1%E3%83%B3%E3%82%B9)を表す[Ticketエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/ticket)を取得します。文字列(TicketのエントリID)またはオブジェクトを指定します。 

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `ticket` | エントリ または 文字列 | 取得する[Ticketエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/ticket)。文字列の場合、チケットの[レジャーエントリID](/ja/docs/references/protocol/ledger-data/common-fields)を16進数で指定します。オブジェクトの場合、チケットエントリを一意に指定するために`account`と`ticket_seq`サブフィールドを指定します。 |
| `ticket.account` | 文字列 - [アドレス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9) | *(`ticket`がオブジェクト形式で指定されている場合、必須)* Ticketエントリの所有者を指定します。 |
| `ticket.ticket_seq` | 数値 | *(`ticket`がオブジェクト形式で指定されている場合、必須)* 取得するTicketのTicketシーケンス番号を指定します。 |


WebSocket

```json
{
  "id": "example_get_ticket",
  "command": "ledger_entry",
  "ticket": {
    "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
    "ticket_seq": 389
  },
  "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "ticket": {
      "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
      "ticket_seq": 389
    },
    "ledger_index": "validated"
  }]
}
```

コマンドライン

```sh
rippled json ledger_entry '{ "ticket": { "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "ticket_seq: 389 }, "ledger_index": "validated" }'
```

### NFT Pageを取得する



NFT ページを生のレジャー形式で取得します。

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `nft_page` | 文字列 | 取得する[NFTページ](/ja/docs/references/protocol/ledger-data/ledger-entry-types/nftokenpage)の[レジャーエントリID](/ja/docs/references/protocol/ledger-data/common-fields)。 |


WebSocket

```json
{
    "id": "example_get_nft_page",
    "command": "ledger_entry",
    "nft_page": "255DD86DDF59D778081A06D02701E9B2C9F4F01DFFFFFFFFFFFFFFFFFFFFFFFF",
    "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "nft_page": "255DD86DDF59D778081A06D02701E9B2C9F4F01DFFFFFFFFFFFFFFFFFFFFFFFF",
    "ledger_index": "validated"
  }]
}
```

コマンドライン

```sh
rippled json ledger_entry '{ "nft_page": "255DD86DDF59D778081A06D02701E9B2C9F4F01DFFFFFFFFFFFFFFFFFFFFFFFF", "ledger_index": "validated" }'
```

### MPT Issuanceオブジェクトを取得する

*([MPTokensV1 amendment](/ja/resources/known-amendments#mptokensv1)が必要です。 )*

`MPTokenIssuance`オブジェクトを返します。

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `mpt_issuance` | 文字列 | 192ビットの`MPTokenIssuanceID`を16進文字列で指定。 |


WebSocket

```json
{
    "id": "example_get_mpt_issuance",
    "command": "ledger_entry",
    "mpt_issuance": "000004C463C52827307480341125DA0577DEFC38405B0E3E",
    "ledger_index": "validated"
}
```

JSON-RPC

```json
{
  "method": "ledger_entry",
  "params": [{
    "mpt_issuance": "000004C463C52827307480341125DA0577DEFC38405B0E3E",
    "ledger_index": "validated"
  }]
}
```

Commandline

```sh
rippled json ledger_entry '{ "mpt_issuance": "000004C463C52827307480341125DA0577DEFC38405B0E3E", "ledger_index": "validated" }'
```

### MPTokenオブジェクトを取得する

*([MPTokensV1 amendment](/ja/resources/known-amendments#mptokensv1)が必要です。 )*

`MPToken`オブジェクトを返します。

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `mptoken` | オブジェクトまたは文字列 | 文字列の場合、取得するMPTokenのレジャーエントリIDとして解釈します。オブジェクトの場合、`MPToken`を一意に識別するために、`account`と`mpt_issuance_id`のサブフィールドが必要です。 |
| mptoken.mpt_issuance_id | 文字列 | (`MPToken`がオブジェクトの場合必須) MPTokenIssuanceに紐づく192ビットのMPTokenIssuanceID。 |
| mptoken.account	️ | 文字列 | (`MPToken`がオブジェクトの場合必須) MPTokenの所有者のアカウント。 |


WebSocket

```json
{
    "id": "example_get_mpt_issuance",
    "command": "ledger_entry",
    "mptoken": {
      "mpt_issuance_id": "000002DFA4D893CFBC4DC6AE877EB585F90A3B47528B958D",
      "account":"r33kves44ksufkHSGg3M6GPPAsoVHEN8C1"
    }
}
```

JSON-RPC

```json
{
    "method": "ledger_entry",
    "params": [
        {
            "mptoken":{
                "mpt_issuance_id": "000002DFA4D893CFBC4DC6AE877EB585F90A3B47528B958D",
                "account":"r33kves44ksufkHSGg3M6GPPAsoVHEN8C1"
            } 
        }
    ]
}
```

Commandline

```sh
rippled json ledger_entry '{ "mptoken": {"mpt_issuance_id": "000002DFA4D893CFBC4DC6AE877EB585F90A3B47528B958D", "account":"r33kves44ksufkHSGg3M6GPPAsoVHEN8C1"} }'
```

## レスポンスフォーマット

レスポンスは[標準フォーマット](/ja/docs/references/http-websocket-apis/api-conventions/response-formatting)に従い、成功した結果には次のフィールドが含まれます。

| フィールド | 型 | 説明 |
|  --- | --- | --- |
| `index` | 文字列 | [レジャーエントリ](/ja/docs/references/protocol/ledger-data/ledger-entry-types)の一意のID。 |
| `ledger_index` | 符号なし整数 | このデータを取得する際に使用したレジャーの [レジャーインデックス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%82%A4%E3%83%B3%E3%83%87%E3%83%83%E3%82%AF%E3%82%B9)。 |
| `node` | オブジェクト | *(`"binary": true`が指定されている場合、省略)* [レジャーフォーマット](/ja/docs/references/protocol/ledger-data/ledger-entry-types)に基づいた、このレジャーエントリのデータを含むエントリ。 |
| `node_binary` | 文字列 | *(`"binary": true`が指定されていない場合、省略)* レジャーエントリの[バイナリ形式](/ja/docs/references/protocol/binary-format)を16進数で表したもの。 |
| `deleted_ledger_index` | 文字列 | *(Clioサーバのみ, `include_deleted`パラメータが設定されている場合のみ)* レジャーエントリオブジェクトが削除された[レジャーインデックス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%AC%E3%82%B8%E3%83%A3%E3%83%BC%E3%82%A4%E3%83%B3%E3%83%87%E3%83%83%E3%82%AF%E3%82%B9)。 |


成功したレスポンスの例:

WebSocket

```json
{
  "id": "example_get_accountroot",
  "result": {
    "index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
    "ledger_hash": "31850E8E48E76D1064651DF39DF4E9542E8C90A9A9B629F4DE339EB3FA74F726",
    "ledger_index": 61966146,
    "node": {
      "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
      "AccountTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
      "Balance": "424021949",
      "Domain": "6D64756F31332E636F6D",
      "EmailHash": "98B4375E1D753E5B91627516F6D70977",
      "Flags": 9568256,
      "LedgerEntryType": "AccountRoot",
      "MessageKey": "0000000000000000000000070000000300",
      "OwnerCount": 12,
      "PreviousTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
      "PreviousTxnLgrSeq": 61965653,
      "RegularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ",
      "Sequence": 385,
      "TransferRate": 4294967295,
      "index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8"
    },
    "validated": true
  },
  "status": "success",
  "type": "response"
}
```

JSON-RPC

```json
200 OK

{
  "result": {
    "index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
    "ledger_hash": "395946243EA36C5092AE58AF729D2875F659812409810A63096AC006C73E656E",
    "ledger_index": 61966165,
    "node": {
      "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
      "AccountTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
      "Balance": "424021949",
      "Domain": "6D64756F31332E636F6D",
      "EmailHash": "98B4375E1D753E5B91627516F6D70977",
      "Flags": 9568256,
      "LedgerEntryType": "AccountRoot",
      "MessageKey": "0000000000000000000000070000000300",
      "OwnerCount": 12,
      "PreviousTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
      "PreviousTxnLgrSeq": 61965653,
      "RegularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ",
      "Sequence": 385,
      "TransferRate": 4294967295,
      "index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8"
    },
    "status": "success",
    "validated": true
  }
}
```

Commandline

```json
{
  "result": {
    "index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
    "ledger_hash": "395946243EA36C5092AE58AF729D2875F659812409810A63096AC006C73E656E",
    "ledger_index": 61966165,
    "node": {
      "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
      "AccountTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
      "Balance": "424021949",
      "Domain": "6D64756F31332E636F6D",
      "EmailHash": "98B4375E1D753E5B91627516F6D70977",
      "Flags": 9568256,
      "LedgerEntryType": "AccountRoot",
      "MessageKey": "0000000000000000000000070000000300",
      "OwnerCount": 12,
      "PreviousTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
      "PreviousTxnLgrSeq": 61965653,
      "RegularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ",
      "Sequence": 385,
      "TransferRate": 4294967295,
      "index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8"
    },
    "status": "success",
    "validated": true
  }
}
```

## 考えられるエラー

* いずれかの[汎用エラータイプ](/ja/docs/references/http-websocket-apis/api-conventions/error-formatting#%E6%B1%8E%E7%94%A8%E3%82%A8%E3%83%A9%E3%83%BC)。
* `deprecatedFeature` - 削除されたフィールド（`generator`など）がリクエストに指定されていました。
* `entryNotFound` - リクエストされたレジャーエントリはレジャーに存在しません。
* `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。
* `lgrNotFound` - `ledger_hash`または`ledger_index`で指定したレジャーが存在しないか、存在してはいるもののサーバが保有していません。
* `malformedAddress` - リクエストの[アドレス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9)フィールドが誤って指定されています。
* `malformedCurrency` - リクエストの[通貨コード](/ja/docs/references/protocol/data-types/currency-formats#%E9%80%9A%E8%B2%A8%E3%82%B3%E3%83%BC%E3%83%89)フィールドが誤って指定されています。
* `malformedOwner` - リクエストの`escrow.owner`サブフィールドが誤って指定されています。
* `malformedRequest` - リクエストにフィールドが無効な組み合わせで指定されているか、1つ以上のフィールドの型が誤っています。
* `unknownOption` - リクエストに指定されたフィールドが、予期されるリクエストのフォーマットのいずれにも一致していません。