The ETH credit debit table allows you to easily track the inflows and outflows of ether belonging to all addresses.

ETH can be transferred across wallets in different ways:

How is polygon.assets.credit_debit different from polygon.raw.transactions ?

  • While transactions table includes the value of MATIC in direct transfers, MATIC transferred via the smart contract router will not be reflected in the value field

  • In contrast, credit_debit table will show all MATIC transferred.

    • value_transfer from sender pool to the recipient

    • gas_payment_to_miner from the transaction initiator to the miners and;

    • gas_burn from the transaction

Table Columns

Using USDC Transfers as an example.

Column NameDescriptionExample
addressAddress of the account that was credited or debited value amount of MATIC0x1c59c0e754494e509d666e90e6719171e6ff187b
counterparty_addressThe address of counter party of this credit or debit transfer.0x1e9dc0785011df9004aa928a60eb7334c298b9fc
token_addressToken address of the ERC1155 token.0x2791bca1f2de4661ed88a30c99a7a9449aa84174
token_nameName of the ERC1155 token.USD Coin (PoS)
token_symbolToken symbol of this token.USDC
token_idUnique token ID of the ERC1155 token.
raw_amountAmount of ETH in wei-52,465
raw_amount_strAmount of ETH in wei in string.-52465
amountAmount of ether.-0.052465
amount_strAmount of ether in string.-0.052465
usd_amountThe amount of ether moved, in $USD.-0.052454507
usd_exchange_rateThe exchange rate used to calculate the usd_value.0.9998
transaction_hashTransaction hash that this transfer belongs to.0x12e266fbb3512452c4d2aeef148dc2686376f8930c4d5b3b022cee83c3416fc8
block_timestampThe timestamp of the block that the corresponding transaction of this transfer belongs to. This is also the timestamp when this transfer occurred.2021-10-08 04:36:11
block_numberThe block number that the corresponding transaction of this transfer belongs to.19,970,494
block_hashThe block hash that the corresponding transaction of this transfer belongs to.0x6db8796783dca30f0f5069235355b80958f10f7e1745f068ca8e9443a38656e0
token_typeToken type of asset. Includes ETH, ERC20, ERC721 and ERC1155.ERC20
unique_idUnique id generated to each transfer. Includes trace call, transaction_hash, credit and debit transaction type.txn-0x12e266fbb3512452c4d2aeef148dc2686376f8930c4d5b3b022cee83c3416fc8_log_index-80_credit