INinfinite
FX

Read an FX trade

Changed on
get/v1/fx/trades/{tradeId}

Request

Path parameters

tradeIdstring required

Trade ID (tfr_…)

Headers

X-API-Keystring

API key

Response

Trade detail. Shape varies by status — PENDING_WALLET_APPROVAL omits depositInstructions and returns screeningDeadline; AWAITING_DEPOSIT returns depositInstructions and depositDeadline; other states return status. deliveredAmount and providerFee are included once payout settlement has been confirmed.

tradeIdstring required
referenceRatestring

Independent reference rate used to price this trade, expressed as destination major units per source major unit. Present for benchmark-priced trades.

referenceRateAsOfstring

Timestamp of the independent reference rate used to price this trade (ISO 8601).

referenceProvider'XE'

Independent market that published referenceRate. Present when referenceRate is present.

status'PENDING_WALLET_APPROVAL' | 'AWAITING_DEPOSIT' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'AUTO_CANCELLED' | 'REFUNDED' required

Lifecycle status. PENDING_WALLET_APPROVAL means accept succeeded but the source wallet is still being verified — depositInstructions is omitted until verification clears and the trade transitions to AWAITING_DEPOSIT (delivered via the fx_trade.deposit_instructions_ready webhook).

deliveredAmountstring

Destination amount actually delivered, in destination-currency minor units. Present once payout settlement has been confirmed. Omitted while the trade is still on the quoted amount.

depositDeadlinestring

Customer-facing deposit deadline (ISO 8601). Present when either depositInstructions or fundingInstructions is present.

screeningDeadlinestring

Deadline by which source-wallet verification must complete (ISO 8601). Present only when status=PENDING_WALLET_APPROVAL. If verification has not cleared by this point the trade transitions to FAILED.

Example response

{
  "tradeId": "tfr_abc123",
  "referenceRate": "1.158691536019208779",
  "referenceRateAsOf": "2026-09-02T18:30:04.000Z",
  "referenceProvider": "XE",
  "status": "AWAITING_DEPOSIT",
  "deliveredAmount": "9935",
  "providerFee": {
    "amount": "134",
    "currency": "USD"
  },
  "depositInstructions": {
    "address": "0xCustomerInfiniteTxWallet...",
    "network": "BASE",
    "amount": "10000000",
    "expiresAt": "2026-05-26T19:54:00.000Z"
  },
  "fundingInstructions": {
    "reference": "CDX-7K2A9V",
    "currency": "EUR",
    "amount": "10000",
    "supportedRails": [
      "SEPA"
    ],
    "bank": {
      "name": "Commerzbank AG",
      "address": "Mainzer Landstraße 153, 60327 Frankfurt",
      "country": "DE"
    },
    "accounts": [
      {
        "supportedRails": [
          "SEPA"
        ],
        "accountHolderName": "Acme Onramp Ltd",
        "accountNumber": "12345678",
        "iban": "DE89370400440532013000",
        "bic": "COBADEFFXXX",
        "sortCode": "12-34-56",
        "routingNumber": "021000021"
      }
    ],
    "swiftRoutingBanks": [
      {
        "bankName": "Citibank N.A.",
        "bic": "CITIUS33XXX",
        "abaRoutingNumber": "021000089"
      }
    ],
    "expiresAt": "2026-05-26T19:54:00.000Z"
  },
  "depositDeadline": "2026-05-26T19:54:00.000Z",
  "screeningDeadline": "2026-05-26T19:47:00.000Z"
}

Changes

  • d266ba0b079eRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • b83888a376d8Revision changes
    • info

      added the optional property to the response with the status