> ## Documentation Index > Fetch the complete documentation index at: https://docs.li.fi/llms.txt > Use this file to discover all available pages before exploring further. # 获取过滤的转账列表 > 此端点返回根据指定条件过滤的转账列表，可用于分析和监控跨链转账活动。 ## OpenAPI ````yaml get /v1/analytics/transfers openapi: 3.0.2 info: title: LI.FI API version: 1.0.0 description: >- LI.FI provides the best cross-chain swap across all liquidity pools and bridges. servers: - url: https://li.quest description: LI.FI Production Environment - url: https://staging.li.quest description: LI.FI Staging Environment security: [] paths: /v1/analytics/transfers: get: summary: Get a list of filtered transfers description: >- This endpoint can be used to retrieve a list of transfers filtered by certain properties. Returns a maximum of 1000 transfers. parameters: - name: integrator description: The integrator string to filter by schema: type: string in: query - name: wallet description: 'The sending OR receiving wallet address ' schema: type: string in: query - name: status description: >- The status of the transfers. Possible values are `ALL`, `DONE`, `PENDING`, and `FAILED`. The default is `DONE` schema: type: string in: query - name: fromTimestamp description: >- The oldest timestamp that should be taken into consideration. Defaults to 30 days ago schema: type: number in: query - name: toTimestamp description: >- The newest timestamp that should be taken into consideration. Defaults to now schema: type: number in: query - name: fromChain description: The chain where the transfer originates from. schema: type: string in: query - name: toChain description: The chain where the transfer ends. schema: type: string in: query - name: fromToken description: >- The token transferred from the originating chain. To use this parameter `fromChain` must be set. schema: type: string in: query - name: toToken description: >- The token received on the destination chain. To use this parameter `toChain` must be set. schema: type: string in: query responses: '200': $ref: '#/components/responses/TransfersResponse' components: responses: TransfersResponse: content: application/json: schema: type: object properties: transfers: type: array items: $ref: '#/components/schemas/StatusResponse' examples: Transfers: value: transfers: - transactionId: >- 0x8c58bf99537331b38f15f5ca9718b6fcf86bdb678a2935cf0ca2106066f07550 sending: txHash: >- 0x37b56ab04df432aa84f14d94f3af2ef65c10141df37ffe60f216c0505fc43178 txLink: >- https://explorer.zksync.io/tx/0x37b56ab04df432aa84f14d94f3af2ef65c10141df37ffe60f216c0505fc43178 amount: '1000000' token: address: '0x3355df6D4c9C3035724Fd0e3914dE96A5a83aaf4' chainId: 324 symbol: USDC decimals: 6 name: USD Coin coinKey: USDC logoURI: >- https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png priceUSD: '1.00' chainId: 324 gasPrice: '250000000' gasUsed: '1428505' gasToken: address: '0x0000000000000000000000000000000000000000' chainId: 324 symbol: ETH decimals: 18 name: ETH coinKey: ETH logoURI: >- https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png priceUSD: '1676.49' gasAmount: '357126250000000' gasAmountUSD: '0.60' amountUSD: '1.0000' timestamp: 1698076232 value: '0' receiving: txHash: >- 0x37b56ab04df432aa84f14d94f3af2ef65c10141df37ffe60f216c0505fc43178 txLink: >- https://explorer.zksync.io/tx/0x37b56ab04df432aa84f14d94f3af2ef65c10141df37ffe60f216c0505fc43178 amount: '999255' token: address: '0x493257fD37EDB34451f62EDf8D2a0C418852bA4C' chainId: 324 symbol: USDT decimals: 6 name: Tether USD coinKey: USDT logoURI: >- https://static.debank.com/image/brise_token/logo_url/0xc7e6d7e08a89209f02af47965337714153c529f0/3c1a718331e468abe1fc2ebe319f6c77.png priceUSD: '1.0000' chainId: 324 gasPrice: '250000000' gasUsed: '1428505' gasToken: address: '0x0000000000000000000000000000000000000000' chainId: 324 symbol: ETH decimals: 18 name: ETH coinKey: ETH logoURI: >- https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png priceUSD: '1676.49' gasAmount: '357126250000000' gasAmountUSD: '0.60' amountUSD: '1.0000' timestamp: 1698076232 value: '0' lifiExplorerLink: >- https://explorer.li.fi/tx/0x37b56ab04df432aa84f14d94f3af2ef65c10141df37ffe60f216c0505fc43178 fromAddress: '0x552008c0f6870c2f77e5cc1d2eb9bdff03e30ea0' toAddress: '0x552008c0f6870c2f77e5cc1d2eb9bdff03e30ea0' tool: solver3 status: DONE substatus: COMPLETED substatusMessage: The transfer is complete. description: Response for `GET /analytics/transfers` endpoint schemas: StatusResponse: title: Root Type for StatusResponse description: The current status of a transfer required: - sending - status - tool type: object properties: sending: $ref: '#/components/schemas/TransactionInfo' description: The transaction on the sending chain receiving: $ref: '#/components/schemas/TransactionInfo' description: The transaction on the receiving chain feeCosts: description: An array of fee costs for the transaction type: array items: type: object properties: name: type: string description: type: string percentage: type: string token: type: object properties: address: type: string decimals: format: number type: number symbol: type: string chainId: format: number type: number coinKey: type: string name: type: string logoURI: type: string amount: type: string amountUSD: type: string included: type: boolean status: description: >- The current status of the transfer. Can be `PENDING`, `DONE`, `NOT_FOUND` or `FAILED` enum: - NOT_FOUND - INVALID - PENDING - DONE - FAILED type: string substatus: description: >- A more specific substatus. This is available for PENDING and DONE statuses. More information can be found here: https://docs.li.fi/introduction/user-flows-and-examples/status-tracking enum: - WAIT_SOURCE_CONFIRMATIONS - WAIT_DESTINATION_TRANSACTION - BRIDGE_NOT_AVAILABLE - CHAIN_NOT_AVAILABLE - REFUND_IN_PROGRESS - UNKNOWN_ERROR - COMPLETED - PARTIAL - REFUNDED substatusMessage: description: A message that describes the substatus type: string tool: description: The tool used for this transfer type: string transactionId: description: The ID of this transfer (NOT a transaction hash). type: string fromAddress: description: The address of the sender. type: string toAddress: description: The address of the receiver. type: string lifiExplorerLink: description: The link to the LI.FI explorer. type: string metadata: $ref: '#/components/schemas/Metadata' description: The transaction metadata which includes integrator's string, etc. quote: $ref: '#/components/schemas/TransferQuote' description: >- The quote that was issued for this transfer at quote time, so the estimated outcome (`quote.estimate`) can be compared against the actual one (`receiving`). Omitted when no quote data is known for the transfer. example: sending: txHash: '0xd3ad8fb8798d8440f3a1ec7fd51e102a88e4690f9365fad4eff1a17020376b4a' txLink: >- https://polygonscan.com/tx/0xd3ad8fb8798d8440f3a1ec7fd51e102a88e4690f9365fad4eff1a17020376b4a amount: '13000000' token: address: '0xd69b31c3225728cc57ddaf9be532a4ee1620be51' symbol: anyUSDC decimals: 6 chainId: 137 name: USDC coinKey: anyUSDC priceUSD: '0' logoURI: '' chainId: 137 gasToken: address: '0x0000000000000000000000000000000000001010' symbol: MATIC decimals: 18 chainId: 137 name: MATIC coinKey: MATIC priceUSD: '0' logoURI: '' gasAmount: '10000' gasAmountUSD: '0.0' gasPrice: '1000' gasUsed: '1000' timestamp: 1720545119 value: '0' receiving: txHash: '0xba2793065e20835ef60993144d92e6bc1a86529a70e16c357f66ad13774868ad' txLink: >- https://bscscan.com/tx/0xba2793065e20835ef60993144d92e6bc1a86529a70e16c357f66ad13774868ad amount: '12100000000000000000' token: address: '0x8965349fb649a33a30cbfda057d8ec2c48abe2a2' symbol: anyUSDC decimals: 18 chainId: 56 name: USDC coinKey: anyUSDC priceUSD: '0' logoURI: '' chainId: 56 gasToken: address: '0x0000000000000000000000000000000000001010' symbol: BNB decimals: 18 chainId: 56 name: BNB coinKey: BNB priceUSD: '0' logoURI: '' gasAmount: '10000' gasAmountUSD: '0.0' gasPrice: '1000' gasUsed: '1000' timestamp: 1720560232 value: '0' tool: anyswap status: DONE substatus: COMPLETED substatusMessage: The transfer is complete. transactionId: '0x0000000000000000000000000000000000001010' fromAddress: '0x0000000000000000000000000000000000001010' toAddress: '0x0000000000000000000000000000000000001010' lifiExplorerLink: >- https://scan.li.fi/tx/0xd3ad8fb8798d8440f3a1ec7fd51e102a88e4690f9365fad4eff1a17020376b4a metadata: integrator: jumper.exchange TransactionInfo: title: Root Type for TransactionInfo description: A transaction info object required: - txLink - amount - txHash - token - chainId type: object properties: txHash: description: The hash of the transaction type: string txLink: description: Link to a block explorer showing the transaction type: string amount: description: The amount of the transaction type: string token: $ref: '#/components/schemas/Token' description: Information about the token chainId: description: The id of the chain type: number gasToken: $ref: '#/components/schemas/Token' description: The token in which gas was paid gasAmount: description: The amount of the gas that was paid type: string gasAmountUSD: description: The amount of the gas that was paid in USD type: string gasPrice: description: The price of the gas type: string gasUsed: description: The amount of the gas that was used type: string timestamp: description: The transaction timestamp type: number value: description: The transaction value type: string includedSteps: description: An array of swap or protocol steps included in the LI.FI transaction type: array items: $ref: '#/components/schemas/IncludedSwapSteps' example: txHash: '0xd3ad8fb8798d8440f3a1ec7fd51e102a88e4690f9365fad4eff1a17020376b4a' txLink: >- https://polygonscan.com/tx/0xd3ad8fb8798d8440f3a1ec7fd51e102a88e4690f9365fad4eff1a17020376b4a amount: '13000000' token: address: '0xd69b31c3225728cc57ddaf9be532a4ee1620be51' symbol: anyUSDC decimals: 6 chainId: 137 name: USDC coinKey: anyUSDC priceUSD: '0' logoURI: '' gasToken: address: '0x0000000000000000000000000000000000001010' symbol: MATIC decimals: 18 chainId: 137 name: MATIC coinKey: MATIC priceUSD: '0' logoURI: '' chainId: 137 gasAmount: '10000' gasAmountUSD: '0.0' gasPrice: '1000' gasUsed: '1000' timestamp: 1720545119 value: '0' Metadata: title: Root type for Transaction Metadata description: The metadata of the transaction which includes integrator data, etc. type: object properties: integrator: description: Integrator ID type: string TransferQuote: title: Root Type for TransferQuote description: >- The quote that was issued for a transfer at quote time. The `action` describes what was requested and the `estimate` records the quoted amounts and costs, so they can be compared against the actual outcome reported by the status response. required: - stepId - tool - type - action - estimate - includedSteps - gasLimit - createdAt type: object properties: stepId: description: The id of the quoted step, matching `id` on the quote response. type: string tool: description: The tool that was quoted for this transfer. type: string type: description: The type of the quoted step. type: string action: $ref: '#/components/schemas/Action' description: What was requested at quote time. estimate: $ref: '#/components/schemas/Estimate' description: The amounts and costs estimated at quote time. includedSteps: description: The steps included in the quoted step. type: array items: type: object required: - tool - type - action - estimate properties: tool: type: string type: type: string action: $ref: '#/components/schemas/Action' estimate: $ref: '#/components/schemas/Estimate' integrator: description: The integrator the quote was issued for. type: string gasLimit: description: The gas limit of the transaction that was proposed at quote time. type: string createdAt: description: When the quote was issued (ISO 8601). type: string format: date-time Token: title: Root Type for Token description: Representation of a Token required: - address - chainId - decimals - name - symbol type: object properties: address: description: Address of the token type: string decimals: format: number description: Number of decimals the token uses type: number symbol: description: Symbol of the token type: string chainId: format: number description: Id of the token's chain type: number coinKey: description: Identifier for the token type: string name: description: Name of the token type: string logoURI: description: Logo of the token type: string priceUSD: description: Token price in USD type: string example: address: '0x8f3cf7ad23cd3cadbd9735aff958023239c6a063' symbol: DAI decimals: 18 chainId: 137 name: (PoS) Dai Stablecoin coinKey: DAI priceUSD: '1' logoURI: >- https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png IncludedSwapSteps: title: Root type for included swaps or protocol steps in the status response description: >- The included steps contain tool name and details, sending and receiving token data and amounts. type: object properties: tool: description: The tool used for this step type: string toolDetails: description: >- The details of the tool used for this step. E.g. `1inch` or `feeProtocol` type: object properties: key: description: The tool key type: string name: description: The tool name type: string logoURI: description: The tool logo URL type: string fromAmount: description: The amount that was sent to the tool type: string fromToken: description: The token that was sent to the tool type: string toAmount: description: The amount that was received from the tool type: string toToken: description: The token that was received from the tool type: string bridgedAmount: description: The amount that was sent to the bridge type: string Action: title: Root Type for Action description: Object describing what happens in a `Step` required: - fromToken - fromAmount - fromChainId - toChainId - toToken type: object properties: fromChainId: format: number description: The id of the chain where the transfer should start type: number fromAmount: description: The amount that should be transferred including all decimals type: string fromToken: $ref: '#/components/schemas/Token' description: The sending token toChainId: format: number description: The id of the chain where the transfer should end type: number toToken: $ref: '#/components/schemas/Token' description: The token that should be transferred to slippage: format: double description: The maximum allowed slippage type: number fromAddress: description: The sending wallet address type: string toAddress: description: The receiving wallet address type: string example: fromChainId: 100 fromAmount: '1000000000000000000' fromToken: address: '0x63e62989d9eb2d37dfdb1f93a22f063635b07d51' symbol: MIVA decimals: 18 chainId: 100 name: Minerva Wallet SuperToken coinKey: MIVA priceUSD: '0.0455272371751059' logoURI: '' toChainId: 137 toToken: address: '0xc0b2983a17573660053beeed6fdb1053107cf387' symbol: MIVA decimals: 18 chainId: 137 name: Minerva Wallet SuperToken coinKey: MIVA priceUSD: '0' logoURI: '' slippage: 0.003 Estimate: title: Root Type for Estimate description: An estimate for the current transfer required: - fromAmount - approvalAddress - toAmount - toAmountMin - tool - executionDuration type: object properties: tool: description: The tools that is being used for this step type: string fromAmount: description: The amount that should be transferred including all decimals type: string fromAmountUSD: description: The amount that should be transferred in USD equivalent type: string toAmount: description: >- The estimated resulting amount of the `toToken` including all decimals type: string toAmountMin: description: >- The minimal outcome of the transfer including all decimals. It may reflect applicable slippage and known fee-on-transfer tax adjustments. type: string toAmountUSD: description: The estimated resulting amount of the `toToken` in USD equivalent type: string approvalAddress: description: The contract address for the approval type: string skipApproval: description: >- Optional flag indicating that this step needs no token approval, because the executing contract moves funds under the authorization already carried by the signed transaction or message. type: boolean feeCosts: description: >- Fees charged on the transfer. On a `lifi` step this array is the concatenation of the fee costs of every entry in `includedSteps`, so it already contains them. Do not add both together. type: array items: $ref: '#/components/schemas/FeeCost' gasCosts: description: >- Estimated network gas for the transfer. On a `lifi` step this is a single estimate for the transaction that is actually submitted. It aggregates raw gas costs from source-chain entries in `includedSteps` and, for EVM transactions, adds estimated LI.FI contract overhead. It may differ from and often exceed the sum of the source-chain per-step entries. Raw destination-chain gas costs are not added directly. Do not add the top-level and included-step arrays together. type: array items: $ref: '#/components/schemas/GasCost' executionDuration: description: The time needed to complete the following step type: number data: description: Arbitrary data that depends on the the used tool type: object properties: bid: type: object properties: user: type: string router: type: string initiator: type: string sendingChainId: format: number type: number sendingAssetId: type: string amount: type: string receivingChainId: format: number type: number receivingAssetId: type: string amountReceived: type: string receivingAddress: type: string transactionId: type: string expiry: format: number type: number callDataHash: type: string callTo: type: string encryptedCallData: type: string sendingChainTxManagerAddress: type: string receivingChainTxManagerAddress: type: string bidExpiry: format: number type: number bidSignature: type: string gasFeeInReceivingToken: type: string totalFee: type: string metaTxRelayerFee: type: string routerFee: type: string example: tool: relaydepository fromAmount: '50000000' fromAmountUSD: '49.9789' toAmount: '76673' toAmountMin: '76290' toAmountUSD: '50.0577' executionDuration: 2 approvalAddress: '0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE' feeCosts: - name: LIFI Fixed Fee description: Fixed LIFI fee, independent of any other fee percentage: '0.0025' token: address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' symbol: USDC decimals: 6 chainId: 1 name: USD Coin coinKey: USDC priceUSD: '0.999578177' logoURI: >- https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png amount: '125000' amountUSD: '0.1249' included: true - name: Relayer Gas fee description: Relay bridge gas fee percentage: '0.0000' token: address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' symbol: USDC decimals: 6 chainId: 1 name: USD Coin coinKey: USDC priceUSD: '0.999578177' logoURI: >- https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png amount: '1116' amountUSD: '0.0011' included: true - name: Relayer Service fee description: Relay bridge service fee percentage: '0.0011' token: address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' symbol: USDC decimals: 6 chainId: 1 name: USD Coin coinKey: USDC priceUSD: '0.999578177' logoURI: >- https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png amount: '53822' amountUSD: '0.0538' included: true gasCosts: - type: SEND price: '128468782' estimate: '459000' limit: '596700' amount: '58967170938000' amountUSD: '0.1156' token: address: '0x0000000000000000000000000000000000000000' symbol: ETH decimals: 18 chainId: 1 name: ETH coinKey: ETH priceUSD: '1959.83' logoURI: >- https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png FeeCost: title: Root Type for FeeCost description: >- A protocol, integrator, or execution fee charged on the transfer. Fee costs cover everything that is charged as a fee rather than paid as network gas by the sender, including destination execution costs that a bridge or solver bills as a fee. See [Gas costs and fee costs](https://docs.li.fi/guides/gas-and-fee-costs) for how to read and display these values. required: - token - percentage - name - amountUSD - included type: object properties: name: description: >- Human-readable name of the fee, for example `LIFI Fixed Fee` or `Relayer Gas fee`. Names are tool-specific free text and are not a stable enum. Do not branch on this value. type: string description: description: Description of the fee costs type: string percentage: description: >- The fee expressed as a fraction of the transferred amount, for example `0.0025` for 0.25%. A fee whose name contains `Fixed` may still report a non-zero fraction; do not infer the fee model from `name` or assume fixed-fee entries report `0`. type: string token: $ref: '#/components/schemas/Token' description: >- The `Token` the fee is denominated in. `token.chainId` identifies the chain of that token, not necessarily the chain where the underlying work happens. A destination execution fee is commonly denominated in the source-chain token the user is already sending. amount: description: >- The fee amount in the smallest unit of `token`, before decimals are applied. Divide by `10 ** token.decimals` for a human-readable amount. type: string amountUSD: description: The amount of fees in USD type: string included: description: >- `true` means the fee is already accounted for in the quoted amounts and must not be added again as a separate user payment. `false` means the user pays it on top of `fromAmount`. type: boolean feeSplit: description: >- Response-only breakdown of this fee entry's `amount` into the parties that share it. Returned for the LI.FI/integrator fee entry and for a separate `Distributions` entry when distributions are present; omitted for fees such as a relayer or bridge gas fee. For the LI.FI/integrator entry, `lifiFee`, `integratorFee`, and `intermediaryFee` (when present) are disjoint slices of its `amount`. For the `Distributions` entry, `lifiFee` and `integratorFee` are both "0"; its `amount` is the sum of its distribution recipients. `recipients[]` describes only the parent fee entry. It is a breakdown of that entry's `amount`, not an additional charge. This field is returned, not accepted: the API ignores a `feeSplit` posted in a request body, so integrations must read the split from the response instead of echoing back a previously quoted one. type: object properties: lifiFee: description: LI.FI's slice of `amount`, in the smallest unit of `token`. type: string integratorFee: description: >- The integrator's slice of `amount`, in the smallest unit of `token`. It excludes intermediary fees (reported separately as `intermediaryFee`) and distributions (reported in a separate `Distributions` fee entry). It is "0" on the `Distributions` entry. type: string intermediaryFee: description: >- The intermediary's slice of `amount`, in the smallest unit of `token`. Present only when an intermediary participates in the split. type: string recipients: description: >- Per-recipient breakdown of this fee entry's `amount`. The LI.FI/integrator entry lists its own recipients, excluding partner-specified distributions. Those are listed in the separate `Distributions` entry's own `feeSplit.recipients[]`, with type `DISTRIBUTION` and one record per distribution. type: array items: title: Root Type for FeeRecipient description: One party receiving a share of this fee entry. type: object required: - name - fee properties: name: description: >- Recipient identifier, to be read together with `type`: `lifi` for the LI.FI platform recipient, the integrator id for the integrator's own fee, the intermediary id for an `INTERMEDIARY` entry, or the recipient wallet address for a `DISTRIBUTION` entry. Do not render it directly in a user-facing UI without type-aware formatting. type: string fee: description: >- The amount credited to this recipient, in the smallest unit of this fee entry's `token`. type: string type: description: >- How this recipient's fee was calculated. Currently one of `FIXED`, `SHARED`, `DYNAMIC`, `INTERMEDIARY`, or `DISTRIBUTION`, and deliberately not modelled as an enum because the set can grow without a breaking change. May be absent when the calculation type cannot be determined statically, so null-check before reading and keep a default branch when matching on it. `FIXED` and `SHARED` are the standard fee models. `DYNAMIC` means LI.FI resolved its rate for this quote under approved Dynamic Pricing, so the same integration can report a different rate on another quote. `INTERMEDIARY` marks a third-party recipient carving a configured share, and `DISTRIBUTION` marks a partner-specified recipient within the separate `Distributions` fee entry's own `feeSplit.recipients[]`. To detect Dynamic Pricing on a quote, look for a recipient whose `type` is `DYNAMIC`. type: string walletAddress: description: The recipient's wallet address on the source chain. type: string example: name: Relayer Gas fee description: Relay bridge gas fee percentage: '0.0000' token: address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' symbol: USDC decimals: 6 chainId: 1 name: USD Coin coinKey: USDC priceUSD: '0.999578177' logoURI: >- https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png amount: '1116' amountUSD: '0.0011' included: true GasCost: title: Root Type for GasCost description: >- An estimate of the network gas the sender pays for a transaction. Gas costs are always denominated in the native gas token of the chain the transaction is sent on. See [Gas costs and fee costs](https://docs.li.fi/guides/gas-and-fee-costs) for how gas costs relate to `feeCosts` and to destination-chain execution. required: - token - type - amount type: object properties: type: description: >- The kind of gas cost this entry represents. - `SEND`: estimated network gas for the transaction the sender submits, normally on the source chain. This is the only value the API currently returns. - `APPROVE`: estimated network gas for a separate ERC-20 approval transaction. Reserved; approval gas is not currently returned as its own entry. - `FEE`: an execution cost charged as a fee rather than as a transaction the user signs. Reserved; such costs are currently reported in `feeCosts` instead. - `SUM`: an aggregate of the other entries. Reserved and not currently returned. Treat `APPROVE`, `FEE`, and `SUM` as forward-compatible values: handle them if they appear, but do not build a flow that depends on them. type: string enum: - SUM - APPROVE - SEND - FEE example: SEND price: description: >- Gas price used for the estimate, in the smallest unit of the gas token per unit of gas (wei per gas on EVM chains). type: string estimate: description: Estimated units of gas the transaction consumes type: string limit: description: >- Suggested gas limit: `estimate` plus a safety buffer. Use this value when submitting the transaction, not `estimate`. type: string amount: description: >- The estimated total gas cost in the smallest unit of the gas token. For EVM entries this is `estimate` multiplied by `price`. Other ecosystems may use chain-specific units and rounding, so consumers should treat `amount` as authoritative rather than reconstructing it from the other fields. Divide by `10 ** token.decimals` for a human-readable amount. type: string amountUSD: description: Amount of the gas cost in USD type: string token: $ref: '#/components/schemas/Token' description: >- The native gas token of the chain the transaction is sent on. `token.chainId` is the chain that consumes the gas. example: type: SEND price: '128468782' estimate: '459000' limit: '596700' amount: '58967170938000' amountUSD: '0.1156' token: address: '0x0000000000000000000000000000000000000000' symbol: ETH decimals: 18 chainId: 1 name: ETH coinKey: ETH priceUSD: '1959.83' logoURI: >- https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.