N9T2 XRPL Agent Gateway

ReadRead-only currentXRPL current-account-state lookup for one account. `account` must be a valid XRPL classic account stateaddress; includingthe result returns the current balance, sequence, owner count, flags, and settings.account settings without submitting or modifying any XRPL transaction, and calls remain subject to the configured gateway rate limits. Use this for onecurrent account;account notstate only; use n9t2_xrpl_get_transaction or n9t2_xrpl_list_account_transactions for transaction history, orand n9t2_xrpl_get_ledger_data for raw ledger objects.

{"properties":{"account":{"description":"XRPL classic account address whose current account state should be retrieved.","title":"Account","type":"string"}} ⟨6 unchanged words⟩ 

Retrieve detailedRead-only XRPL Automated Market Maker (AMM) state lookup for a specifiedspecific pool. Identify the pool with `amm_account`, or with the paired `asset` and `asset2` currency objects; `account` is optional context used by the native AMM accountlookup when applicable. Use `ledger_hash` or asset`ledger_index` pair.to Returnspin the lookup to a specific ledger. The result returns native amm_info`amm_info` data including pool balances, LP token supply, trading fee, auction slot, and vote slots when present. This is read-onlypaid andlookup does not modify the ledger.ledger and is subject to the configured gateway rate limits. Use this for AMM pool state; use n9t2_xrpl_get_book_offers for DEX order-book depth and n9t2_xrpl_get_ledger_data for raw ledger-state objects.

 ⟨5 unchanged words⟩ type":"null"}],"default":null,"description":"Optional XRPL account used by the native AMM lookup when applicable.","title":"Account"},"amm_account":{"anyOf" ⟨2 unchanged words⟩ type":"null"}],"default":null,"description":"Optional AMM account address identifying the specific AMM ledger object.","title":"Amm Account"},"asset":{" ⟨5 unchanged words⟩ type":"null"}],"default":null,"description":"First AMM asset specification using an XRPL currency object.","title":"Asset"},"asset2":{"anyOf" ⟨4 unchanged words⟩ type":"null"}],"default":null,"description":"Second AMM asset specification paired with asset.","title":"Asset2"},"ledger_hash":{"anyOf" ⟨2 unchanged words⟩ type":"null"}],"default":null,"description":"Optional ledger hash used to pin the AMM lookup to a specific ledger.","title":"Ledger Hash"},"ledger_index":{" ⟨5 unchanged words⟩ {"type":"null"}],"default":null,"description":"Optional ledger index or selector used to pin the lookup to a specific ledger.","title":"Ledger Index"}},"title" ⟨3 unchanged words⟩ 

Read theRead-only XRPL DEX orderorder-book booklookup for a specific trading pair. `taker_gets` and `taker_pays` are the required XRPL currency-specification objects that define the two sides of the book; `limit` optionally caps the number of offers returned. The result provides global book offers and market-depth data without modifying the ledger, and calls are subject to the configured gateway rate limits. Use this for global DEX order-book depth; use n9t2_xrpl_list_account_offers for one account's outstanding offers and marketn9t2_xrpl_find_path depth;when notyou account-ownedneed offers.payment-path discovery instead.

 ⟨5 unchanged words⟩ type":"null"}],"default":null,"description":"Optional maximum number of DEX order-book offers to return.","title":"Limit"},"taker_gets":{"additionalProperties":true,"description":"Currency specification for the asset the taker receives in the XRPL DEX order book.","title":"Taker Gets","type":"object"},"taker_pays":{"additionalProperties":true,"description":"Currency specification for the asset the taker pays in the XRPL DEX order book.","title":"Taker Pays","type":" ⟨8 unchanged words⟩ 

CalculateRead-only XRPL issued-asset balancesexposure forcalculation anfor XRPLone issuing account. Use`account` is the required XRPL issuer address; optionally use `hotwallet` with one address or a list of operational hot-wallet addresses when those balances should be included in the calculation, and use `ledger_index` to inspectpin issuedthe IOUcalculation to a specific ledger. `strict` controls how account identifiers are interpreted. The result reports the calculated issued-asset exposure without modifying the ledger, and operationalcalls hot-walletare balances.subject to the configured gateway rate limits. Use this for issuer-level issued-asset exposure; do not use it for trust-line holdings of a single account, where n9t2_xrpl_list_account_lines is the appropriate tool.

{"properties":{"account":{"description":"XRPL issuing account whose issued-asset balances should be calculated.","title":"Account","type":"string"}, ⟨9 unchanged words⟩ type":"null"}],"default":null,"description":"Optional XRPL hot-wallet account address or list of hot-wallet addresses.","title":"Hotwallet"},"ledger_index":{"anyOf" ⟨4 unchanged words⟩ type":"null"}],"default":null,"description":"Optional ledger index or selector for the balance calculation.","title":"Ledger Index"},"strict":{"default":false,"description":"Whether account identifiers should be interpreted strictly as supplied.","title":"Strict","type":"boolean" ⟨6 unchanged words⟩ 

ReadRead-only XRPL ledger header and optionalmetadata lookup. Omit `ledger_index` to use the current validated ledger, or provide a validated ledger index/selector to pin the lookup; set `transactions=true` to include that ledger's transactions and use `expand=true` to return those transactions as full objects. The result provides ledger metadata and, when requested, transaction listing.data without modifying the ledger, and calls are subject to the configured gateway rate limits. Use this for ledger metadata;headers, notmetadata, and optional ledger transactions; use n9t2_xrpl_get_ledger_data instead when you need raw ledger-state objects.

 ⟨5 unchanged words⟩ type":"null"}],"default":null,"description":"Whether returned transactions should be expanded into full transaction objects.","title":"Expand"},"ledger_index":{"anyOf" ⟨4 unchanged words⟩ type":"null"}],"default":null,"description":"Optional validated ledger index or ledger selector. Omit to use the current validated ledger.","title":"Ledger Index"},"transactions":{" ⟨3 unchanged words⟩ {"type":"null"}],"default":null,"description":"Whether to include transactions contained in the requested ledger.","title":"Transactions"}},"title":" ⟨3 unchanged words⟩ 

ReadRead-only XRPL raw XRPLledger-state lookup for a ledger. Omit `ledger_index` to use the default ledger, or provide a ledger index/selector to pin the lookup; use `limit` to cap the number of ledger-state objects returned and paginatepass with`marker` marker.from a previous response to continue pagination. The result returns raw canonical ledger-state entries without modifying the ledger; large state queries should be paginated, and calls are subject to the configured gateway rate limits. Use this for ledgercanonical entries;ledger-state notobjects; use n9t2_xrpl_get_ledger for ledger headerheaders metadata.and transaction-list metadata instead.

 ⟨7 unchanged words⟩ type":"null"}],"default":null,"description":"Optional ledger index or selector identifying the ledger whose state objects should be returned.","title":"Ledger Index"},"limit":{" ⟨3 unchanged words⟩ type":"null"}],"default":null,"description":"Optional maximum number of ledger-state objects to return.","title":"Limit"},"marker":{"anyOf" ⟨4 unchanged words⟩ {"type":"null"}],"default":null,"description":"Pagination marker returned by a previous response.","title":"Marker"}},"title":" ⟨3 unchanged words⟩ 

ReadRead-only XRPL server`server_info` lookup for node health, server state, and validated-ledger information.status. Use tothis inspectbefore interpreting ledger-dependent results when node statehealth or freshness matters; the result provides the node/server status and validated-ledger information needed to assess whether subsequent ledger reads are current and usable. Use n9t2_xrpl_get_ledger for ledger validationmetadata status.or n9t2_xrpl_get_ledger_data for raw ledger-state entries; this tool requires no parameters and does not modify the ledger.

Retrieve oneRead-only XRPL transaction bylookup for one canonical transaction hash. `transaction` is the required hash; set `binary=true` only when binary-encoded transaction data is required, otherwise use the normal transaction representation. The result retrieves transaction data for that hash without modifying the ledger, and calls are subject to the configured gateway rate limits. Use this when the transaction hash is already known; notuse n9t2_xrpl_list_account_transactions for account-wide history.transaction history instead.

 ⟨5 unchanged words⟩ type":"null"}],"default":null,"description":"Whether to return the transaction in binary encoded form.","title":"Binary"},"transaction":{"description":"Canonical XRPL transaction hash to retrieve.","title":"Transaction","type":"string"} ⟨6 unchanged words⟩ 

ListRead-only XRPL Payment ChannelsChannel ownedlookup byfor theone account. By`account` is the required XRPL classic account address; by default, the lookup returns channels where thethat account is the source. Use destination_account`destination_account` to filter to channels whoseby destination, is`ledger_index` to pin the lookup to a specificvalidated account.ledger, Useand `marker` to inspectcontinue pagination; `limit` caps returned channels beforeand ordefaults afterto PaymentChannelCreate/Fund/Claim.200. The result lists Payment Channel entries without modifying the ledger, and calls are subject to the configured gateway rate limits. Use this for PaymentChannelCreate/Fund/Claim inspection; use n9t2_xrpl_list_account_objects for generic account ledger objects instead.

{"properties":{"account":{"description":"XRPL classic account address whose Payment Channels should be listed.","title":"Account","type":"string"}, ⟨31 unchanged words⟩ type":"null"}],"default":null,"description":"Optional validated ledger index or selector.","title":"Ledger Index"},"limit":{"default":200,"description":"Maximum number of Payment Channel entries to return. Default is 200.","title":"Limit","type":"integer"}, ⟨6 unchanged words⟩ {"type":"null"}],"default":null,"description":"Pagination marker returned by a previous response.","title":"Marker"}},"required":[ ⟨5 unchanged words⟩ 

ListRead-only XRPL trusttrust-line lineslookup for anone account. `account` is the required XRPL classic account address; use `peer` to restrict results to one counterparty, `limit` to cap returned trust lines, `marker` to continue pagination from a previous response, and `ledger_index` to pin the lookup to a validated ledger. The result lists trust-line state including issued-asset balances and limits without modifying the ledger, and calls are subject to the configured gateway rate limits. Use tothis inspectfor trust-linean stateaccount's beforetrust lines and issued-asset holdings; use n9t2_xrpl_get_account_info for current account state or aftern9t2_xrpl_list_account_objects TrustSet.for other ledger objects.

{"properties":{"account":{"description":"XRPL classic account address whose trust lines should be listed.","title":"Account","type":"string"}, ⟨6 unchanged words⟩ type":"null"}],"default":null,"description":"Optional validated ledger index or selector.","title":"Ledger Index"},"limit":{" ⟨3 unchanged words⟩ type":"null"}],"default":null,"description":"Optional maximum number of trust lines to return.","title":"Limit"},"marker":{"anyOf" ⟨4 unchanged words⟩ type":"null"}],"default":null,"description":"Pagination marker returned by a previous response.","title":"Marker"},"peer":{"anyOf" ⟨2 unchanged words⟩ {"type":"null"}],"default":null,"description":"Optional XRPL classic account address used to filter trust lines to a specific peer.","title":"Peer"}},"required":[ ⟨5 unchanged words⟩ 

ListRead-only NFTsXRPL ownedNFT byinventory anlookup XRPLfor one classic account using the native account_nfts`account_nfts` method. Use this instead of list_account_objects whenThe youresult needprovides NFT-specific fields such as NFTokenID`NFTokenID`, Issuer`Issuer`, NFTokenTaxon`NFTokenTaxon`, URI`URI`, and nft_serial.`nft_serial`; Thisuse is`marker` read-onlyto continue pagination and does`ledger_hash` notor modify`ledger_index` to pin the inventory lookup to a specific ledger. Calls are subject to the configured gateway rate limits. Use ledger_hashthis orfor ledger_indexNFTs toowned pinby thean ledger,account; anduse passn9t2_xrpl_list_nft_offers markerfor frommarketplace buy/sell offers on a previousspecific responseNFTokenID, toor continuen9t2_xrpl_list_account_objects pagination.when raw account ledger objects rather than NFT-specific fields are required.

{"properties":{"account":{"description":"XRPL classic account address whose owned NFTs should be listed.","title":"Account","type":"string"}, ⟨4 unchanged words⟩ type":"null"}],"default":null,"description":"Optional ledger hash used to pin the NFT inventory lookup.","title":"Ledger Hash"},"ledger_index":{" ⟨5 unchanged words⟩ type":"null"}],"default":null,"description":"Optional validated ledger index or selector.","title":"Ledger Index"},"limit":{" ⟨3 unchanged words⟩ type":"null"}],"default":null,"description":"Optional maximum number of owned NFT records to return.","title":"Limit"},"marker":{"anyOf" ⟨4 unchanged words⟩ {"type":"null"}],"default":null,"description":"Pagination marker returned by a previous response.","title":"Marker"}},"required":[ ⟨5 unchanged words⟩ 

Inspect raw/canonicalRead-only XRPL ledgercanonical objectsledger-object associatedlookup withfor anone account. Use this low-level view for ledger object types that do not havewhen ano dedicated N9T2 lister, exists or when canonicalnative ledger-entry fields are required. For account-level NFT offers, setSet object_type to nft_offer`nft_offer` to filter raw NFTokenOffer ledgerentries; entries.use `ledger_index` to pin the lookup and `limit`/`marker` to control pagination. Use n9t2_xrpl_list_account_offers for classic DEX offers and n9t2_xrpl_list_account_channels for paymentPayment channels.Channels. This returns raw canonical ledger entries; for NFT marketplace offers, use n9t2_xrpl_list_nft_offers when you need the normalized offer view.

{"properties":{"account":{"description":"XRPL classic account address whose canonical ledger objects should be inspected.","title":"Account","type":"string"},"deletion_blockers_only":{"default":false,"description":"Whether to return only ledger objects that prevent account deletion.","title":"Deletion Blockers Only","type":" ⟨7 unchanged words⟩ type":"null"}],"default":null,"description":"Optional validated ledger index or selector.","title":"Ledger Index"},"limit":{" ⟨3 unchanged words⟩ type":"null"}],"default":null,"description":"Optional maximum number of ledger objects to return.","title":"Limit"},"marker":{"anyOf" ⟨4 unchanged words⟩ type":"null"}],"default":null,"description":"Pagination marker returned by a previous response.","title":"Marker"},"object_type":{"anyOf" ⟨26 unchanged words⟩ {"type":"null"}],"default":null,"description":"Optional filter controlling sponsored ledger objects.","title":"Sponsored"}},"required":[ ⟨5 unchanged words⟩ 

List outstandingRead-only XRPL DEX offersaccount-offer ownedlookup byfor one account. Returns that account's outstanding offers rather than global order-book depth; use n9t2_xrpl_get_book_offers for global market depth. Use `limit` to inspectbound results and `marker` to continue pagination, `ledger_index` to pin the lookup to a validated ledger, and `strict` when the account identifier must be interpreted exactly as supplied. Use this for the account's own open offers; it does not create, cancel, or modify any XRPL offer and is subject to the globalconfigured ordergateway book.rate limits.

{"properties":{"account":{"description":"XRPL classic account address whose outstanding DEX offers should be listed.","title":"Account","type":"string"}, ⟨6 unchanged words⟩ type":"null"}],"default":null,"description":"Optional validated ledger index or selector.","title":"Ledger Index"},"limit":{" ⟨3 unchanged words⟩ type":"null"}],"default":null,"description":"Optional maximum number of open offers to return.","title":"Limit"},"marker":{"anyOf" ⟨4 unchanged words⟩ type":"null"}],"default":null,"description":"Pagination marker returned by a previous response.","title":"Marker"},"strict":{"default":false,"description":"Whether the account identifier should be interpreted strictly as supplied.","title":"Strict","type":"boolean" ⟨6 unchanged words⟩ 

ReadRead-only transactionXRPL historytransaction-history lookup for one XRPL account over an optional ledger range. Use this for multiple transactionsaccount transactions; use n9t2_xrpl_get_transaction when a transaction hash is already known. `ledger_index_min` and `ledger_index_max` narrow the history window, notwhile `limit` bounds the returned records; when the response includes a singlepagination marker, more history remains beyond the current page. The result contains account transaction lookup.records and does not modify the ledger or submit transactions, and calls are subject to the configured gateway rate limits.

{"properties":{"account":{"description":"XRPL classic account address whose transaction history should be retrieved.","title":"Account","type":"string"}, ⟨4 unchanged words⟩ type":"null"}],"default":null,"description":"Optional maximum ledger index for the transaction-history range.","title":"Ledger Index Max"},"ledger_index_min": ⟨3 unchanged words⟩ type":"null"}],"default":null,"description":"Optional minimum ledger index for the transaction-history range.","title":"Ledger Index Min"},"limit": ⟨3 unchanged words⟩ {"type":"null"}],"default":null,"description":"Optional maximum number of transactions to return.","title":"Limit"}},"required":[ ⟨5 unchanged words⟩ 

RetrieveRead-only XRPL NFT marketplacemarketplace-offer offerslookup for a specific NFToken.one UseNFTokenID. offer_type=buy`offer_type=buy` forretrieves native nft_buy_offers`nft_buy_offers`, sell for`sell` nativeretrieves nft_sell_offers`nft_sell_offers`, orand `both` retrieves both tosides; retrieve`buy_marker` bothand `sell_marker` paginate the two sides inindependently. oneUse paid`ledger_hash` call.or Supports`ledger_index` ledgerto pinningpin the lookup to a ledger, and independent`limit` paginationto markers.bound Thisreturned isoffers. read-onlyUse this for marketplace offers on a specific NFT; use n9t2_xrpl_list_account_nfts for owned-NFT inventory and doesn9t2_xrpl_list_account_objects notwith modify`object_type='nft_offer'` thewhen ledger.raw NFTokenOffer ledger entries are required.

 ⟨7 unchanged words⟩ type":"null"}],"default":null,"description":"Pagination marker for the NFT buy-offer side.","title":"Buy Marker"},"ledger_hash":{" ⟨3 unchanged words⟩ type":"null"}],"default":null,"description":"Optional ledger hash used to pin the NFT-offer lookup.","title":"Ledger Hash"},"ledger_index":{" ⟨5 unchanged words⟩ type":"null"}],"default":null,"description":"Optional validated ledger index or selector.","title":"Ledger Index"},"limit":{" ⟨3 unchanged words⟩ type":"null"}],"default":null,"description":"Optional maximum number of NFT offers to return.","title":"Limit"},"nft_id":{"description":"Canonical NFTokenID identifying the NFT whose marketplace offers should be retrieved.","title":"Nft Id","type":"string"},"offer_type":{"default":"both","description":"NFT marketplace offer side to retrieve: buy, sell, or both. Default is both.","title":"Offer Type","type":"string" ⟨6 unchanged words⟩ {"type":"null"}],"default":null,"description":"Pagination marker for the NFT sell-offer side.","title":"Sell Marker"}},"required" ⟨5 unchanged words⟩ 

 ⟨6 unchanged words⟩ agent-local signing. Choose exactly one transaction_type and provide itsthat typedtransaction XRPLmodel's parametersfields in parameters. N9T2 routesparameters; establishedunsupported transaction types to theiror existinginvalid validators/buildersbuilder andparameters supportsare additionalrejected XRPLbefore modelsan includingunsigned Clawback,transaction DID,is OracleSet/OracleDelete,returned. TicketCreateSequence, NFTokenModifyfee, and XChainlast_ledger_sequence operations.may Omitbe sequence,autofilled feewhen omitted. The result is unsigned transaction JSON for local signing; after signing, andpass last_ledger_sequencethe tosigned autofilltx_blob them.to n9t2_xrpl_submit_transaction. N9T2 never receives or stores private keys, seeds, or wallet secretssecrets. andUse neverthis signsas transactionsthe server-side.generic transaction-construction primitive for supported XRPL transaction types, including Payment, TrustSet, OfferCreate, and OfferCancel.

{"properties":{"parameters":{"additionalProperties":true,"description":"Typed XRPL transaction fields used to build the unsigned transaction. Sequence, fee, and last_ledger_sequence may be autofilled when omitted.","title":"Parameters","type":"object"},"transaction_type":{"description":"XRPL transaction model name to prepare, selected from the supported transaction types advertised by this tool.","enum":["Payment","TrustSet","OfferCreate" ⟨87 unchanged words⟩ 

Submit anone already-signed XRPL transaction blob.to N9T2the network. `tx_blob` must be the complete signed transaction encoded as hexadecimal; obtain it from the caller's local signing step, normally after `n9t2_xrpl_prepare_transaction`. This action mutates ledger state when the transaction is accepted into the XRPL network and must never signsreceive transactionsprivate keys, seeds, or receiveswallet privatesecrets. keys.`fail_hard` forwards rippled's option and defaults to false; when true, a transaction that fails locally is not retried or relayed. The result preserves the raw submit response, including `engine_result` and `engine_result_message` and, when returned, `accepted`, `queued`, `validated`, and transaction data. Submission is tentative; use `n9t2_xrpl_get_transaction` with the returned transaction hash to confirm validated-ledger inclusion. Invalid hexadecimal or XRPL-rejected blobs return an error.

{"properties":{"fail_hard":{"default":false,"description":"Forward rippled's fail_hard option. When true, a transaction that fails locally is not retried or relayed to other servers. Defaults to false.","title":"Fail Hard","type":"boolean"},"tx_blob":{"description":"Complete signed XRPL transaction encoded as hexadecimal. The caller must sign locally before sending it to N9T2.","title":"Tx Blob","type":"string ⟨6 unchanged words⟩ 

Open a bounded native XRPL WebSocket subscription and capture live events for the requestedselected streams, accounts, proposed transactions, or order  ⟨10 unchanged words⟩ of a one-time snapshot. The tool sends the native XRPL subscribe command, collects events foruntil duration_seconds expires or max_events is reached, then closes the connection and returns the subscription acknowledgement plus captured events. ItWhen subscription inputs are omitted, the default is the ledger stream for 3 seconds with up to 25 events. This is read-only: it does not submit transactions or modify ledger state. Default behavior subscribes to the ledger stream for 3 seconds. Do not request the admin-only peer_status stream unless ⟨6 unchanged words⟩ 

 ⟨8 unchanged words⟩ type":"null"}],"default":null,"description":"Optional list of XRPL classic account addresses whose activity should be streamed.","title":"Accounts"},"accounts_proposed":{"anyOf" ⟨5 unchanged words⟩ type":"null"}],"default":null,"description":"Optional list of XRPL accounts for proposed transaction events.","title":"Accounts Proposed"},"books":{" ⟨8 unchanged words⟩ type":"null"}],"default":null,"description":"Optional list of XRPL order-book subscription descriptors.","title":"Books"},"duration_seconds":{"default":3,"description":"How many seconds the bounded WebSocket subscription remains open. Default is 3.","title":"Duration Seconds","type":"integer"},"max_events":{"default":25,"description":"Maximum number of events to capture before returning. Default is 25.","title":"Max Events","type":"integer" ⟨7 unchanged words⟩ {"type":"null"}],"default":null,"description":"Optional XRPL stream names such as ledger or transactions.","title":"Streams"}},"title":" ⟨3 unchanged words⟩