POST /testnet/rpc
POST

/v1/testnet/rpc

The XRP Ledger's own READ commands against our Testnet node — the half of Testnet that is not in the index: account_objects, book_offers, amm_info, ledger_entry, server_info and the rest. Reads only (submitting is POST /testnet/submit); the node's in-band error (actNotFound, entryNotFound) rides in result with a 200, as on Mainnet

AuthNone — works without a key

Request

POSThttps://api.xrpl.to/v1/testnet/rpc
Body
Body fieldsas documented
{
  method (one of the read commands),
  params (the command's own fields as an object)
}
curl -X POST 'https://api.xrpl.to/v1/testnet/rpc'
No public sample for this one — copy the code and fill in your own values.

Response

No public sample for this endpoint — run the code on the right with your own values to see the response.
Shapeas documented
{
  success,
  took,
  method,
  result (the node's own result,
  verbatim)
}

What it does

The XRP Ledger's own READ commands against our Testnet node — the half of Testnet that is not in the index: account_objects, book_offers, amm_info, ledger_entry, server_info and the rest. Reads only (submitting is POST /testnet/submit); the node's in-band error (actNotFound, entryNotFound) rides in result with a 200, as on Mainnet

Notes
Every public read command of rippled's own table (src/xrpld/rpc/detail/Handler.cpp, Role::USER), minus the ones that sign or submit and the ones that need a session: account_channels, account_currencies, account_info, account_lines, account_nfts, account_objects, account_offers, account_tx, amm_info, book_changes, book_offers, channel_verify, deposit_authorized, feature, fee, gateway_balances, get_aggregate_price, ledger, ledger_closed, ledger_current, ledger_data, ledger_entry, ledger_header, ledger_index, manifest, mpt_holders, nft_buy_offers, nft_history, nft_info, nft_sell_offers, nfts_by_issuer, noripple_check, owner_info, ping, random, ripple_path_find, server_definitions, server_info, server_state, simulate, transaction_entry, tx, tx_history, tx_reduce_relay, vault_info, version (the Clio-only ones answer unknownCmd on a node that is not Clio, which is itself the answer). subscribe, unsubscribe and path_find are WebSocket commands — open wss://s.altnet.rippletest.net:51233 (or your own node) and send them there
Start at GET /v1/testnet/fixtures: it names live accounts, a busy token, an NFT with offers and one of every ledger object that xrpl.to keeps alive on Testnet, plus a real transaction of every type. Testnet resets without warning; the data is rebuilt from the chain within minutes, and only objects touched since count. Open the Testnet sandbox →
OpenAPI