Get trade

One trade through the same projection as the list: the workspace’s or the caller’s own taker order or venue trade, a broker umbrella record with the client category’s field visibility, or an LP’s fill with pseudonymised counterparties. Taker orders keep their detail fields at the top level. Accepts a member session or an API key with trades_read.

GET /api/v1/workspaces/{workspaceId}/trades/{tradeId}

Get a trade

cURL

curl --request GET \
  --url https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/trades/{tradeId} \
  --header 'Authorization: Bearer <token>'

200

{
  "lp": {
    "lpName": "<string>",
    "lpSource": "<string>",
    "routingPathLabel": "<string>",
    "solverId": "<string>",
    "bilateralStatus": "<string>",
    "settlementSlaStatus": "<string>",
    "settlementSpeedMs": 1
  },
  "settlement": {
    "status": "pending",
    "method": "venueLedger",
    "timing": "immediate",
    "cexLane": {
      "deposits": [
        {
          "accountAssetKey": "<string>",
          "amount": "<string>",
          "applicationTransaction": {
            "actor": "user",
            "chainId": 1,
            "chainRole": "origin",
            "hash": "<string>",
            "stage": "prepare",
            "status": "pending",
            "explorerUrl": "<string>",
            "label": "<string>",
            "legIndex": 1,
            "timestamp": "2023-11-07T05:31:56Z"
          },
          "depositKey": "<string>",
          "ledger": "<string>",
          "confirmation": {
            "forwardTransaction": {
              "actor": "user",
              "chainId": 1,
              "chainRole": "origin",
              "hash": "<string>",
              "stage": "prepare",
              "status": "pending",
              "explorerUrl": "<string>",
              "label": "<string>",
              "legIndex": 1,
              "timestamp": "2023-11-07T05:31:56Z"
            },
            "transaction": {
              "actor": "user",
              "chainId": 1,
              "chainRole": "origin",
              "hash": "<string>",
              "stage": "prepare",
              "status": "pending",
              "explorerUrl": "<string>",
              "label": "<string>",
              "legIndex": 1,
              "timestamp": "2023-11-07T05:31:56Z"
            },
            "venueDepositId": "<string>",
            "venueTxHash": "<string>"
          }
        }
      ],
      "tradeFills": [
        {
          "actualInputAmount": "<string>",
          "actualOutputAmount": "<string>",
          "evidenceHash": "<string>",
          "ledger": "<string>",
          "tradeId": "<string>",
          "transaction": {
            "actor": "user",
            "chainId": 1,
            "chainRole": "origin",
            "hash": "<string>",
            "stage": "prepare",
            "status": "pending",
            "explorerUrl": "<string>",
            "label": "<string>",
            "legIndex": 1,
            "timestamp": "2023-11-07T05:31:56Z"
          },
          "venueFillId": "<string>"
        }
      ]
    },
    "failureReason": "<string>",
    "fillTx": {
      "chain": "<string>",
      "explorerUrl": "<string>",
      "hash": "<string>"
    },
    "finaliseTx": {
      "chain": "<string>",
      "explorerUrl": "<string>",
      "hash": "<string>"
    },
    "oracle": {
      "name": "<string>",
      "messageId": "<string>",
      "status": "dispatched"
    },
    "proofTx": {
      "chain": "<string>",
      "explorerUrl": "<string>",
      "hash": "<string>"
    },
    "recipientWallet": "<string>",
    "settlementSpeedMs": 1,
    "settlementStage": "<string>",
    "submitTx": {
      "chain": "<string>",
      "explorerUrl": "<string>",
      "hash": "<string>"
    },
    "transactions": [
      {
        "actor": "user",
        "chainId": 1,
        "chainRole": "origin",
        "hash": "<string>",
        "stage": "prepare",
        "status": "pending",
        "explorerUrl": "<string>",
        "label": "<string>",
        "legIndex": 1,
        "timestamp": "2023-11-07T05:31:56Z"
      }
    ],
    "userDepositWallet": "<string>",
    "window": {
      "cadence": {
        "dayBasis": "calendarDays",
        "kind": "intraday",
        "everyHours": 1,
        "localTimes": [
          "<string>"
        ]
      },
      "scheduleId": "<string>",
      "scheduleLabel": "<string>",
      "scheduleVersion": 123,
      "snapshotAt": "2023-11-07T05:31:56Z",
      "windowId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "assumedBoundary": {
        "lpName": "<string>",
        "source": "<string>",
        "timeZone": "<string>"
      },
      "cutoffAt": "2023-11-07T05:31:56Z",
      "paymentDeadlineAt": "2023-11-07T05:31:56Z",
      "settlementBasis": "clock",
      "settlesBy": "2023-11-07T05:31:56Z",
      "statementIssuer": "<string>"
    }
  },
  "trade": {
    "createdAt": "2023-11-07T05:31:56Z",
    "executionPrice": {
      "source": "storedQuotePrice",
      "baseSymbol": "<string>",
      "quoteSymbol": "<string>",
      "value": "<string>"
    },
    "lifecycleStatus": {
      "bucket": "inProgress",
      "flowKind": "instant",
      "isTerminal": true,
      "primary": {
        "key": "created",
        "label": "<string>",
        "tone": "<string>"
      },
      "rank": 1,
      "rawStatus": "created",
      "execution": {
        "key": "created",
        "label": "<string>",
        "tone": "<string>"
      },
      "rawDeferredStatus": "<string>",
      "settlement": {
        "key": "created",
        "label": "<string>",
        "tone": "<string>"
      },
      "withdrawal": {
        "key": "created",
        "label": "<string>",
        "tone": "<string>"
      }
    },
    "orderId": "<string>",
    "route": {
      "buy": {
        "asset": {
          "assetId": "<string>",
          "resolutionStatus": "resolved",
          "symbol": "<string>",
          "address": "<string>",
          "chainId": 1,
          "chainRef": "<string>",
          "decimals": 1,
          "name": "<string>"
        },
        "decimalAmount": "<string>",
        "rawAmount": "<string>",
        "unresolved": "assetNotInRegistry"
      },
      "sell": {
        "asset": {
          "assetId": "<string>",
          "resolutionStatus": "resolved",
          "symbol": "<string>",
          "address": "<string>",
          "chainId": 1,
          "chainRef": "<string>",
          "decimals": 1,
          "name": "<string>"
        },
        "decimalAmount": "<string>",
        "rawAmount": "<string>",
        "unresolved": "assetNotInRegistry"
      }
    },
    "routingPathLabel": "<string>",
    "status": "created",
    "amountUsd": "<string>",
    "apiKey": {
      "keyId": "<string>",
      "name": "<string>"
    },
    "channel": "ui",
    "deferredSettlement": {
      "autoWithdraw": true,
      "stage": "<string>",
      "estimatedSettlementAvailableAt": "2023-11-07T05:31:56Z",
      "executedAt": "2023-11-07T05:31:56Z",
      "settlementWindowHours": 1,
      "withdrawalStatus": "<string>",
      "withdrawalTrackingId": "<string>",
      "withdrawalTxHash": "<string>"
    },
    "deliveredBuy": {
      "asset": {
        "assetId": "<string>",
        "resolutionStatus": "resolved",
        "symbol": "<string>",
        "address": "<string>",
        "chainId": 1,
        "chainRef": "<string>",
        "decimals": 1,
        "name": "<string>"
      },
      "decimalAmount": "<string>",
      "rawAmount": "<string>",
      "unresolved": "assetNotInRegistry"
    },
    "deliveredBuyProvenance": "measured",
    "fillTimeMs": 1,
    "routingPath": {
      "type": "direct"
    },
    "slippageBps": 123,
    "slippageToleranceBps": 1
  },
  "buy": {
    "asset": "<string>",
    "amount": "<string>"
  },
  "connectionId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "executionStatus": "notSubmitted",
  "executionTypeId": "<string>",
  "lifecycleStatus": {
    "bucket": "inProgress",
    "flowKind": "instant",
    "isTerminal": true,
    "primary": {
      "key": "created",
      "label": "<string>",
      "tone": "<string>"
    },
    "rank": 1,
    "rawStatus": "created",
    "execution": {
      "key": "created",
      "label": "<string>",
      "tone": "<string>"
    },
    "rawDeferredStatus": "<string>",
    "settlement": {
      "key": "created",
      "label": "<string>",
      "tone": "<string>"
    },
    "withdrawal": {
      "key": "created",
      "label": "<string>",
      "tone": "<string>"
    }
  },
  "operationId": "<string>",
  "providerSite": "<string>",
  "sell": {
    "asset": "<string>",
    "amount": "<string>"
  },
  "submittedByYou": true,
  "venueAccountName": "<string>",
  "venueName": "<string>",
  "kind": "order",
  "projection": "mine",
  "tradeId": "<string>",
  "fees": {
    "totals": {
      "totalCostUsd": "<string>",
      "lpSpreadUsd": "<string>",
      "protocolFeeUsd": "<string>",
      "solverGasUsd": "<string>",
      "userGasUsd": "<string>"
    },
    "rows": [
      {
        "chain": "<string>",
        "feeKind": "<string>",
        "feePayer": "<string>",
        "recordedAt": "2023-11-07T05:31:56Z",
        "sequenceNumber": 123,
        "txType": "<string>",
        "feeUsd": "<string>",
        "feeWei": "<string>",
        "gasPriceWei": "<string>",
        "gasUsed": "<string>",
        "txHash": "<string>"
      }
    ]
  },
  "legs": [
    {
      "buy": {
        "asset": {
          "assetId": "<string>",
          "resolutionStatus": "resolved",
          "symbol": "<string>",
          "address": "<string>",
          "chainId": 1,
          "chainRef": "<string>",
          "decimals": 1,
          "name": "<string>"
        },
        "decimalAmount": "<string>",
        "rawAmount": "<string>",
        "unresolved": "assetNotInRegistry"
      },
      "index": 1,
      "kind": "cctp",
      "label": "<string>",
      "sell": {
        "asset": {
          "assetId": "<string>",
          "resolutionStatus": "resolved",
          "symbol": "<string>",
          "address": "<string>",
          "chainId": 1,
          "chainRef": "<string>",
          "decimals": 1,
          "name": "<string>"
        },
        "decimalAmount": "<string>",
        "rawAmount": "<string>",
        "unresolved": "assetNotInRegistry"
      },
      "status": "pending",
      "counterparty": {
        "counterpartyType": "vasp",
        "jurisdiction": "<string>",
        "kybStatus": "not_started",
        "licences": [
          {
            "jurisdiction": "<string>",
            "licenceType": "<string>",
            "status": "active",
            "expiresAt": "2023-11-07T05:31:56Z"
          }
        ],
        "provenance": "kybVerified"
      },
      "destChainId": 1,
      "etaSeconds": 1,
      "externalRefs": [
        {
          "kind": "circleTradeId",
          "value": "<string>",
          "url": "<string>"
        }
      ],
      "feeUsd": "<string>",
      "measuredBuy": {
        "asset": {
          "assetId": "<string>",
          "resolutionStatus": "resolved",
          "symbol": "<string>",
          "address": "<string>",
          "chainId": 1,
          "chainRef": "<string>",
          "decimals": 1,
          "name": "<string>"
        },
        "decimalAmount": "<string>",
        "rawAmount": "<string>",
        "unresolved": "assetNotInRegistry"
      },
      "measuredBuySource": "circleSettledOutput",
      "product": "lop",
      "provider": "<string>",
      "sourceChainId": 1,
      "tradeLeg": {
        "direction": "pay_in",
        "legId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "settlementRail": "bank",
        "state": "planned",
        "boundLapsesAt": "2023-11-07T05:31:56Z",
        "confirmAgainReason": "priceBeyondBound",
        "consentedPayoutFee": "<string>",
        "creditedAmount": "<string>",
        "currentPayoutFee": "<string>",
        "declaredPayoutFee": "<string>",
        "destination": {
          "kind": "wallet",
          "ref": "<string>",
          "approvalId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        },
        "expectedArrivalAt": "2023-11-07T05:31:56Z",
        "expectedArrivalSource": "provider",
        "finality": "final",
        "fundingDeadlineAt": "2023-11-07T05:31:56Z",
        "fundingModel": "prefunded",
        "fundsReceivedAt": "2023-11-07T05:31:56Z",
        "holidaysApplied": true,
        "outcomeCode": "trade_unfilled",
        "overdueAt": "2023-11-07T05:31:56Z",
        "overdueSince": "2023-11-07T05:31:56Z",
        "ownBankVerification": {
          "source": "revolutBusiness",
          "state": "verified",
          "credit": {
            "amount": "<string>",
            "creditedAt": "2023-11-07T05:31:56Z",
            "currency": "<string>",
            "referenceMasked": "<string>"
          },
          "lastGoodReadAt": "2023-11-07T05:31:56Z",
          "matchedBy": "referenceAndAmount",
          "reason": "<string>",
          "reviewItemId": "<string>"
        },
        "payoutApproval": {
          "approvalsRequired": 1,
          "approverNames": [
            "<string>"
          ],
          "approvalRequestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "approverGroup": "<string>",
          "approverGroupName": "<string>",
          "runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        },
        "payoutBreakdown": {
          "basis": "consent",
          "fee": "<string>",
          "receivedMax": "<string>",
          "receivedMin": "<string>",
          "withdrawn": "<string>",
          "charging": "deducted"
        },
        "payoutBreakdownUnavailableReason": "<string>",
        "payoutHeldReason": "<string>",
        "quotedExpectedArrivalAt": "2023-11-07T05:31:56Z",
        "rail": "<string>",
        "railOption": "standard",
        "railReference": {
          "state": "notReportedYet"
        },
        "recipientConfirmation": {
          "confirmationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "confirmedAt": "2023-11-07T05:31:56Z",
          "confirmedBy": "<string>",
          "confirmedByName": "<string>",
          "legId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        },
        "returnWindowEndsAt": "2023-11-07T05:31:56Z",
        "returnedAfterSettlement": {
          "detectedAt": "2023-11-07T05:31:56Z",
          "reviewItemId": "<string>"
        },
        "returnedTo": "lpAccount",
        "reviewAt": "2023-11-07T05:31:56Z",
        "reviewEnteredAt": "2023-11-07T05:31:56Z",
        "reviewItemId": "<string>",
        "reviewReason": "uncertain_send",
        "submittedAt": "2023-11-07T05:31:56Z",
        "transactionHash": "<string>",
        "venueReportedCredited": true,
        "venueWithdrawalId": "<string>"
      },
      "transactions": [
        {
          "actor": "user",
          "chainId": 1,
          "chainRole": "origin",
          "hash": "<string>",
          "stage": "prepare",
          "status": "pending",
          "explorerUrl": "<string>",
          "label": "<string>",
          "legIndex": 1,
          "timestamp": "2023-11-07T05:31:56Z"
        }
      ],
      "venueRouteId": "<string>"
    }
  ],
  "orderKind": "<string>",
  "substatus": "<string>",
  "substatusMessage": "<string>",
  "amountUsd": "<string>",
  "amountUsdBasis": "executed",
  "apiKey": {
    "keyId": "<string>",
    "name": "<string>"
  },
  "debitExpirySignature": "recorded",
  "executionPrice": "<string>",
  "executionPriceUnit": {
    "baseAsset": "<string>",
    "quoteAsset": "<string>"
  },
  "feesPaid": "<string>",
  "financials": {
    "fee": {
      "treatment": "included_in_price",
      "amount": "<string>",
      "asset": "<string>",
      "basis": "<string>",
      "lines": [
        {
          "amount": "<string>",
          "asset": "<string>"
        }
      ],
      "tradeFeeReport": "not_reported"
    },
    "legs": [
      {
        "direction": "pay_in",
        "legId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "settlementRail": "bank",
        "state": "planned",
        "boundLapsesAt": "2023-11-07T05:31:56Z",
        "confirmAgainReason": "priceBeyondBound",
        "consentedPayoutFee": "<string>",
        "creditedAmount": "<string>",
        "currentPayoutFee": "<string>",
        "declaredPayoutFee": "<string>",
        "destination": {
          "kind": "wallet",
          "ref": "<string>",
          "approvalId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        },
        "expectedArrivalAt": "2023-11-07T05:31:56Z",
        "expectedArrivalSource": "provider",
        "finality": "final",
        "fundingDeadlineAt": "2023-11-07T05:31:56Z",
        "fundingModel": "prefunded",
        "fundsReceivedAt": "2023-11-07T05:31:56Z",
        "holidaysApplied": true,
        "outcomeCode": "trade_unfilled",
        "overdueAt": "2023-11-07T05:31:56Z",
        "overdueSince": "2023-11-07T05:31:56Z",
        "ownBankVerification": {
          "source": "revolutBusiness",
          "state": "verified",
          "credit": {
            "amount": "<string>",
            "creditedAt": "2023-11-07T05:31:56Z",
            "currency": "<string>",
            "referenceMasked": "<string>"
          },
          "lastGoodReadAt": "2023-11-07T05:31:56Z",
          "matchedBy": "referenceAndAmount",
          "reason": "<string>",
          "reviewItemId": "<string>"
        },
        "payoutApproval": {
          "approvalsRequired": 1,
          "approverNames": [
            "<string>"
          ],
          "approvalRequestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "approverGroup": "<string>",
          "approverGroupName": "<string>",
          "runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        },
        "payoutBreakdown": {
          "basis": "consent",
          "fee": "<string>",
          "receivedMax": "<string>",
          "receivedMin": "<string>",
          "withdrawn": "<string>",
          "charging": "deducted"
        },
        "payoutBreakdownUnavailableReason": "<string>",
        "payoutHeldReason": "<string>",
        "quotedExpectedArrivalAt": "2023-11-07T05:31:56Z",
        "rail": "<string>",
        "railOption": "standard",
        "railReference": {
          "state": "notReportedYet"
        },
        "recipientConfirmation": {
          "confirmationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "confirmedAt": "2023-11-07T05:31:56Z",
          "confirmedBy": "<string>",
          "confirmedByName": "<string>",
          "legId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        },
        "returnWindowEndsAt": "2023-11-07T05:31:56Z",
        "returnedAfterSettlement": {
          "detectedAt": "2023-11-07T05:31:56Z",
          "reviewItemId": "<string>"
        },
        "returnedTo": "lpAccount",
        "reviewAt": "2023-11-07T05:31:56Z",
        "reviewEnteredAt": "2023-11-07T05:31:56Z",
        "reviewItemId": "<string>",
        "reviewReason": "uncertain_send",
        "submittedAt": "2023-11-07T05:31:56Z",
        "transactionHash": "<string>",
        "venueReportedCredited": true,
        "venueWithdrawalId": "<string>"
      }
    ],
    "quotedOutput": "<string>"
  },
  "inputSpent": "<string>",
  "notSentCause": "<string>",
  "notSentReason": "QUOTE_RECONFIRMATION_REQUIRED",
  "outcomeCode": "confirmed_fill",
  "outputReceived": "<string>",
  "pair": "<string>",
  "placedBy": {
    "kind": "member",
    "name": "<string>",
    "userId": "<string>"
  },
  "settlementCarriedInto": {
    "windowId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "settlesBy": "2023-11-07T05:31:56Z"
  },
  "settlementState": "settled",
  "settlementStatement": "pending",
  "statedExecutionPrice": {
    "baseAsset": "<string>",
    "quoteAsset": "<string>",
    "basis": "market_convention",
    "value": "<string>"
  },
  "tetrafiFee": "<string>",
  "tetrafiFeeAsset": "<string>",
  "transferMode": "fast",
  "uncertainCode": "<string>"
}

Authorizations

bearer_authapi_key

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Scopes

trades_read · bearer_auth

trades_read · api_key

Headers

X-Workspace-Id · string<uuid>

The workspace the request acts in. An API key bound to a workspace implies it: omit the header, or send that same id (another id answers 403 WORKSPACE_SCOPE_MISMATCH). A member session must send it (400 MISSING_WORKSPACE without it).

Path Parameters

workspaceId · string · required

Workspace ID

tradeId · string · required

The trade's tradeId: an order id, or a venue trade's operation id

Query Parameters

scope · enum<string>

mine, workspace (default) or umbrella, as on the list Whose rows the list reads.

Available options: mine, workspace, umbrella

perspective · enum<string>

taker (default) or maker, as on the list Which side of the trade the workspace was on.

Available options: taker, maker

venueId · string

Maker: the LP's own venue that filled it

flow · string

Maker: protocol, venueAccount or all

Response

200

application/json

The trade, with tradeId, kind and projection

Option 1

Option 2

Option 3

Option 4

One trade, read through the same projection as the list.

lp · object · required

Section D: LP / counterparty information, including its compliance posture.

For a KYB'd liquidity provider the compliance fields carry the LP's jurisdiction, KYB status, and regulatory licences — the "who is the other side and are they authorised" a compliance officer needs. Router/bridge routes settle through a protocol (CCTP, Relay, …), not a VASP counterparty: those report counterparty_type = "protocol" with no jurisdiction/licences, which is itself the compliance-relevant fact (no VASP-to-VASP Travel Rule message is owed).

Show child attributes

settlement · object · required

How and when the trade settles, as recorded before it was sent: the same block the order read returns as settlement (method, timing and, for a delayed trade, its window with settlesBy and paymentDeadlineAt). Absent on a trade recorded without it.

Option 1

Option 2

Option 3

Show child attributes

trade · object · required

Section A: Trade details.

Show child attributes

buy · object · required

What the trade buys: its asset and, when recorded, the least it must receive from its consented bounds.

Show child attributes

connectionId · string · required

createdAt · string<date-time> · required

executionStatus · enum<string> · required

A venue trade's execution status, in camelCase like the order status (outcomeUnknown).

New values may be added; treat unknown values as other.

Available options: notSubmitted, dispatching, outcomeUnknown, filled, unfilled, needsReview

executionTypeId · string · required

The execution type (compiled spec id), not the catalogue Venue.

lifecycleStatus · object · required

The same lifecycle shape an order row carries; needsReview is not final.

Show child attributes

operationId · string · required

providerSite · string · required

sell · object · required

What the trade sells: its asset and, when recorded, the most it may spend from its consented bounds.

Show child attributes

submittedByYou · boolean · required

venueAccountName · string · required

The workspace's venue account it went through, titled by its catalogue Venue ("Keyrock account"), never by the execution type ("Keyrock OTC"); an on-chain venue is never an account and reads as itself ("Circle StableFX").

venueName · string · required

The venue's name, for display.

kind · enum<string> · required

The kinds the one trade history lists.

New values may be added; treat unknown values as other.

Available options: order, venueTrade

projection · enum<string> · required

Which view of trades answers the request: the caller's own, the workspace's, a broker's umbrella, an LP's fills, or an LP's unsettled orders.

New values may be added; treat unknown values as other.

Available options: mine, workspace, umbrella, maker, settlement

tradeId · string · required

fees · object

Fee breakdown: gas, protocol fee, solver fee, relayer tips. Absent when the order predates fee capture.

Show child attributes

legs · object[] | null

Uniform per-leg execution model for multi-leg route orders; absent for single-leg escrow / deferred orders. Mirrors OrderResponse.legs.

Show child attributes

orderKind · string | null

Canonical, route-aware order kind (cctp-v0 / composite-v0 / fx-v0 / escrow-v0 / …). Mirrors OrderResponse.orderKind.

substatus · string | null

Finer-grained state within the coarse status (route routeStatus, etc.).

substatusMessage · string | null

Human-readable elaboration of substatus — a Circle StableFX status line, or the reason a parked/refunded/recovered order is in that state. Mirrors OrderResponse.substatusMessage.

amountUsd · string | null

A reference USD value of what the trade sells, by the same price service that values an order row's amountUsd, at the price when read. amountUsdBasis says which amount it values. Absent when the asset has no reference price or the price read failed; never 0 for an unknown value.

amountUsdBasis · null | enum<string>

executed (what the venue debited, on a fill) or requested (the most the trade could spend, otherwise). Present exactly when amountUsd is.

Available options: executed, requested

apiKey · null | object

Show child attributes

debitExpirySignature · null | enum<string>

For an expired debit proof, whether wallet records contain a typed signature: recorded or unconfirmed. Absent when the retained steps cannot establish either.

Available options: recorded, unconfirmed

executionPrice · string | null

Legacy confirmed output per input (buy asset / sell asset), computed with Decimal; null when unread. executionPriceUnit states its unit; prefer statedExecutionPrice for display.

executionPriceUnit · null | object

Unit of a price: quoteAsset / baseAsset means one base asset costs this many quote assets.

Show child attributes

feesPaid · string | null

What a confirmed same-asset fill (a bridge) cost the taker: spent minus received, the venue's protocol and forwarding fees, in the sell asset. Absent unless confirmed and positive.

financials · null | object

The trade's recorded money terms and payment legs, from the same records as the order read; history never re-derives a fee or minimum.

Show child attributes

inputSpent · string | null

What the venue debited and credited, once its outcome is recorded.

notSentCause · string | null

The stable code behind notSentReason, the same value the venue-trade detail's notSentCause carries (for example WALLET_NONCE_PENDING). A code this version does not know is still named. Absent when no cause was retained.

notSentReason · null | enum<string>

Why a not_sent outcome was not sent, as the dispatch's notSentReason.

Available options: QUOTE_RECONFIRMATION_REQUIRED, VENUE_ACCEPT_ADMISSION_REFUSED, VENUE_SESSION_ACQUIRE_TIMEOUT, VENUE_GRID_CHANGED, VENUE_GRID_UNREADABLE, VENUE_REFUSED_BEFORE_ACCEPTANCE, LP_TRADING_REFUSED_UNSENT, COMPLIANCE_AUDIT_UNRECORDED, ON_CHAIN_UNSENT, BOOK_SELL_LIMIT_UNREPRESENTABLE, VENUE_DISPATCH_AUTHORITY_UNAVAILABLE, BOOK_PLACEMENT_PRICE_UNRECORDED_UNSENT, VENUE_ORDER_ABSENT_PAST_HORIZON, VENUE_REQUEST_REFUSED_UNSENT, NOT_SENT_UNCLASSIFIED

outcomeCode · null | enum<string>

Why the trade ended as it did, as its dispatch records it (the order page's dispatch.outcomeCode): the history row names a no-fill's reason from it. Absent until an outcome is recorded.

Available options: confirmed_fill, fill_requires_review, rfq_closed_no_order, confirmed_no_fill, adjudicated_not_placed, bridge_not_sent_funds_at_source, bridge_refunded_to_source, debit_authority_expired, awaiting_provider_execution, not_sent, provider_outcome_unknown

outputReceived · string | null

pair · string | null

The recorded market pair; absent stays absent, never inferred from asset order.

placedBy · object

Who placed the trade: the API key by label, else the member where this reader may see their name. Absent otherwise.

Option 1

Option 2

Show child attributes

settlementCarriedInto · null | object

The later window the trade's amounts were netted into, as the order read's settlementCarriedInto. Absent when nothing was netted.

Show child attributes

settlementState · null | enum<string>

Where the filled trade's settlement stands; the same value as the order read's settlementState. Absent before the fill and without recorded terms.

Available options: settled, awaitingWindow, awaitingPayment, partiallySettled, overdue, disputed, failed, inTransit

settlementStatement · null | enum<string>

Whether the statement of the window the trade settles in is out, as the order read's settlementStatement. Absent with settlementState and without a window.

Available options: pending, issued, failed

statedExecutionPrice · null | object

QuoteCurrencyPriority market convention, with explicit base/quote and fallback basis.

Show child attributes

tetrafiFee · string | null

Gross TetraFi fee (list rate, before incentives) from the Basic billing ledger, in tetrafiFeeAsset; absent until accrued.

tetrafiFeeAsset · string | null

transferMode · null | enum<string>

CCTP's selected finality tier, as the order read's operation.onChain.transferMode: the bound selection, never re-derived. A CCTP trade without it is Standard (historical and omitted selections); absent on every other venue.

Available options: fast, standard

uncertainCode · string | null

The dispatch's first unknown-outcome failure: a closed code, never a provider body. A later terminal outcome takes precedence over this retained diagnostic.