Removal Date: 2025-11-02
This first deprecation batch focuses on the representation of transactions and their effects. Specifically, it aims to standardize how transaction effects are structured across all supported transaction types, simplifying integration and making behavior more predictable for developers.
The following API endpoints are affected by this change:
GET /api/v1/transactions/{id}GET /api/v1/transactionsPOST /api/v1/transactionsPOST /api/v1/transactions/create-and-waitPOST /api/v1/transactions/predict
The table below lists the fields that will be removed as part of this batch, along with their recommended replacements. The deprecated fields are currently still available but will be permanently removed on 2025-11-02. The replacement fields are already readily available.
| Context | Field Name | Location | Purpose/Description | Replacement Field |
|---|---|---|---|---|
Under transaction response when type is aptos_transaction | type | expected_result.effects.balance_changes.typemined_result.effects.balance_changes.type | Representing the type (native/coin) of the effected asset | priced_asset.asset_info.asset_identifier.type |
owner | expected_result.effects.balance_changes.owner | Representing the address whose balance was changed | address | |
fiat_price | expected_result.fee_statement.fiat_price | Representing the fiat price of the asset used for fee | priced_asset.price | |
Under transaction response when type is cosmos_transaction | type | expected_result.effects.balance_changes.type | Representing the type (native/token) of the effected asset | priced_asset.asset_info.asset_identifier.type |
coin_info | expected_result.effects.balance_changes.coin_info | Details about the coin being transferred | priced_asset | |
owner | expected_result.effects.balance_changes.owner | Representing the address whose balance was changed | address | |
price | expected_result.effects.transfers.price | Representing the fiat price of the asset transferred | priced_asset.price | |
from | from | The address sending the transaction | sender | |
Under transaction response when type is evm_transaction | type | expected_result.effects.balance_changes.type | Representing the type (native/erc20/erc721/erc1155) of the effected asset | priced_asset.asset_info.asset_identifier.type |
token_contract | expected_result.effects.balance_changes.token_contract | Representing the contract of the effected asset | priced_asset.asset_info | |
price | expected_result.effects.balance_changes.price | Representing the fiat price of the asset transferred | priced_asset.price | |
token_id | expected_result.effects.balance_changes.token_id | Representing the token_id of the effected asset in case it’s an NFT | priced_asset.asset_info | |
owner | expected_result.effects.balance_changes.owner | Representing the address whose balance was changed | address | |
owned | expected_result.effects.balance_changes.owned | Representing if it’s an ownership change of an NFT | diff | |
token | mined_result.effects.bridge.source.token | Representing the contract of the effected asset | priced_asset.asset_info | |
fiat_price | expected_result.effects.gas_debit.fiat_price | Representing the fiat price of the asset used for fee | priced_asset.price | |
Under transaction response when type is solana_transaction | type | expected_result.effects.balance_changes.type | Representing the type (native/spl) of the effected asset | priced_asset.asset_info.asset_identifier.type |
price | expected_result.effects.balance_changes.price | Representing the fiat price of the asset transferred | priced_asset.price | |
token_contract | expected_result.effects.balance_changes.token_contract | Representing the contract of the effected asset | priced_asset.asset_info | |
owner | expected_result.effects.balance_changes.owner | Representing the address whose balance was changed | address | |
fee | expected_result.fee | Representing the full fee in lamports paid by the transaction | enriched_fee.fee | |
fiat_price | expected_result.enriched_fee.fiat_price | Representing the fiat price of the asset used for fee | enriched_fee.priced_asset.price | |
Under transaction response when type is starknet_transaction | fiat_price | expected_result.fees.fiat_price | Representing the fiat price of the asset used for fee | fees.priced_asset.price |
Under transaction response when type is sui_transaction | type | expected_result.effects.balance_changes.type | Representing the type (native/coin) of the effected asset | priced_asset.asset_info.asset_identifier.type |
owner | expected_result.effects.balance_changes.owner | Representing the address whose balance was changed | address | |
fiat_price | expected_result.enriched_gas.fiat_price | Representing the fiat price of the asset used for fee | enriched_gas.priced_asset.price | |
Under transaction response when type is ton_transaction | fiat_price | expected_result.address_fees.fiat_price | Representing the fiat price of the asset used for fee | address_fees.priced_asset.price |
Under transaction response when type is utxo_transaction | price | expected_result.effects.price | Representing the fiat price of the asset | effects.priced_asset.price |
fiat_price | expected_result.fees.fiat_price | Representing the fiat price of the asset used for fee | fees.priced_asset.price |