Skip to main content
GET
/
v3
/
wallets
/
{address}
/
polyusd-flows
Wallet PolyUSD flows
curl --request GET \
  --url https://api.polynode.dev/v3/wallets/{address}/polyusd-flows \
  --header 'x-api-key: <api-key>'

Documentation Index

Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt

Use this file to discover all available pages before exploring further.

Returns PolyUSD deposit and withdrawal history for one wallet directly from Polygon logs. Deposits are PolyUSD Wrapped events from the Collateral Onramp or Permissioned Ramp where the wallet receives minted PolyUSD. Withdrawals are PolyUSD transfers from the wallet into the PolyUSD contract, correlated with a same-transaction Unwrapped event from the Collateral Offramp or Permissioned Ramp.
This endpoint is wallet-scoped and chain-backed. It does not require the full PolyUSD indexer, and it excludes internal settlement adapter unwraps used by V2 split/trading mechanics.

​
Request

GET /v3/wallets/{address}/polyusd-flows

​
Query parameters

ParameterTypeDefaultDescription
kindstringallall, deposit, or withdrawal
afterinteger0Start of time range (Unix seconds, inclusive)
beforeintegerunlimitedEnd of time range (Unix seconds, inclusive)
orderstringdescasc or desc
limitinteger100Max 1000
offsetinteger0Pagination offset

​
Example

curl "https://api.polynode.dev/v3/wallets/0x2a1f579283C87c4574102bbF6E4B39F7A12fe77E/polyusd-flows?limit=2"

{
  "address": "0x2a1f579283c87c4574102bbf6e4b39f7a12fe77e",
  "flows": [
    {
      "event_type": "withdrawal",
      "direction": "out",
      "amount": 2690.200068,
      "amount_usdc": 2690.200068,
      "amount_raw": "2690200068",
      "asset": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
      "asset_symbol": "USDC.e",
      "ramp": "CollateralOfframp",
      "source_event": "Transfer+Unwrapped",
      "transaction_hash": "0xed54095cbf5c5f434cd3c12d7d226e8922bb40d597d0c61a623412567b5f0e45"
    },
    {
      "event_type": "deposit",
      "direction": "in",
      "amount": 1500,
      "amount_usdc": 1500,
      "amount_raw": "1500000000",
      "asset": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
      "asset_symbol": "USDC.e",
      "ramp": "CollateralOnramp",
      "source_event": "Wrapped",
      "transaction_hash": "0x1d516fa44c127232be3f8aad9dc974fca73e2f1e1c8716914a8ef6c8222cbf25"
    }
  ],
  "rows_returned": 2,
  "total_matching_rows": 21,
  "has_more": true,
  "total_deposited": 12854.05392,
  "total_withdrawn": 5930.200068,
  "net_deposited": 6923.853852,
  "source": "polygon_rpc_pusd_wrap_unwrap"
}

​
Response fields

FieldTypeDescription
addressstringWallet address, lowercased
flowsarrayDeposit and withdrawal rows for the requested page
flows[].event_typestringdeposit or withdrawal
flows[].directionstringin for deposits, out for withdrawals
flows[].amountnumber6-decimal normalized USD amount
flows[].amount_rawstringRaw PolyUSD amount
flows[].assetstringUnderlying asset address
flows[].asset_symbolstringUSDC.e, USDC, or unknown
flows[].rampstringRamp contract used
flows[].recipientstringRecipient of minted PolyUSD or unwrapped USDC/USDC.e
flows[].transaction_hashstringPolygon transaction hash
flows[].block_numberintegerPolygon block number
flows[].block_timestampintegerPolygon block timestamp
rows_returnedintegerNumber of rows returned
total_matching_rowsintegerTotal rows after filters before pagination
has_morebooleanWhether another page exists
total_depositednumberSum of matching deposit rows
total_withdrawnnumberSum of matching withdrawal rows
net_depositednumberDeposits minus withdrawals
sourcestringpolygon_rpc_pusd_wrap_unwrap

​
Errors

HTTPWhen
400Invalid wallet address, kind, or order
401Missing or invalid PolyNode API key
502Polygon RPC upstream failure

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
address
string
required

Wallet address

Query Parameters

​
kind
enum<string>
default:all

Flow type to return

Available options:
all,
deposit,
withdrawal
​
after
integer
default:0

Unix timestamp lower bound

​
before
integer

Unix timestamp upper bound

​
order
enum<string>
default:desc

Sort order

Available options:
asc,
desc
​
limit
integer
default:100

Max results, clamped to 1000

​
offset
integer
default:0

Pagination offset

Response

PolyUSD deposit and withdrawal rows