INCOMING XRP Ledger (xrp, XRP, ripple, XRPL) transfers to an r-address — where this account
received XRP and issued tokens from, newest first: sender, amount, currency, Destination_Tag,
record Type and transaction type per row. Use it to trace the source of funds backwards, and
with destination_tag to list the deposits of ONE customer of an exchange account. Page back
through older history with cursor: pass the Cursor value of the LAST row of a page — unlike
before_time it never skips rows that share a ledger. Same record types and amount rules as
xrp_transfers_out; for the aggregated view use xrp_address_flow_summary.
AMOUNTS: Amount / Currency is what this account actually received (the delivered amount, never
the inflated face value of a partial payment); Sent_Amount / Sent_Currency is what the sender
actually spent. They differ on a cross-currency payment, and can also differ on a payment of an
issued token (for example by the issuer's transfer fee). XRP is in XRP (not drops).
TYPE: payment = a Payment from another account (Sender = this account means a currency
conversion); trade = a standing exchange offer of this account was filled; other = one leg of
an account deletion, check, escrow release, payment-channel claim, AMM or NFT sale, or
path-payment rounding, so Sender is EMPTY here. Rounding remainders of that kind below
0.000001 (floating-point leftovers of token payments and offer fills, no real value; a token
issuer receives hundreds of thousands) are hidden unless include_dust=1. For an account
deletion, cashed check, AMM or NFT sale the paying leg is a separate record of the same
transaction: open the Tx with
xrp_tx_transfers to see who paid. An escrow release or payment-channel claim pays out what was
locked in an EARLIER transaction, so its payer is not in that transaction. nft_trade / mint /
burn = NFTs (Currency is the NFT id). Fees never appear here (the fees an account paid are
listed by xrp_transfers_out with include_fees=1), and neither do failed transactions —
except a failed (expired) NFT offer acceptance, which still shows its nft_trade record although
the NFT did not move; xrp_tx_transfers shows Success. Pass type='payment' for payments only.
CURRENCY: native XRP is always Currency_Id 413663; any other currency is an issued token, and
its Currency_Id identifies only the CODE — look-alike issuers airdrop counterfeit "RLUSD",
"USD" and similar tokens under the same code. Pin the real token with currency_id plus issuer
(keeps payments that delivered that issuer's token).
USD: Price_Usd is the hourly USD price of Currency at the time of the transfer and Value_Usd =
Amount x Price_Usd - for XRP only (Price_Status ok). An issued token has no price here
(Price_Status no_price, both columns null): never assume one, a currency code says nothing
about the token's value. The newest hour may not be priced yet. Amounts and their filters stay
in TOKEN UNITS (there is no usd filter), and amounts of different currencies must not be
compared or added together: pin ONE currency with currency_id, or bound the range with
min_amount / max_amount.
Destination_Tag: "0" = no tag. An account whose incoming payments nearly all carry different
tags is a shared (exchange / custodial) deposit account. Rows carry no labels: identify senders
with labels_for_addresses(chain='ripple') — coverage is sparse, mostly exchange reserve wallets.
Covers the LAST 90 DAYS by default; raise days to reach older history (a short or empty page
can just mean the window ended, not that the history did). Records arrive a few minutes after
the ledger closes.
Returns limit transfers per page (default 20, at most 1000), newest first, plus any records identical in
every field to the last one (so a page can exceed limit); a sort='amount' page is a top-N and
carries no Cursor.
Each row: Time, Sender, Currency, Currency_Id, Amount, Sent_Currency, Sent_Currency_Id, Sent_Amount, Destination_Tag, Type, Tx_Type, Ledger, Tx, Price_Usd, Value_Usd, Price_Status, Cursor.