WSS

Account methods

account_channels

Returns information about an account's payment channels.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "account_channels",
  "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "destination_account": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
  "ledger_index": "validated"
}

Example response: 200

{
    "result": {
        "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
        "channels": [
            {
                "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                "amount": "1000",
                "balance": "0",
                "channel_id": "C7F634794B79DB40E87179A9D1BF05D05797AE7E92DF8E93FD6656E8C4BE3AE7",
                "destination_account": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
                "public_key": "aBR7mdD75Ycs8DRhMgQ4EMUEmBArF8SEh1hfjrT2V9DQTLNbJVqw",
                "public_key_hex": "03CFD18E689434F032A4E84C63E2A3A6472D684EAF4FD52CA67742F3E24BAE81B2",
                "settle_delay": 60
            }
        ],
        "ledger_hash": "223755E7E4297B1EBA1B29C01733080534E1A77A13909BC84FF8B8AA70E8D714",
        "ledger_index": 100669309,
        "validated": true
    },
    "status": "success",
    "type": "response"
}

account_currencies

Retrieves a list of currencies that an account can send or receive, based on its trust lines.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "account_currencies",
  "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "ledger_index": "validated"
}

Example response: 200

{
    "result": {
        "ledger_hash": "8F13A2B9DABF26D5224FC9569DBB08A76591114B438513C3CEAB133FCA79F7AC",
        "ledger_index": 100669333,
        "receive_currencies": [
            "USD"
        ],
        "send_currencies": [
            "USD",
            "VGB"
        ],
        "validated": true
    },
    "status": "success",
    "type": "response"
}

account_info

Retrieves information about an account, its activity, and its XRP balance.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "account_info",
  "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "ledger_index": "current",
  "queue": true
}

Example response: 200

{
    "result": {
        "account_data": {
            "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
            "AccountTxnID": "932CC7E9BAC1F7B9FA5381679F293EEC0A646E5E7F2F6D14C85FEE2102F0E66C",
            "Balance": "1138222650",
            "Domain": "6D64756F31332E636F6D",
            "EmailHash": "98B4375E1D753E5B91627516F6D70977",
            "Flags": 9568256,
            "LedgerEntryType": "AccountRoot",
            "MessageKey": "0000000000000000000000070000000300",
            "OwnerCount": 17,
            "PreviousTxnID": "1B138A01BF8B55B675DF7FC3744A33AF8D281DDB6CB43B2E1FB19208FE909430",
            "PreviousTxnLgrSeq": 100578098,
            "RegularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ",
            "Sequence": 393,
            "TicketCount": 5,
            "TransferRate": 4294967295,
            "index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
            "urlgravatar": "http://www.gravatar.com/avatar/98b4375e1d753e5b91627516f6d70977"
        },
        "account_flags": {
            "allowTrustLineClawback": false,
            "defaultRipple": true,
            "depositAuth": false,
            "disableMasterKey": true,
            "disallowIncomingCheck": false,
            "disallowIncomingNFTokenOffer": false,
            "disallowIncomingPayChan": false,
            "disallowIncomingTrustline": false,
            "disallowIncomingXRP": false,
            "globalFreeze": false,
            "noFreeze": false,
            "passwordSpent": false,
            "requireAuthorization": false,
            "requireDestinationTag": true
        },
        "ledger_current_index": 100669368,
        "queue_data": {
            "txn_count": 0
        },
        "validated": false
    },
    "status": "success",
    "type": "response"
}

account_lines

Retrieves information about an account's trust lines, including balances for all non-XRP currencies and assets.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "account_lines",
  "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "ledger_index": "validated"
}

Example response: 200

{
    "result": {
        "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
        "ledger_hash": "E66B56E9705A2A6194C8EEF3E93BF124F41528B876896849C285BA64903A3322",
        "ledger_index": 100669389,
        "lines": [
            {
                "account": "r3HmMVX8KPpTXe6h81m72XjFPKyZ3Rhbc6",
                "balance": "0",
                "currency": "USD",
                "limit": "0",
                "limit_peer": "1000000",
                "no_ripple_peer": true,
                "quality_in": 0,
                "quality_out": 0
            },
            {
                "account": "rJF9txJpy3RG7XkXsiL72us5X5txbQDFgA",
                "balance": "0",
                "currency": "VGB",
                "limit": "0",
                "limit_peer": "100000000",
                "no_ripple_peer": true,
                "quality_in": 0,
                "quality_out": 0
            },
            {
                "account": "rJXhkzNcijhgwkPHUT966Mhr22b4CwPkjS",
                "balance": "0",
                "currency": "USD",
                "limit": "0",
                "limit_peer": "14.0301",
                "no_ripple_peer": true,
                "quality_in": 0,
                "quality_out": 0
            },
            {
                "account": "rKZeoF6SVe4dyKeyy6FWtC4TyTzWd7BeMr",
                "balance": "0",
                "currency": "USD",
                "limit": "0",
                "limit_peer": "3988",
                "quality_in": 0,
                "quality_out": 0
            },
            {
                "account": "rMaFZmCJJL16itTpYvTpkXGZyhrdb83PLB",
                "balance": "0",
                "currency": "USD",
                "limit": "0",
                "limit_peer": "100",
                "peer_authorized": true,
                "quality_in": 0,
                "quality_out": 0
            },
            {
                "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                "balance": "0",
                "currency": "USD",
                "limit": "1000000000",
                "limit_peer": "0",
                "no_ripple": true,
                "quality_in": 0,
                "quality_out": 0
            },
            {
                "account": "r9qheokwreSsfdFqvYzYerrTa6xGpD8N5r",
                "balance": "0",
                "currency": "USD",
                "limit": "0",
                "limit_peer": "10000",
                "quality_in": 0,
                "quality_out": 0
            },
            {
                "account": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
                "balance": "-14.0301",
                "currency": "USD",
                "limit": "0",
                "limit_peer": "100",
                "quality_in": 0,
                "quality_out": 0
            },
            {
                "account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
                "balance": "0.0001",
                "currency": "USD",
                "limit": "110",
                "limit_peer": "0",
                "no_ripple": true,
                "quality_in": 0,
                "quality_out": 0
            },
            {
                "account": "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW",
                "balance": "0",
                "currency": "USD",
                "freeze": true,
                "limit": "110",
                "limit_peer": "0",
                "peer_authorized": true,
                "quality_in": 0,
                "quality_out": 0
            },
            {
                "account": "rUpy3eEg8rqjqfUoLeBnZkscbKbFsKXC3v",
                "balance": "0",
                "currency": "USD",
                "freeze": true,
                "limit": "0",
                "limit_peer": "0",
                "no_ripple_peer": true,
                "quality_in": 0,
                "quality_out": 0
            },
            {
                "account": "rKaSUCRdBL5tnjEfbnA67JfbzHtCKsyNyE",
                "balance": "0",
                "currency": "USD",
                "limit": "0",
                "limit_peer": "0",
                "quality_in": 0,
                "quality_out": 0
            }
        ],
        "validated": true
    },
    "status": "success",
    "type": "response"
}

account_nfts

Retrieves NFTs owned by an account.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "account_nfts",
  "account": "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW",
  "ledger_index": "validated"
}

Example response: 200

{
    "result": {
        "account": "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW",
        "account_nfts": [],
        "ledger_hash": "4187FCED9D4EF8FBF3AD0D97CD64A15A98C8D4C9CD4FC0F3A1E6348C17CD1001",
        "ledger_index": 100669412,
        "validated": true
    },
    "status": "success",
    "type": "response"
}

account_objects

Returns the raw ledger format for all objects owned by an account.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "account_objects",
  "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "ledger_index": "validated",
  "type": "state",
  "limit": 10
}

Example response: 200

{
    "result": {
        "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
        "account_objects": [
            {
                "Balance": {
                    "currency": "USD",
                    "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                    "value": "0"
                },
                "Flags": 2228224,
                "HighLimit": {
                    "currency": "USD",
                    "issuer": "r3HmMVX8KPpTXe6h81m72XjFPKyZ3Rhbc6",
                    "value": "1000000"
                },
                "HighNode": "0",
                "LedgerEntryType": "RippleState",
                "LowLimit": {
                    "currency": "USD",
                    "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                    "value": "0"
                },
                "LowNode": "0",
                "PreviousTxnID": "F6C08D8EF1323A9190BB6251EA0FA2FD5B03814E4DF27316E269A9281A5BAA1E",
                "PreviousTxnLgrSeq": 100578156,
                "index": "2A225C26EEB00941461B041738B252897ED0C7900260C55D9CAA2AF70C7FDD7B"
            },
            {
                "Balance": {
                    "currency": "VGB",
                    "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                    "value": "0"
                },
                "Flags": 2228224,
                "HighLimit": {
                    "currency": "VGB",
                    "issuer": "rJF9txJpy3RG7XkXsiL72us5X5txbQDFgA",
                    "value": "100000000"
                },
                "HighNode": "0",
                "LedgerEntryType": "RippleState",
                "LowLimit": {
                    "currency": "VGB",
                    "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                    "value": "0"
                },
                "LowNode": "0",
                "PreviousTxnID": "16EECFA15EA8F73E6A1F9ADFE3129079F6768D029D0A201188D43F13FC59BF70",
                "PreviousTxnLgrSeq": 68025787,
                "index": "556B13E58990CC22D3379BCC6D55F46237F11713AD809DF3E7860DAB55B7F3EF"
            },
            {
                "Balance": {
                    "currency": "USD",
                    "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                    "value": "0"
                },
                "Flags": 2228224,
                "HighLimit": {
                    "currency": "USD",
                    "issuer": "rJXhkzNcijhgwkPHUT966Mhr22b4CwPkjS",
                    "value": "14.0301"
                },
                "HighNode": "0",
                "LedgerEntryType": "RippleState",
                "LowLimit": {
                    "currency": "USD",
                    "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                    "value": "0"
                },
                "LowNode": "0",
                "PreviousTxnID": "38A3E74C275CCCA29928A2963EFC70B1C209524AB9A256857E542137E795BD08",
                "PreviousTxnLgrSeq": 67788618,
                "index": "6451BF1D41FCDA846C4B60E6F4E4914F1C4EC3015FF978642B7358A14DAE1C26"
            },
            {
                "Balance": {
                    "currency": "USD",
                    "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                    "value": "0"
                },
                "Flags": 131072,
                "HighLimit": {
                    "currency": "USD",
                    "issuer": "rKZeoF6SVe4dyKeyy6FWtC4TyTzWd7BeMr",
                    "value": "3988"
                },
                "HighNode": "0",
                "LedgerEntryType": "RippleState",
                "LowLimit": {
                    "currency": "USD",
                    "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                    "value": "0"
                },
                "LowNode": "0",
                "PreviousTxnID": "DDA5BDDF8DA08065B36548BE127730CB160B106DCCF9476ABB2FABE61BA3135C",
                "PreviousTxnLgrSeq": 94384123,
                "index": "6C3556BE2D440A3BEE999CC77657BA8F5DC473DFE44D4E11A8EE45B49F15FD4A"
            },
            {
                "Balance": {
                    "currency": "USD",
                    "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                    "value": "0"
                },
                "Flags": 655360,
                "HighLimit": {
                    "currency": "USD",
                    "issuer": "rMaFZmCJJL16itTpYvTpkXGZyhrdb83PLB",
                    "value": "100"
                },
                "HighNode": "0",
                "LedgerEntryType": "RippleState",
                "LowLimit": {
                    "currency": "USD",
                    "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                    "value": "0"
                },
                "LowNode": "0",
                "PreviousTxnID": "B427CF9BADF0B6AB92EA5DFC80B6F8D57150119BB875781488C4B0085F362BB7",
                "PreviousTxnLgrSeq": 49541809,
                "index": "731A16474E86C07C62B3042BD2C223ED85EBD54E3B540E7E2739187EF9B483BA"
            },
            {
                "Balance": {
                    "currency": "USD",
                    "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                    "value": "0"
                },
                "Flags": 2228224,
                "HighLimit": {
                    "currency": "USD",
                    "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                    "value": "1000000000"
                },
                "HighNode": "0",
                "LedgerEntryType": "RippleState",
                "LowLimit": {
                    "currency": "USD",
                    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                    "value": "0"
                },
                "LowNode": "2ec",
                "PreviousTxnID": "C5E6F14C1503411FC8FDA07E8C9EE0E3533638150D376BBA15484520DAE1AB08",
                "PreviousTxnLgrSeq": 11812808,
                "index": "901F553B240AC0EE24AA0D9BE860C13F0DE6CC7C594AA13E89CD66D000EE4F55"
            },
            {
                "Balance": {
                    "currency": "USD",
                    "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                    "value": "0"
                },
                "Flags": 131072,
                "HighLimit": {
                    "currency": "USD",
                    "issuer": "r9qheokwreSsfdFqvYzYerrTa6xGpD8N5r",
                    "value": "10000"
                },
                "HighNode": "0",
                "LedgerEntryType": "RippleState",
                "LowLimit": {
                    "currency": "USD",
                    "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                    "value": "0"
                },
                "LowNode": "0",
                "PreviousTxnID": "8566673ECD0A9731C516906E5D2F47129C5C13713602140733831A56CEAE1A05",
                "PreviousTxnLgrSeq": 68999137,
                "index": "965488EF00AE88F938930FC88774B13F99FFFA00883004AD18AF4F0EE1C7B26F"
            },
            {
                "Balance": {
                    "currency": "USD",
                    "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                    "value": "14.0301"
                },
                "Flags": 65536,
                "HighLimit": {
                    "currency": "USD",
                    "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                    "value": "0"
                },
                "HighNode": "0",
                "LedgerEntryType": "RippleState",
                "LowLimit": {
                    "currency": "USD",
                    "issuer": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
                    "value": "100"
                },
                "LowNode": "0",
                "PreviousTxnID": "CB98A6FA1FAC47F9FCC6A233EB46F8F9AF59CC69BD69AE6D06F298F6FF52162A",
                "PreviousTxnLgrSeq": 21184489,
                "index": "96D2F43BA7AE7193EC59E5E7DDB26A9D786AB1F7C580E030E7D2FF5233DA01E9"
            }
        ],
        "ledger_hash": "71F1416453D348C3862B498454AE09CF4E62B5AE1FEAE89B49B75A7496143B93",
        "ledger_index": 100669429,
        "limit": 10,
        "marker": "3B9C0CE77FCE7BCEE1A68F1E26AC467AF326239D0D816CE705E4A0E2DAD03F6D,977A4B2767DCAA2DED68630E4039E7EFFDD3739717056610754E7921FED19E98",
        "validated": true
    },
    "status": "success",
    "type": "response"
}

account_offers

Retrieves a list of offers made by a given account that are outstanding as of a particular ledger version.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "account_offers",
  "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
}

Example response: 200

{
    "result": {
        "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
        "ledger_current_index": 100669500,
        "offers": [
            {
                "flags": 0,
                "quality": "0.0000001",
                "seq": 359,
                "taker_gets": "1000000000",
                "taker_pays": {
                    "currency": "FOO",
                    "issuer": "rUpy3eEg8rqjqfUoLeBnZkscbKbFsKXC3v",
                    "value": "100"
                }
            }
        ],
        "validated": false
    },
    "status": "success",
    "type": "response"
}

account_tx

Retrieves a list of transactions that affected the specified account.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "account_tx",
  "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "ledger_index_min": -1,
  "ledger_index_max": -1,
  "binary": false,
  "limit": 2,
  "forward": false,
  "api_version": 2
}

Example response: 200

{
    "api_version": 2,
    "result": {
        "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
        "ledger_index_max": 100669512,
        "ledger_index_min": 99774974,
        "limit": 2,
        "transactions": [
            {
                "close_time_iso": "2025-12-01T08:29:02Z",
                "hash": "F6C08D8EF1323A9190BB6251EA0FA2FD5B03814E4DF27316E269A9281A5BAA1E",
                "ledger_hash": "3B6C691E979231028AFE74DE177FD55DDCDF6EE827A1D52DF5C3B61ACBC904CC",
                "ledger_index": 100578156,
                "meta": {
                    "AffectedNodes": [
                        {
                            "ModifiedNode": {
                                "FinalFields": {
                                    "Balance": {
                                        "currency": "USD",
                                        "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                                        "value": "0"
                                    },
                                    "Flags": 2228224,
                                    "HighLimit": {
                                        "currency": "USD",
                                        "issuer": "r3HmMVX8KPpTXe6h81m72XjFPKyZ3Rhbc6",
                                        "value": "1000000"
                                    },
                                    "HighNode": "0",
                                    "LowLimit": {
                                        "currency": "USD",
                                        "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                                        "value": "0"
                                    },
                                    "LowNode": "0"
                                },
                                "LedgerEntryType": "RippleState",
                                "LedgerIndex": "2A225C26EEB00941461B041738B252897ED0C7900260C55D9CAA2AF70C7FDD7B",
                                "PreviousFields": {
                                    "HighLimit": {
                                        "currency": "USD",
                                        "issuer": "r3HmMVX8KPpTXe6h81m72XjFPKyZ3Rhbc6",
                                        "value": "14.0301"
                                    }
                                },
                                "PreviousTxnID": "1B138A01BF8B55B675DF7FC3744A33AF8D281DDB6CB43B2E1FB19208FE909430",
                                "PreviousTxnLgrSeq": 100578098
                            }
                        },
                        {
                            "ModifiedNode": {
                                "FinalFields": {
                                    "Account": "r3HmMVX8KPpTXe6h81m72XjFPKyZ3Rhbc6",
                                    "Balance": "6224366",
                                    "Flags": 0,
                                    "OwnerCount": 9,
                                    "Sequence": 100572425
                                },
                                "LedgerEntryType": "AccountRoot",
                                "LedgerIndex": "8B15BFC0C01E45B83393CBAB7069CE936CD0E74DC3F97D25E63F95024DA46285",
                                "PreviousFields": {
                                    "Balance": "6224378",
                                    "Sequence": 100572424
                                },
                                "PreviousTxnID": "F51F2DCE95E66E1194909E0B039897E1DCA127E930E6BA0FD59C97607CE8137C",
                                "PreviousTxnLgrSeq": 100578109
                            }
                        }
                    ],
                    "TransactionIndex": 41,
                    "TransactionResult": "tesSUCCESS"
                },
                "tx_json": {
                    "Account": "r3HmMVX8KPpTXe6h81m72XjFPKyZ3Rhbc6",
                    "Fee": "12",
                    "Flags": 131072,
                    "LastLedgerSequence": 100578174,
                    "LimitAmount": {
                        "currency": "USD",
                        "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                        "value": "1000000"
                    },
                    "Sequence": 100572424,
                    "SigningPubKey": "030BBF07D0A71797B82618043DFF6BB3F3A51B98AE1638585070159FAF8C6AC5D6",
                    "TransactionType": "TrustSet",
                    "TxnSignature": "304402206BBAA1F09B149B45D7BF607BE95BBD392792A4F5E0AFFA9C174E9DE907AABD23022047FAB16FA0ECF6E5CCC9946022A1B1F89C3A460D2219B4CE2425B077200046DB",
                    "ctid": "C5FEB36C00290000",
                    "date": 817892942,
                    "ledger_index": 100578156
                },
                "validated": true
            },
            {
                "close_time_iso": "2025-12-01T08:25:21Z",
                "hash": "1B138A01BF8B55B675DF7FC3744A33AF8D281DDB6CB43B2E1FB19208FE909430",
                "ledger_hash": "8248E40F85F2D4BD4B9BF3E9385108BE3D38C06E4C633DB6AD8FD6549FB24C17",
                "ledger_index": 100578098,
                "meta": {
                    "AffectedNodes": [
                        {
                            "ModifiedNode": {
                                "LedgerEntryType": "AccountRoot",
                                "LedgerIndex": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
                                "PreviousTxnID": "E5C3578BDBEBDCDE7E1697E3BA6A1CF04B17CCEBDE4939200680FEF530C7978E",
                                "PreviousTxnLgrSeq": 94448149
                            }
                        },
                        {
                            "CreatedNode": {
                                "LedgerEntryType": "RippleState",
                                "LedgerIndex": "2A225C26EEB00941461B041738B252897ED0C7900260C55D9CAA2AF70C7FDD7B",
                                "NewFields": {
                                    "Balance": {
                                        "currency": "USD",
                                        "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                                        "value": "0"
                                    },
                                    "Flags": 2228224,
                                    "HighLimit": {
                                        "currency": "USD",
                                        "issuer": "r3HmMVX8KPpTXe6h81m72XjFPKyZ3Rhbc6",
                                        "value": "14.0301"
                                    },
                                    "LowLimit": {
                                        "currency": "USD",
                                        "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                                        "value": "0"
                                    }
                                }
                            }
                        },
                        {
                            "ModifiedNode": {
                                "FinalFields": {
                                    "Flags": 0,
                                    "Owner": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                                    "RootIndex": "3B9C0CE77FCE7BCEE1A68F1E26AC467AF326239D0D816CE705E4A0E2DAD03F6D"
                                },
                                "LedgerEntryType": "DirectoryNode",
                                "LedgerIndex": "3B9C0CE77FCE7BCEE1A68F1E26AC467AF326239D0D816CE705E4A0E2DAD03F6D",
                                "PreviousTxnID": "DDA5BDDF8DA08065B36548BE127730CB160B106DCCF9476ABB2FABE61BA3135C",
                                "PreviousTxnLgrSeq": 94384123
                            }
                        },
                        {
                            "ModifiedNode": {
                                "FinalFields": {
                                    "Account": "r3HmMVX8KPpTXe6h81m72XjFPKyZ3Rhbc6",
                                    "Balance": "6224390",
                                    "Flags": 0,
                                    "OwnerCount": 9,
                                    "Sequence": 100572423
                                },
                                "LedgerEntryType": "AccountRoot",
                                "LedgerIndex": "8B15BFC0C01E45B83393CBAB7069CE936CD0E74DC3F97D25E63F95024DA46285",
                                "PreviousFields": {
                                    "Balance": "6224402",
                                    "OwnerCount": 8,
                                    "Sequence": 100572422
                                },
                                "PreviousTxnID": "AB79C66BDF7549D303453BEAADB2C27E822AE824FD72F34915D5463A2DA167C3",
                                "PreviousTxnLgrSeq": 100577942
                            }
                        },
                        {
                            "ModifiedNode": {
                                "FinalFields": {
                                    "Flags": 0,
                                    "Owner": "r3HmMVX8KPpTXe6h81m72XjFPKyZ3Rhbc6",
                                    "RootIndex": "E9D8965C93BBBEC646A28A865A3E508CA18BF6BED8F37AF726F048C0B96CFB09"
                                },
                                "LedgerEntryType": "DirectoryNode",
                                "LedgerIndex": "E9D8965C93BBBEC646A28A865A3E508CA18BF6BED8F37AF726F048C0B96CFB09",
                                "PreviousTxnID": "AB79C66BDF7549D303453BEAADB2C27E822AE824FD72F34915D5463A2DA167C3",
                                "PreviousTxnLgrSeq": 100577942
                            }
                        }
                    ],
                    "TransactionIndex": 20,
                    "TransactionResult": "tesSUCCESS"
                },
                "tx_json": {
                    "Account": "r3HmMVX8KPpTXe6h81m72XjFPKyZ3Rhbc6",
                    "Fee": "12",
                    "Flags": 131072,
                    "LastLedgerSequence": 100578116,
                    "LimitAmount": {
                        "currency": "USD",
                        "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                        "value": "14.0301"
                    },
                    "Sequence": 100572422,
                    "SigningPubKey": "030BBF07D0A71797B82618043DFF6BB3F3A51B98AE1638585070159FAF8C6AC5D6",
                    "TransactionType": "TrustSet",
                    "TxnSignature": "304502210097034D2D2A87AF6E18B13B93EDCF33928DE8E4F0A98433A3A15EB5805DD1D0880220109EFF1B9C056592E0024E38203ACBB2CF4E24B5020013DD91F655713749C4F1",
                    "ctid": "C5FEB33200140000",
                    "date": 817892721,
                    "ledger_index": 100578098
                },
                "validated": true
            }
        ],
        "validated": true
    },
    "status": "success",
    "type": "response"
}

gateway_balances

Calculates the total balances issued by a given account, optionally excluding amounts held by operational addresses.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "id": "example_gateway_balances_1",
  "command": "gateway_balances",
  "account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
  "hotwallet": [
    "rKm4uWpg9tfwbVSeATv4KxDe6mpE9yPkgJ",
    "ra7JkEzrgeKHdzKgo4EUUVBnxggY4z37kt"
  ],
  "ledger_index": "validated"
}

Example response: 200

{
    "id": "example_gateway_balances_1",
    "result": {
        "account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
        "assets": {
            "r9F6wk8HkXrgYWoJ7fsv4VrUBVoqDVtzkH": [
                {
                    "currency": "BTC",
                    "value": "5444166510000000e-26"
                }
            ],
            "rPU6VbckqCLW4kb51CWqZdxvYyQrQVsnSj": [
                {
                    "currency": "BTC",
                    "value": "1029900000000000e-26"
                }
            ],
            "rpR95n1iFkTqpoy1e878f4Z1pVHVtWKMNQ": [
                {
                    "currency": "BTC",
                    "value": "4000000000000000e-30"
                }
            ],
            "rwmUaXsWtXU4Z843xSYwgt1is97bgY8yj6": [
                {
                    "currency": "BTC",
                    "value": "8700000000000000e-30"
                }
            ]
        },
        "balances": {
            "rKm4uWpg9tfwbVSeATv4KxDe6mpE9yPkgJ": [
                {
                    "currency": "EUR",
                    "value": "144816.1965999999"
                }
            ],
            "ra7JkEzrgeKHdzKgo4EUUVBnxggY4z37kt": [
                {
                    "currency": "USD",
                    "value": "6677.38614"
                }
            ]
        },
        "frozen_balances": {
            "r4keXr5myiU4iTLh68ZqZ2CgsJ8dM9FSW6": [
                {
                    "currency": "BTC",
                    "value": "0.091207822800868"
                }
            ]
        },
        "ledger_hash": "77D418838128CB6C45FBF5E4D26967216F68CF67BEDB3A64BF71AF99D893C8E9",
        "ledger_index": 100669526,
        "obligations": {
            "BTC": "1761.964986208178",
            "EUR": "813788.3511514511",
            "GBP": "4973.797603049582",
            "USD": "6734897.609769505"
        },
        "validated": true
    },
    "status": "success",
    "type": "response"
}

noripple_check

Compares an account's Default Ripple and No Ripple flags to the recommended settings.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "noripple_check",
  "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "role": "gateway",
  "ledger_index": "current",
  "limit": 2,
  "transactions": true
}

Example response: 200

{
    "result": {
        "ledger_current_index": 100669540,
        "problems": [
            "You should clear the no ripple flag on your USD line to rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
            "You should clear the no ripple flag on your USD line to rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q"
        ],
        "transactions": [
            {
                "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                "Fee": 10,
                "Flags": 262144,
                "LimitAmount": {
                    "currency": "USD",
                    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                    "value": "1000000000"
                },
                "Sequence": 393,
                "TransactionType": "TrustSet"
            },
            {
                "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                "Fee": 10,
                "Flags": 262144,
                "LimitAmount": {
                    "currency": "USD",
                    "issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
                    "value": "110"
                },
                "Sequence": 394,
                "TransactionType": "TrustSet"
            }
        ],
        "validated": false
    },
    "status": "success",
    "type": "response"
}

Ledger methods

ledger

Retrieves information about the public ledger.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "ledger",
  "ledger_index": "validated",
  "transactions": false,
  "expand": false,
  "owner_funds": false,
  "api_version": 2
}

Example response: 200

{
    "api_version": 2,
    "result": {
        "ledger": {
            "account_hash": "3FC85E1FF4056C0F4DC98FBF2EAF71907E6D911C2DCA1B933F8EFC82D5409AA6",
            "close_flags": 0,
            "close_time": 818248820,
            "close_time_human": "2025-Dec-05 11:20:20.000000000 UTC",
            "close_time_iso": "2025-12-05T11:20:20Z",
            "close_time_resolution": 10,
            "closed": true,
            "ledger_hash": "360DE15AADF23023D18C7657A5FFB6F3C7B906AEF9022899C48E813703E17F33",
            "ledger_index": 100669585,
            "parent_close_time": 818248812,
            "parent_hash": "4ED0A35D863562CE60616A3B09CEE552AAB6197A128CF7F19F7B4E07E4E4F191",
            "total_coins": "99985745827885165",
            "transaction_hash": "46A484F6BD3038F26812D02E8023A8FDD61418415C9A9E5488DAB7B46BA35A26"
        },
        "ledger_hash": "360DE15AADF23023D18C7657A5FFB6F3C7B906AEF9022899C48E813703E17F33",
        "ledger_index": 100669585,
        "validated": true
    },
    "status": "success",
    "type": "response"
}

ledger_closed

Returns the unique identifiers of the most recently closed ledger.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "ledger_closed"
}

Example response: 200

{
    "result": {
        "ledger_hash": "94D048C858D1111EC04B89472DFF4353E254D677B641DBC8729186892C5C8864",
        "ledger_index": 100669600
    },
    "status": "success",
    "type": "response"
}

ledger_current

Returns the unique identifiers of the current in-progress ledger.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "ledger_current"
}

Example response: 200

{
    "result": {
        "ledger_current_index": 100669619
    },
    "status": "success",
    "type": "response"
}

ledger_data

Retrieves contents of the specified ledger.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "ledger_hash": "94D048C858D1111EC04B89472DFF4353E254D677B641DBC8729186892C5C8864",
  "command": "ledger_data",
  "limit": 5,
  "binary": true
}

Example response: 200

{
    "result": {
        "ledger": {
            "closed": true,
            "ledger_data": "060018A0016338818EA91DF45D7D662BD987D4350E225125ACB5D176793748E5E3B373FCBF8F0BB285ABA80072C930520F1FF8E8FB232D51F51D5ADF17D03ACE12101C05D3833E050C83F8D7A1BA3132A8F211D9132495FD9DA543D81B14ACF716C60B536257396876FAF37630C57CA730C57CA80A00"
        },
        "ledger_hash": "94D048C858D1111EC04B89472DFF4353E254D677B641DBC8729186892C5C8864",
        "ledger_index": 100669600,
        "marker": "00000299BD60630F6C37B91FB1FDA6979E59D19E9D42C2DBF39ABBEF66F6FBB7",
        "state": [
            {
                "data": "11007222002200002505AED0B33700000000000000013800000000000000005591315DD2EA29E37337E82D301C290AEA7EDEE2DD6F05CC2F68B84207F4F5567D62964DB672D21FC5BC5355524600000000000000000000000000000000000000000000000000000000000000000000000166800000000000000053555246000000000000000000000000000000005E1CB39FF6EF59B0A876F77171E0272BFB3767AE67D6E3424D20B0EC365355524600000000000000000000000000000000AA785D6CF533255094E491088845C8EC473ACDAF",
                "index": "000001C00ADE73DFE88D818FE98D531B180463D51324BE4544EAC23D542EA6CE"
            },
            {
                "data": "110064220000000031000000000000042632000000000000042458BADEFEDEA9826CDFBD479D5747E441220ADC501BB32C8FE5D88C6C3CB629F54282149D8A36120736BD667E4F8B548EBF259A2C7645AD0113206BE53687261B6ED0F7C537328D1EA76F0F8A26264B973D85F6AA8B915C9EEF32",
                "index": "00000203EA7B91B283192593F8847E6641930185B3689530AAE24A64A815FF58"
            },
            {
                "data": "11007222002200002505D000F23700000000000036D638000000000000000055CD2812F38B5901285F8AABC1BC4904B44F8E374BC4C591B682CEB1880E84C9126295C3ABFF00AACB86534F4C4F000000000000000000000000000000000000000000000000000000000000000000000001668000000000000000534F4C4F000000000000000000000000000000001EB3EAA3AD86242E1D51DC502DD6566BD39E06A667D7038D7EA4C68000534F4C4F00000000000000000000000000000000DC0D216B60874BEC68C8B6D2DB03288A6C4CA2CE",
                "index": "00000229C0A107C37F4E44A86BB5FB1D3EB09DFEDE7D6DA4F8A4FBF027D3FC32"
            },
            {
                "data": "11007222001100002505C25EA537000000000000000038000000000000002555EC6C2AF84D0E0EC098D1747240C075F3F2A286C45AA390048B24D7E84619031E62D60B9C3441CCF200534C415348000000000000000000000000000000000000000000000000000000000000000000000166D6838D7EA4C68000534C415348000000000000000000000000000000A6015C41F53C5F534834E85AED611A17A88F444D678000000000000000534C415348000000000000000000000000000000BC1A737E39D6FE90F28BDFB2FA77C4C058CD74B7",
                "index": "00000260CBB0B1DE602B32854B902F2B3817951486E685E768548EEE22C0818B"
            },
            {
                "data": "11006422000000002505D1907431000000000000001632000000000000001455D5BFFF21A27BDF1DB7AF0D1FC7056718D5D8727FA0BE46235FAFF5CF04C6EF42586E50F8857A296CF57970DCDE1BD72249D289063DDF9442C470C09932EB49A15A8214641CE5A64210C73806C231DC5EE5F022F66A6B3101136022D93A8DE35E0FED869AB6A6D947CF453CB615D0ACFB580E4D068DCBD22D7BD2BE2548BA8423CF185D0D386C92AD62095616CED1DB9AD23A3E3FC4D77177BC2FCF63748BFDA39C177C355DE1F45E68A3E9021324397CAD75BA1CB9752C7D97C4",
                "index": "00000279A411A10EA7111B68EB79B2E12789D8E1C127104D1348677D5E395DFA"
            }
        ],
        "validated": true
    },
    "status": "success",
    "type": "response"
}

Transaction methods

simulate

Executes a dry run of any transaction type, enabling you to preview the results and metadata of a transaction without committing them to the XRP Ledger.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "id": "example_simulate",
  "command": "simulate",
  "tx_json": {
    "TransactionType": "Payment",
    "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
    "Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
    "Amount": "1000000"
  }
}

Example response: 200

{
    "id": "example_simulate",
    "result": {
        "applied": false,
        "engine_result": "tesSUCCESS",
        "engine_result_code": 0,
        "engine_result_message": "The simulated transaction would have been applied.",
        "ledger_index": 100673630,
        "meta": {
            "AffectedNodes": [
                {
                    "ModifiedNode": {
                        "FinalFields": {
                            "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                            "AccountTxnID": "4C3B28CAEEB43F874DEC276A160AD09E0A19B7000F08B2271AAED76C7793E0C6",
                            "Balance": "1137222640",
                            "Domain": "6D64756F31332E636F6D",
                            "EmailHash": "98B4375E1D753E5B91627516F6D70977",
                            "Flags": 9568256,
                            "MessageKey": "0000000000000000000000070000000300",
                            "OwnerCount": 17,
                            "RegularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ",
                            "Sequence": 394,
                            "TicketCount": 5,
                            "TransferRate": 4294967295
                        },
                        "LedgerEntryType": "AccountRoot",
                        "LedgerIndex": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
                        "PreviousFields": {
                            "AccountTxnID": "932CC7E9BAC1F7B9FA5381679F293EEC0A646E5E7F2F6D14C85FEE2102F0E66C",
                            "Balance": "1138222650",
                            "Sequence": 393
                        },
                        "PreviousTxnID": "1B138A01BF8B55B675DF7FC3744A33AF8D281DDB6CB43B2E1FB19208FE909430",
                        "PreviousTxnLgrSeq": 100578098
                    }
                },
                {
                    "ModifiedNode": {
                        "FinalFields": {
                            "Account": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
                            "Balance": "418266220454",
                            "Domain": "6D64756F31332E636F6D",
                            "Flags": 1048576,
                            "MessageKey": "020000000000000000000000000941C216565D33C8A8ACD1A33C359E84D652D1DA",
                            "OwnerCount": 2,
                            "RegularKey": "rUnMgNT74LreSH8i23FbonW8iYfADyq5tR",
                            "Sequence": 46
                        },
                        "LedgerEntryType": "AccountRoot",
                        "LedgerIndex": "43EA78783A089B137D5E87610DF3BD4129F989EDD02EFAF6C265924D3A0EF8CE",
                        "PreviousFields": {
                            "Balance": "418265220454"
                        },
                        "PreviousTxnID": "20FC763D727503ED786DC9D82846CA4572DBD758E15871AE45C8ABBB8F7EA434",
                        "PreviousTxnLgrSeq": 100576700
                    }
                }
            ],
            "TransactionIndex": 167,
            "TransactionResult": "tesSUCCESS"
        },
        "tx_json": {
            "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
            "Amount": "1000000",
            "Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
            "Fee": "10",
            "Sequence": 393,
            "SigningPubKey": "",
            "TransactionType": "Payment",
            "TxnSignature": "",
            "hash": "4C3B28CAEEB43F874DEC276A160AD09E0A19B7000F08B2271AAED76C7793E0C6"
        }
    },
    "status": "success",
    "type": "response"
}

submit

Submits a transaction to the network to be confirmed and included in future ledgers.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "id": "example_submit",
  "command": "submit",
  "tx_blob": "1200002280000000240000001E61D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA968400000000000000B732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB7447304502210095D23D8AF107DF50651F266259CC7139D0CD0C64ABBA3A958156352A0D95A21E02207FCF9B77D7510380E49FF250C21B57169E14E9B4ACFD314CEDC79DDD0A38B8A681144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754"
}

Example response: 200

{
    "id": "example_submit",
    "result": {
        "accepted": true,
        "account_sequence_available": 393,
        "account_sequence_next": 393,
        "applied": false,
        "broadcast": false,
        "engine_result": "tefPAST_SEQ",
        "engine_result_code": -190,
        "engine_result_message": "This sequence number has already passed.",
        "kept": true,
        "open_ledger_cost": "10",
        "queued": false,
        "tx_blob": "1200002280000000240000001E61D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA968400000000000000B732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB7447304502210095D23D8AF107DF50651F266259CC7139D0CD0C64ABBA3A958156352A0D95A21E02207FCF9B77D7510380E49FF250C21B57169E14E9B4ACFD314CEDC79DDD0A38B8A681144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754",
        "tx_json": {
            "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
            "Amount": {
                "currency": "USD",
                "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                "value": "1"
            },
            "Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
            "Fee": "11",
            "Flags": 2147483648,
            "Sequence": 30,
            "SigningPubKey": "03AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB",
            "TransactionType": "Payment",
            "TxnSignature": "304502210095D23D8AF107DF50651F266259CC7139D0CD0C64ABBA3A958156352A0D95A21E02207FCF9B77D7510380E49FF250C21B57169E14E9B4ACFD314CEDC79DDD0A38B8A6",
            "hash": "BED2F926D0A24F643DC88207A93755B64C8D1673B20E19AC11EC2CB3E4F81789"
        },
        "validated_ledger_index": 100673650
    },
    "status": "success",
    "type": "response"
}

submit_multisigned

Submits a multi-signed transaction to the network to be confirmed and included in future ledgers.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "id": "submit_multisigned_example",
  "command": "submit_multisigned",
  "tx_json": {
    "Account": "rEuLyBCvcw4CFmzv8RepSiAoNgF8tTGJQC",
    "Fee": "30000",
    "Flags": 262144,
    "LimitAmount": {
      "currency": "USD",
      "issuer": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
      "value": "100"
    },
    "Sequence": 2,
    "Signers": [
      {
        "Signer": {
          "Account": "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW",
          "SigningPubKey": "02B3EC4E5DD96029A647CFA20DA07FE1F85296505552CCAC114087E66B46BD77DF",
          "TxnSignature": "30450221009C195DBBF7967E223D8626CA19CF02073667F2B22E206727BFE848FF42BEAC8A022048C323B0BED19A988BDBEFA974B6DE8AA9DCAE250AA82BBD1221787032A864E5"
        }
      },
      {
        "Signer": {
          "Account": "rUpy3eEg8rqjqfUoLeBnZkscbKbFsKXC3v",
          "SigningPubKey": "028FFB276505F9AC3F57E8D5242B386A597EF6C40A7999F37F1948636FD484E25B",
          "TxnSignature": "30440220680BBD745004E9CFB6B13A137F505FB92298AD309071D16C7B982825188FD1AE022004200B1F7E4A6A84BB0E4FC09E1E3BA2B66EBD32F0E6D121A34BA3B04AD99BC1"
        }
      }
    ],
    "SigningPubKey": "",
    "TransactionType": "TrustSet",
    "hash": "BD636194C48FD7A100DE4C972336534C8E710FD008C0F3CF7BC5BF34DAF3C3E6"
  }
}

Example response: 200

{
    "error": "srcActNotFound",
    "error_code": 67,
    "error_message": "Source account not found.",
    "id": "submit_multisigned_example",
    "request": {
        "command": "submit_multisigned",
        "id": "submit_multisigned_example",
        "tx_json": {
            "Account": "rEuLyBCvcw4CFmzv8RepSiAoNgF8tTGJQC",
            "Fee": "30000",
            "Flags": 262144,
            "LimitAmount": {
                "currency": "USD",
                "issuer": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
                "value": "100"
            },
            "Sequence": 2,
            "Signers": [
                {
                    "Signer": {
                        "Account": "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW",
                        "SigningPubKey": "02B3EC4E5DD96029A647CFA20DA07FE1F85296505552CCAC114087E66B46BD77DF",
                        "TxnSignature": "30450221009C195DBBF7967E223D8626CA19CF02073667F2B22E206727BFE848FF42BEAC8A022048C323B0BED19A988BDBEFA974B6DE8AA9DCAE250AA82BBD1221787032A864E5"
                    }
                },
                {
                    "Signer": {
                        "Account": "rUpy3eEg8rqjqfUoLeBnZkscbKbFsKXC3v",
                        "SigningPubKey": "028FFB276505F9AC3F57E8D5242B386A597EF6C40A7999F37F1948636FD484E25B",
                        "TxnSignature": "30440220680BBD745004E9CFB6B13A137F505FB92298AD309071D16C7B982825188FD1AE022004200B1F7E4A6A84BB0E4FC09E1E3BA2B66EBD32F0E6D121A34BA3B04AD99BC1"
                    }
                }
            ],
            "SigningPubKey": "",
            "TransactionType": "TrustSet",
            "hash": "BD636194C48FD7A100DE4C972336534C8E710FD008C0F3CF7BC5BF34DAF3C3E6"
        }
    },
    "status": "error",
    "type": "response"
}

transaction_entry

Retrieves information on a single transaction from a specific ledger version.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "transaction_entry",
  "tx_hash": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7",
  "ledger_index": 348734,
  "api_version": 2
}

Example response: 200

{
    "api_version": 2,
    "error": "lgrNotFound",
    "error_code": 21,
    "error_message": "ledgerNotFound",
    "request": {
        "api_version": 2,
        "command": "transaction_entry",
        "ledger_index": 348734,
        "tx_hash": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7"
    },
    "status": "error",
    "type": "response"
}

tx

Retrieves information on a single transaction.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "tx",
  "transaction": "E3E44560AF97257B6C2B7CA579B2F002A474DD63F132912FF4C04509B420BFDB",
  "binary": false,
  "api_version": 2
}

Example response: 200

{
    "api_version": 2,
    "result": {
        "close_time_iso": "2025-12-05T15:53:10Z",
        "ctid": "C600290500000000",
        "hash": "E3E44560AF97257B6C2B7CA579B2F002A474DD63F132912FF4C04509B420BFDB",
        "ledger_hash": "F1B7EA7F5715F841263D3EC44DD39D777DF54EDE33E6B89DA9F6526D20F76095",
        "ledger_index": 100673797,
        "meta": {
            "AffectedNodes": [
                {
                    "ModifiedNode": {
                        "FinalFields": {
                            "Balance": {
                                "currency": "6175726100000000000000000000000000000000",
                                "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                                "value": "-7698785762.950644"
                            },
                            "Flags": 16908288,
                            "HighLimit": {
                                "currency": "6175726100000000000000000000000000000000",
                                "issuer": "rsVDfaTmXpto7RQb6r8k1XZmcHjLNs9H1G",
                                "value": "0"
                            },
                            "HighNode": "0",
                            "LowLimit": {
                                "currency": "6175726100000000000000000000000000000000",
                                "issuer": "rpjuvqrH37RGzb88UVibzCQYSNrM9FxJDy",
                                "value": "0"
                            },
                            "LowNode": "0"
                        },
                        "LedgerEntryType": "RippleState",
                        "LedgerIndex": "2045810687B7F2DDEDBC458C0BDEBADD396E3DE5525229D956D74E1B25661E7C",
                        "PreviousFields": {
                            "Balance": {
                                "currency": "6175726100000000000000000000000000000000",
                                "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                                "value": "-7698750330.88314"
                            }
                        },
                        "PreviousTxnID": "D4C69F3F72FB5A6AB14DE2531E3ED3388171A2D554DA3CD9CAB7B8AFBC0744B1",
                        "PreviousTxnLgrSeq": 100673795
                    }
                },
                {
                    "ModifiedNode": {
                        "FinalFields": {
                            "Account": "r4Tfg4eoS9F7N1TVoF4YYSKJf2KjfDR3ty",
                            "Balance": "1489307",
                            "Flags": 0,
                            "OwnerCount": 1,
                            "Sequence": 96160341
                        },
                        "LedgerEntryType": "AccountRoot",
                        "LedgerIndex": "2E11255462078922E8FF7626A3940C4FADB5C1EA85030DB2BBA097155D485137",
                        "PreviousFields": {
                            "Balance": "1463291",
                            "Sequence": 96160340
                        },
                        "PreviousTxnID": "E2B6BB1657DC0221A298CCFC676EB3B8F39D14CF6ECF0B4D098B40A3644BCAA5",
                        "PreviousTxnLgrSeq": 100673787
                    }
                },
                {
                    "ModifiedNode": {
                        "FinalFields": {
                            "AMMID": "1CD7307520D7D9C79D981C6EAD4F19D3CDE1C3C1C5461C61044C640B7E3DC33F",
                            "Account": "rsVDfaTmXpto7RQb6r8k1XZmcHjLNs9H1G",
                            "Balance": "5673454902",
                            "Flags": 26214400,
                            "OwnerCount": 1,
                            "Sequence": 91602765
                        },
                        "LedgerEntryType": "AccountRoot",
                        "LedgerIndex": "89D90534BFB95E5F5AD2104D646A853DE399CF0AA4832814DCF094C05A47525A",
                        "PreviousFields": {
                            "Balance": "5673480928"
                        },
                        "PreviousTxnID": "D4C69F3F72FB5A6AB14DE2531E3ED3388171A2D554DA3CD9CAB7B8AFBC0744B1",
                        "PreviousTxnLgrSeq": 100673795
                    }
                },
                {
                    "ModifiedNode": {
                        "FinalFields": {
                            "Balance": {
                                "currency": "6175726100000000000000000000000000000000",
                                "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                                "value": "-293055.7155914404"
                            },
                            "Flags": 2228224,
                            "HighLimit": {
                                "currency": "6175726100000000000000000000000000000000",
                                "issuer": "r4Tfg4eoS9F7N1TVoF4YYSKJf2KjfDR3ty",
                                "value": "78889644614.89125"
                            },
                            "HighNode": "0",
                            "LowLimit": {
                                "currency": "6175726100000000000000000000000000000000",
                                "issuer": "rpjuvqrH37RGzb88UVibzCQYSNrM9FxJDy",
                                "value": "0"
                            },
                            "LowNode": "26"
                        },
                        "LedgerEntryType": "RippleState",
                        "LedgerIndex": "CC28CAE801A7793CAB10F85D7A8EE14C220EBB710D330E90E8298608A9F96A09",
                        "PreviousFields": {
                            "Balance": {
                                "currency": "6175726100000000000000000000000000000000",
                                "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                                "value": "-328487.7830954404"
                            }
                        },
                        "PreviousTxnID": "E2B6BB1657DC0221A298CCFC676EB3B8F39D14CF6ECF0B4D098B40A3644BCAA5",
                        "PreviousTxnLgrSeq": 100673787
                    }
                }
            ],
            "DeliveredAmount": "26026",
            "TransactionIndex": 0,
            "TransactionResult": "tesSUCCESS",
            "delivered_amount": "26026"
        },
        "tx_json": {
            "Account": "r4Tfg4eoS9F7N1TVoF4YYSKJf2KjfDR3ty",
            "DeliverMax": "26111",
            "DeliverMin": "25850",
            "Destination": "r4Tfg4eoS9F7N1TVoF4YYSKJf2KjfDR3ty",
            "Fee": "10",
            "Flags": 131072,
            "LastLedgerSequence": 100673815,
            "SendMax": {
                "currency": "6175726100000000000000000000000000000000",
                "issuer": "rpjuvqrH37RGzb88UVibzCQYSNrM9FxJDy",
                "value": "35432.067504"
            },
            "Sequence": 96160340,
            "SigningPubKey": "EDA3DC1F753DBA87BFCA70CF6C2A034A6877D17AE06155B61A25FFF10EF06F1A01",
            "TransactionType": "Payment",
            "TxnSignature": "EE2F77B35A8A2FF3E0B9CD52427F7368BB1DAB4BCE703ABDD35FDF031C0AF5436F058570FECC0313A8570FC7F0AFD798DAA05CA57A467FEA33A35252D31C5707",
            "ctid": "C600290500000000",
            "date": 818265190,
            "ledger_index": 100673797
        },
        "validated": true
    },
    "status": "success",
    "type": "response"
}

Path and DEX Methods

amm_info

Looks up info on an Automated Market Maker instance.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "amm_info",
  "asset": {
    "currency": "XRP"
  },
  "asset2": {
    "currency": "TST",
    "issuer": "rP9jPyP5kyvFRb6ZiRghAGw5u8SGAmU4bd"
  }
}

Example response: 200

{
    "error": "actNotFound",
    "error_code": 19,
    "error_message": "Account not found.",
    "ledger_current_index": 100673845,
    "request": {
        "asset": {
            "currency": "XRP"
        },
        "asset2": {
            "currency": "TST",
            "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
        },
        "command": "amm_info"
    },
    "status": "error",
    "type": "response",
    "validated": false
}

book_changes

Reports changes to the order books that occurred in a specific ledger version.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "book_changes",
  "ledger_index": 100669329
}

Example response: 200

{
    "result": {
        "changes": [
            {
                "close": "189.9602257494154",
                "currency_a": "XRP_drops",
                "currency_b": "rNexusA23ZQdtejTCeHZZaiKoJRsrnXboq/NXS",
                "high": "189.9602257494154",
                "low": "189.9602257494154",
                "open": "189.9602257494154",
                "volume_a": "2238970",
                "volume_b": "11786.52"
            },
            {
                "close": "88.48676513679824",
                "currency_a": "XRP_drops",
                "currency_b": "rs5wxrBTSErywDDfPs5NY4Zorrca5QMGVd/4F70756C656E6365000000000000000000000000",
                "high": "88.48676513679824",
                "low": "88.48676513679824",
                "open": "88.48676513679824",
                "volume_a": "8153436",
                "volume_b": "92143"
            }
        ],
        "ledger_hash": "2BD197A42D9A3EEF5A7A2D0AE6B722BD9FEE39DA730318A2FECF6C2547624381",
        "ledger_index": 100669329,
        "ledger_time": 818247820,
        "type": "bookChanges",
        "validated": true
    },
    "status": "success",
    "type": "response"
}

book_offers

Retrieves a list of offers, also known as the order book, between two currencies.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "book_offers",
  "taker": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "taker_gets": {
    "currency": "XRP"
  },
  "taker_pays": {
    "currency": "USD",
    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
  },
  "limit": 10
}

Example response: 200

{
    "result": {
        "ledger_current_index": 100673910,
        "offers": [
            {
                "Account": "rhqs2GjSFoFUv97ANNwdgtegFApSCKwG13",
                "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F077012D3AC9600",
                "BookNode": "0",
                "Expiration": 818265624,
                "Flags": 0,
                "LedgerEntryType": "Offer",
                "OwnerNode": "0",
                "PreviousTxnID": "D2FEF1F07F3370F3A50447D2ACE5355239BA3CF097713FA8B7A86B4C07614F21",
                "PreviousTxnLgrSeq": 100673880,
                "Sequence": 94926852,
                "TakerGets": "50000000",
                "TakerPays": {
                    "currency": "USD",
                    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                    "value": "104.67755"
                },
                "index": "584B1D0B78D0D125542BA1FEC6F879EEB3A0A400DAF9C67C87F45269FA074C51",
                "owner_funds": "599349852",
                "quality": "0.000002093551"
            },
            {
                "Account": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah",
                "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F0778C74BA67600",
                "BookNode": "0",
                "Flags": 0,
                "LedgerEntryType": "Offer",
                "OwnerNode": "1",
                "PreviousTxnID": "64E780F016DDCFD7E06FDAB8EF04741163541CA5ED6BA29E01304ED3F2E6B3B5",
                "PreviousTxnLgrSeq": 100673908,
                "Sequence": 205309892,
                "TakerGets": "21195000000",
                "TakerPays": {
                    "currency": "USD",
                    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                    "value": "44575.675029"
                },
                "index": "630555CB00D03B4550341433064C0B943FAE030D775AADF97D0DD28AF6018C8C",
                "owner_funds": "21287921615",
                "quality": "0.0000021031222"
            },
            {
                "Account": "r3rhWeE31Jt5sWmi4QiGLMZnY3ENgqw96W",
                "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F0778C76A34A72B",
                "BookNode": "0",
                "Flags": 0,
                "LedgerEntryType": "Offer",
                "OwnerNode": "18246",
                "PreviousTxnID": "C94C8B082D274DC3BD9BFADD79EC2BD284BE9ABD8321348A9482434A9A930DB1",
                "PreviousTxnLgrSeq": 100673881,
                "Sequence": 149337369,
                "TakerGets": "26701707636",
                "TakerPays": {
                    "currency": "USD",
                    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                    "value": "56156.96779541579"
                },
                "index": "FCA00078A167801C0CA746B9FEF39268F63EA182A6F43A530B1F3AABCCC837E2",
                "owner_funds": "73523794145",
                "quality": "0.000002103122712635179"
            },
            {
                "Account": "rBci5N2MQdXjZtUQzFxrQHM6kssarRASTi",
                "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F08108D8FA3E000",
                "BookNode": "0",
                "Flags": 131072,
                "LedgerEntryType": "Offer",
                "OwnerNode": "a",
                "PreviousTxnID": "027CD2727362FD47BE9ACF36931EFDC5E9904FA27F6340A47454CD18D30C65B3",
                "PreviousTxnLgrSeq": 100440627,
                "Sequence": 18017,
                "TakerGets": "20000000",
                "TakerPays": {
                    "currency": "USD",
                    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                    "value": "45.4"
                },
                "index": "214207C60BFAFF0A25EA0F6931DD297D08A10B533616AD294201D4D2B730078E",
                "owner_funds": "4409438087",
                "quality": "0.00000227"
            },
            {
                "Account": "rBci5N2MQdXjZtUQzFxrQHM6kssarRASTi",
                "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F082BD67AFBC000",
                "BookNode": "0",
                "Flags": 131072,
                "LedgerEntryType": "Offer",
                "OwnerNode": "a",
                "PreviousTxnID": "2D9284707B613DEF5DDD1DC481468663F0EA320E5763CB54382E4352DCB0B46C",
                "PreviousTxnLgrSeq": 100284890,
                "Sequence": 17991,
                "TakerGets": "20000000",
                "TakerPays": {
                    "currency": "USD",
                    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                    "value": "46"
                },
                "index": "BDDB4C4D25D3F88AB3E5178E686A650720397A62D8A821A7C4F760666AEA7617",
                "quality": "0.0000023"
            },
            {
                "Account": "rBci5N2MQdXjZtUQzFxrQHM6kssarRASTi",
                "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F0886C98B760000",
                "BookNode": "0",
                "Flags": 131072,
                "LedgerEntryType": "Offer",
                "OwnerNode": "a",
                "PreviousTxnID": "3075FABF91A5B09DB4429672FAAABAFF1D13230A9143E219603EB4C3E0D8F46A",
                "PreviousTxnLgrSeq": 100284901,
                "Sequence": 17992,
                "TakerGets": "20000000",
                "TakerPays": {
                    "currency": "USD",
                    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                    "value": "48"
                },
                "index": "A67F247764A91C18BC8DC6C04619F15D802710BD0942CD06B3530041D96D7EFD",
                "quality": "0.0000024"
            },
            {
                "Account": "rdmZRvr9aBdGwzF2DwYBnHxTUDomJoiaQ",
                "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F08AC8113424A4F",
                "BookNode": "0",
                "Flags": 0,
                "LedgerEntryType": "Offer",
                "OwnerNode": "0",
                "PreviousTxnID": "F3990D2DF4C1AC4BE7FD9AF255BD10616160A4E65407E76C9165AE77EA38C1EC",
                "PreviousTxnLgrSeq": 100185003,
                "Sequence": 99489972,
                "TakerGets": "4409417",
                "TakerPays": {
                    "currency": "USD",
                    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                    "value": "10.76546015"
                },
                "index": "917AE821342A33933968C0062EF54CB6CB5DAB01037D7EBA3E46944E28F312E5",
                "owner_funds": "0",
                "quality": "0.000002441470187555407",
                "taker_gets_funded": "0",
                "taker_pays_funded": {
                    "currency": "USD",
                    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                    "value": "0"
                }
            },
            {
                "Account": "rBci5N2MQdXjZtUQzFxrQHM6kssarRASTi",
                "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F08CF8BFF0B0000",
                "BookNode": "0",
                "Flags": 131072,
                "LedgerEntryType": "Offer",
                "OwnerNode": "a",
                "PreviousTxnID": "F9E8D4AA753D5B77DDF2F8CF10461D4798E7FF76B494041D724CEBCB788A08F8",
                "PreviousTxnLgrSeq": 100284885,
                "Sequence": 17990,
                "TakerGets": "20000000",
                "TakerPays": {
                    "currency": "USD",
                    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                    "value": "49.6"
                },
                "index": "044BDF2F19E20A3C5E06459E315AEE5470A4567B532049A5822EF7BA23F301E7",
                "quality": "0.00000248"
            },
            {
                "Account": "rdmZRvr9aBdGwzF2DwYBnHxTUDomJoiaQ",
                "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F08DEF1B23D15A7",
                "BookNode": "0",
                "Flags": 0,
                "LedgerEntryType": "Offer",
                "OwnerNode": "0",
                "PreviousTxnID": "EB98549F31D2A43E9F90CD8BE37CE7C8428337AC0883264EAA34060E37D92B7E",
                "PreviousTxnLgrSeq": 100184237,
                "Sequence": 99489917,
                "TakerGets": "2266464",
                "TakerPays": {
                    "currency": "USD",
                    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                    "value": "5.65920076"
                },
                "index": "F2976FAB02CB36D9843477F11D13CB8F9C99B6A8202030EC6044BC682E136AB9",
                "quality": "0.000002496929472517543",
                "taker_gets_funded": "0",
                "taker_pays_funded": {
                    "currency": "USD",
                    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                    "value": "0"
                }
            },
            {
                "Account": "rdmZRvr9aBdGwzF2DwYBnHxTUDomJoiaQ",
                "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F08DEF1BF2A0443",
                "BookNode": "0",
                "Flags": 0,
                "LedgerEntryType": "Offer",
                "OwnerNode": "0",
                "PreviousTxnID": "733DC95FBAE9F6F7083F0A75838AD1963270E21E939AD882FD4C99377CAC1B84",
                "PreviousTxnLgrSeq": 100184194,
                "Sequence": 99489913,
                "TakerGets": "2266471",
                "TakerPays": {
                    "currency": "USD",
                    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                    "value": "5.65921873"
                },
                "index": "573BCABED4A00D2CB94B447A85A13DE2A355C6DF41B1CF4825FF30794EBB8906",
                "quality": "0.000002496929689371715",
                "taker_gets_funded": "0",
                "taker_pays_funded": {
                    "currency": "USD",
                    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                    "value": "0"
                }
            }
        ],
        "validated": false
    },
    "status": "success",
    "type": "response"
}

deposit_authorized

Checks whether one account is authorized to send payments directly to another.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "deposit_authorized",
  "source_account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "destination_account": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
  "ledger_index": "validated"
}

Example response: 200

{
    "result": {
        "deposit_authorized": true,
        "destination_account": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
        "ledger_hash": "F09BFCCD969F59EAA3AABF18BAE4D2BE5494A905DDB718B4352587CD64D59C64",
        "ledger_index": 100673919,
        "source_account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
        "validated": true
    },
    "status": "success",
    "type": "response"
}

get_aggregate_price

Retrieves the aggregate price of specified Oracle objects, returning three price statistics: mean, median, and trimmed mean.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "get_aggregate_price",
  "ledger_index": "current",
  "base_asset": "XRP",
  "quote_asset": "USD",
  "trim": 20,
  "oracles": [
    {
      "account": "rNZ9m6AP9K7z3EVg6GhPMx36V4QmZKeWds",
      "oracle_document_id": 34
    },
    {
      "account": "rMVKq8zrVsJZQFEiTARyC6WfZznhhLMcNi",
      "oracle_document_id": 100
    },
    {
      "account": "r92kJTnUbUUq15t2BBZYGYxY79RnNc7rLQ",
      "oracle_document_id": 2
    }
  ]
}

Example response: 200

{
    "error": "objectNotFound",
    "error_code": 92,
    "error_message": "The requested object was not found.",
    "ledger_current_index": 100673942,
    "request": {
        "base_asset": "XRP",
        "command": "get_aggregate_price",
        "ledger_index": "current",
        "oracles": [
            {
                "account": "rNZ9m6AP9K7z3EVg6GhPMx36V4QmZKeWds",
                "oracle_document_id": 34
            },
            {
                "account": "rMVKq8zrVsJZQFEiTARyC6WfZznhhLMcNi",
                "oracle_document_id": 100
            },
            {
                "account": "r92kJTnUbUUq15t2BBZYGYxY79RnNc7rLQ",
                "oracle_document_id": 2
            }
        ],
        "quote_asset": "USD",
        "trim": 20
    },
    "status": "error",
    "type": "response",
    "validated": false
}

path_find

Returns information about a uncle of a block by number and uncle index position.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "path_find",
  "subcommand": "create",
  "source_account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "destination_account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "destination_amount": {
    "value": "0.001",
    "currency": "USD",
    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
  }
}

Example response: 200

{
    "result": {
        "alternatives": [
            {
                "paths_computed": [
                    [
                        {
                            "currency": "USD",
                            "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
                            "type": 48
                        }
                    ]
                ],
                "source_amount": "482"
            }
        ],
        "destination_account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
        "destination_amount": {
            "currency": "USD",
            "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
            "value": "0.001"
        },
        "full_reply": false,
        "source_account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
    },
    "status": "success",
    "type": "response"
}

Payment Channel Methods

channel_verify

Checks the validity of a signature that can be used to redeem a specific amount of XRP from a payment channel.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "channel_verify",
  "channel_id": "5DB01B7FFED6B67E6B0414DED11E051D2EE2B7619CE0EAA6286D67A3A4D5BDB3",
  "signature": "304402204EF0AFB78AC23ED1C472E74F4299C0C21F1B21D07EFC0A3838A420F76D783A400220154FB11B6F54320666E4C36CA7F686C16A3A0456800BBC43746F34AF50290064",
  "public_key": "aB44YfzW24VDEJQ2UuLPV2PvqcPCSoLnL7y5M1EzhdW4LnK5xMS3",
  "amount": "1000000"
}

Example response: 200

{
    "result": {
        "signature_verified": true
    },
    "status": "success",
    "type": "response"
}

Subscription Methods

subscribe

Requests periodic notifications from the server when certain events happen.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "id": "Example",
  "command": "subscribe",
  "streams": [
    "ledger"
  ],
  "accounts": [
    "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1"
  ]
}

Example response: 200

{
    "id": "Example",
    "result": {
        "fee_base": 10,
        "ledger_hash": "7E4D71BCA3163482C7CF7E420BBBD3B3EDDC21489CEAE17B64ACB849FE58E9BA",
        "ledger_index": 100674056,
        "ledger_time": 818266201,
        "network_id": 0,
        "reserve_base": 1000000,
        "reserve_inc": 200000,
        "validated_ledgers": "99774974-100674056"
    },
    "status": "success",
    "type": "response"
}

unsubscribe

Tells the server to stop sending messages for a particular subscription or set of subscriptions.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "id": "Example",
  "command": "unsubscribe",
  "streams": [
    "ledger"
  ],
  "accounts": [
    "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1"
  ]
}

Example response: 200

{
    "id": "Example",
    "result": {},
    "status": "success",
    "type": "response"
}

Server Info Methods

fee

Reports the current state of the open-ledger requirements for the transaction cost.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "id": "example",
  "command": "fee"
}

Example response: 200

{
    "id": "example",
    "result": {
        "current_ledger_size": "135",
        "current_queue_size": "0",
        "drops": {
            "base_fee": "10",
            "median_fee": "5000",
            "minimum_fee": "10",
            "open_ledger_fee": "10"
        },
        "expected_ledger_size": "396",
        "ledger_current_index": 100674087,
        "levels": {
            "median_level": "128000",
            "minimum_level": "256",
            "open_ledger_level": "256",
            "reference_level": "256"
        },
        "max_queue_size": "7920"
    },
    "status": "success",
    "type": "response"
}

manifest

Look up manifest information for a given validator public key.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "id": "manifest_example",
  "command": "manifest",
  "public_key": "nHUFE9prPXPrHcG3SkwP1UzAQbSphqyQkQK9ATXLZsfkezhhda3p"
}

Example response: 200

{
    "id": "manifest_example",
    "result": {
        "details": {
            "domain": "alloy.ee",
            "ephemeral_key": "n9LMfcjE6dMyshCqiftLFXpB9K3Mnd2r5bG7K8osmrkFpHUoR3c1",
            "master_key": "nHUFE9prPXPrHcG3SkwP1UzAQbSphqyQkQK9ATXLZsfkezhhda3p",
            "seq": 4
        },
        "manifest": "JAAAAARxIe3AkJgOyqs3y+UuiAI27Ff3Mrfbt8e7mjdo06bnGEp5XnMhAu2LSAwZEQnm/mq9K6sSZJk5JkbcKCv6C7vQW2C8RnZVdkcwRQIhAI9uwQ1p58oyob1E+DaFLwjTdiRbVIKSMPqaaUwnJdN2AiB79DlPXHwztNULraVTkehbDsCAyDdf3VZB3FvkCZNOFHcIYWxsb3kuZWVwEkBf6A9ktcj2H4a61Av8ujQFL2KNcmr/FuEKbwlZEniJvhf0UqNiYc2bAsTJE5wMn00E0JBbw2m9OFwto50DcdkC",
        "requested": "nHUFE9prPXPrHcG3SkwP1UzAQbSphqyQkQK9ATXLZsfkezhhda3p"
    },
    "status": "success",
    "type": "response"
}

server_definitions

Returns an SDK-compatible definitions.json, generated from the rippled server being queried.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "server_definitions"
}

Example response: 200

{
    "result": {
        "FIELDS": [
            [
                "Generic",
                {
                    "isSerialized": false,
                    "isSigningField": false,
                    "isVLEncoded": false,
                    "nth": 0,
                    "type": "Unknown"
                }
            ],
            [
                "Invalid",
                {
                    "isSerialized": false,
                    "isSigningField": false,
                    "isVLEncoded": false,
                    "nth": -1,
                    "type": "Unknown"
                }
            ],
            [
                "ObjectEndMarker",
                {
                    "isSerialized": true,
                    "isSigningField": true,
                    "isVLEncoded": false,
                    "nth": 1,
                    "type": "STObject"
                }
            ],
            [
                "ArrayEndMarker",
                {
                    "isSerialized": true,
                    "isSigningField": true,
                    "isVLEncoded": false,
                    "nth": 1,
                    "type": "STArray"
                }
            ],
            [
                "taker_gets_funded",
                {
                    "isSerialized": false,
                    "isSigningField": false,
                    "isVLEncoded": false,
                    "nth": 258,
                    "type": "Amount"
                }
            ],
            [
                "taker_pays_funded",
                {
                    "isSerialized": false,
                    "isSigningField": false,
                    "isVLEncoded": false,
                    "nth": 259,
                    "type": "Amount"
                }
            ],
. . .

server_info

Reports a human-readable version of various information about the rippled server being queried.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "server_info"
}

Example response: 200

{
    "result": {
        "info": {
            "build_version": "2.6.2",
            "complete_ledgers": "99774974-100674198",
            "hostid": "79d3b270d046",
            "initial_sync_duration_us": "431394639",
            "io_latency_ms": 1,
            "jq_trans_overflow": "0",
            "last_close": {
                "converge_time_s": 3.001,
                "proposers": 35
            },
            "load": {
                "job_types": [
                    {
                        "job_type": "clientFeeChange",
                        "peak_time": 1,
                        "per_second": 28
                    },
                    {
                        "avg_time": 1,
                        "job_type": "clientRPC",
                        "peak_time": 22,
                        "per_second": 2
                    },
                    {
                        "in_progress": 1,
                        "job_type": "clientWebsocket",
                        "peak_time": 14,
                        "per_second": 5
                    },
                    {
                        "job_type": "untrustedValidation",
                        "peak_time": 2,
                        "per_second": 29
                    },
                    {
                        "job_type": "ledgerRequest",
                        "per_second": 1
                    },
                    {
                        "job_type": "transaction",
                        "peak_time": 3,
                        "per_second": 29
                    },
                    {
                        "job_type": "batch",
                        "peak_time": 2,
                        "per_second": 24
                    },
                    {
                        "avg_time": 1,
                        "job_type": "ledgerData",
                        "peak_time": 57,
                        "per_second": 3
                    },
                    {
                        "avg_time": 1,
                        "job_type": "advanceLedger",
                        "peak_time": 42,
                        "per_second": 4
                    },
                    {
                        "job_type": "fetchTxnData",
                        "peak_time": 1,
                        "per_second": 8
                    },
                    {
                        "job_type": "trustedValidation",
                        "peak_time": 5,
                        "per_second": 7
                    },
                    {
                        "job_type": "trustedProposal",
                        "per_second": 14
                    },
                    {
                        "job_type": "peerCommand",
                        "per_second": 1581
                    },
                    {
                        "job_type": "processTransaction",
                        "peak_time": 3,
                        "per_second": 29
                    },
                    {
                        "job_type": "SyncReadNode",
                        "per_second": 89
                    },
                    {
                        "job_type": "AsyncReadNode",
                        "per_second": 1822
                    },
                    {
                        "job_type": "WriteNode",
                        "per_second": 465
                    }
                ],
                "threads": 14
            },
            "load_factor": 1,
            "node_size": "huge",
            "peer_disconnects": "31",
            "peer_disconnects_resources": "10",
            "peers": 21,
            "ports": [
                {
                    "port": "5005",
                    "protocol": [
                        "http"
                    ]
                },
                {
                    "port": "51235",
                    "protocol": [
                        "peer"
                    ]
                },
                {
                    "port": "6006",
                    "protocol": [
                        "ws"
                    ]
                },
                {
                    "port": "6005",
                    "protocol": [
                        "wss"
                    ]
                }
            ],
            "pubkey_node": "n9L5RhNsW3s9Ps9uTvuXm4WD3Da8KWfPbusZhExTnCgnU2kDXA21",
            "pubkey_validator": "none",
            "server_state": "full",
            "server_state_duration_us": "366045887685",
            "state_accounting": {
                "connected": {
                    "duration_us": "427191121",
                    "transitions": "2"
                },
                "disconnected": {
                    "duration_us": "1107490",
                    "transitions": "2"
                },
                "full": {
                    "duration_us": "366045887685",
                    "transitions": "1"
                },
                "syncing": {
                    "duration_us": "3096003",
                    "transitions": "1"
                },
                "tracking": {
                    "duration_us": "24",
                    "transitions": "1"
                }
            },
            "time": "2025-Dec-05 16:19:20.917506 UTC",
            "uptime": 366477,
            "validated_ledger": {
                "age": 3,
                "base_fee_xrp": 1e-05,
                "hash": "2B90617342116D6ED893CE535714B51600B0657C1EA5C620EF5E170EEB4C1FEF",
                "reserve_base_xrp": 1,
                "reserve_inc_xrp": 0.2,
                "seq": 100674198
            },
            "validation_quorum": 30,
            "validator_list": {
                "count": 2,
                "expiration": "2026-Jan-18 00:00:00.000000000 UTC",
                "status": "active"
            }
        }
    },
    "status": "success",
    "type": "response"
}

server_state

Reports a machine-readable version of various information about the rippled server being queried.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "server_state"
}

Example response: 200

{
    "result": {
        "state": {
            "build_version": "2.6.2",
            "complete_ledgers": "99774974-100674219",
            "initial_sync_duration_us": "431394639",
            "io_latency_ms": 1,
            "jq_trans_overflow": "0",
            "last_close": {
                "converge_time": 3001,
                "proposers": 35
            },
            "load": {
                "job_types": [
                    {
                        "job_type": "clientFeeChange",
                        "per_second": 25
                    },
                    {
                        "avg_time": 1,
                        "job_type": "clientRPC",
                        "peak_time": 16,
                        "per_second": 2
                    },
                    {
                        "in_progress": 1,
                        "job_type": "clientWebsocket",
                        "peak_time": 13,
                        "per_second": 3
                    },
                    {
                        "job_type": "untrustedValidation",
                        "peak_time": 4,
                        "per_second": 35
                    },
                    {
                        "job_type": "ledgerRequest",
                        "peak_time": 3,
                        "per_second": 2
                    },
                    {
                        "job_type": "transaction",
                        "peak_time": 1,
                        "per_second": 25
                    },
                    {
                        "job_type": "batch",
                        "peak_time": 4,
                        "per_second": 23
                    },
                    {
                        "avg_time": 1,
                        "job_type": "ledgerData",
                        "peak_time": 28,
                        "per_second": 2
                    },
                    {
                        "avg_time": 2,
                        "job_type": "advanceLedger",
                        "peak_time": 70,
                        "per_second": 2
                    },
                    {
                        "job_type": "fetchTxnData",
                        "peak_time": 1,
                        "per_second": 18
                    },
                    {
                        "job_type": "trustedValidation",
                        "peak_time": 1,
                        "per_second": 8
                    },
                    {
                        "job_type": "trustedProposal",
                        "per_second": 16
                    },
                    {
                        "avg_time": 1,
                        "job_type": "heartbeat",
                        "peak_time": 1
                    },
                    {
                        "job_type": "peerCommand",
                        "peak_time": 1,
                        "per_second": 1827
                    },
                    {
                        "job_type": "processTransaction",
                        "per_second": 25
                    },
                    {
                        "job_type": "SyncReadNode",
                        "per_second": 135
                    },
                    {
                        "job_type": "AsyncReadNode",
                        "per_second": 418
                    },
                    {
                        "job_type": "WriteNode",
                        "per_second": 739
                    }
                ],
                "threads": 14
            },
            "load_base": 256,
            "load_factor": 256,
            "load_factor_fee_escalation": 256,
            "load_factor_fee_queue": 256,
            "load_factor_fee_reference": 256,
            "load_factor_server": 256,
            "node_size": "huge",
            "peer_disconnects": "31",
            "peer_disconnects_resources": "10",
            "peers": 21,
            "ports": [
                {
                    "port": "5005",
                    "protocol": [
                        "http"
                    ]
                },
                {
                    "port": "51235",
                    "protocol": [
                        "peer"
                    ]
                },
                {
                    "port": "6006",
                    "protocol": [
                        "ws"
                    ]
                },
                {
                    "port": "6005",
                    "protocol": [
                        "wss"
                    ]
                }
            ],
            "pubkey_node": "n9L5RhNsW3s9Ps9uTvuXm4WD3Da8KWfPbusZhExTnCgnU2kDXA21",
            "pubkey_validator": "none",
            "server_state": "full",
            "server_state_duration_us": "366125315568",
            "state_accounting": {
                "connected": {
                    "duration_us": "427191121",
                    "transitions": "2"
                },
                "disconnected": {
                    "duration_us": "1107490",
                    "transitions": "2"
                },
                "full": {
                    "duration_us": "366125315568",
                    "transitions": "1"
                },
                "syncing": {
                    "duration_us": "3096003",
                    "transitions": "1"
                },
                "tracking": {
                    "duration_us": "24",
                    "transitions": "1"
                }
            },
            "time": "2025-Dec-05 16:20:40.345380 UTC",
            "uptime": 366556,
            "validated_ledger": {
                "base_fee": 10,
                "close_time": 818266840,
                "hash": "CF9F027BB1F3DE3FE999AF53A9D25328A127D2C7D740CD5240D6D202AABE9152",
                "reserve_base": 1000000,
                "reserve_inc": 200000,
                "seq": 100674219
            },
            "validation_quorum": 30,
            "validator_list_expires": 822009600
        }
    },
    "status": "success",
    "type": "response"
}

version

Retrieves the API version information. When you connect to a cluster that includes a Clio server, the Clio method is used.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "version"
}

Example response: 200

{
    "result": {
        "version": {
            "first": "1.0.0",
            "good": "1.0.0",
            "last": "1.0.0"
        }
    },
    "status": "success",
    "type": "response"
}

feature

Returns information about amendments this server knows about. When you connect to a cluster that includes a Clio server, the Clio method is used.

wss://xrp.nownodes.io/wss/{{api-key}}

Example body (raw)

{
  "command": "feature",
  "feature": "4C97EBA926031A7CF7D7B36FDE3ED66DDA5421192D63DE53FFB46E43B9DC8373"
}

Example response: 200

{
    "result": {
        "4C97EBA926031A7CF7D7B36FDE3ED66DDA5421192D63DE53FFB46E43B9DC8373": {
            "enabled": true,
            "name": "MultiSign",
            "supported": true
        }
    },
    "status": "success",
    "type": "response"
}