Read an FX trade

get/v1/fx/trades/{tradeId}

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; terminal states return only status.

tradeIdstring 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).

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",
  "status": "AWAITING_DEPOSIT",
  "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

No recorded changes to this endpoint across all 2 revisions of this API.