Trades

Lists trades executed under a workspace across every supported chain in one call. Filter by status, corridor, RFC 3339 time range, LP, routing path, or USD amount range; sort by a whitelisted column; page through results with limit and offset.

GET /workspaces/{id}/trades

Trades

cURL

curl --request GET \
  --url https://api.tetrafi.io/api/v1/workspaces/{id}/trades \
  --header 'X-API-Key: <api-key>'

200

{
  "items": [
    {
      "orderId": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "sourceChain": "<string>",
      "destChain": "<string>",
      "route": {
        "input": {
          "asset": {
            "assetId": "<string>",
            "symbol": "<string>",
            "resolutionStatus": "resolved",
            "name": "<string>",
            "decimals": 123,
            "chainId": 123,
            "chainRef": "<string>",
            "address": "<string>"
          },
          "rawAmount": "<string>",
          "decimalAmount": "<string>"
        },
        "output": {
          "asset": {
            "assetId": "<string>",
            "symbol": "<string>",
            "resolutionStatus": "resolved",
            "name": "<string>",
            "decimals": 123,
            "chainId": 123,
            "chainRef": "<string>",
            "address": "<string>"
          },
          "rawAmount": "<string>",
          "decimalAmount": "<string>"
        }
      },
      "amountUsd": 123,
      "lpName": "<string>",
      "lpSource": "<string>",
      "routingPathLabel": "<string>",
      "status": "<string>",
      "settlementStatus": "<string>",
      "lifecycleStatus": {
        "flowKind": "<string>",
        "primary": {
          "key": "<string>",
          "label": "<string>",
          "tone": "<string>"
        },
        "isTerminal": true,
        "rank": 123,
        "rawStatus": "<string>",
        "execution": {
          "key": "<string>",
          "label": "<string>",
          "tone": "<string>"
        },
        "settlement": {
          "key": "<string>",
          "label": "<string>",
          "tone": "<string>"
        },
        "withdrawal": {
          "key": "<string>",
          "label": "<string>",
          "tone": "<string>"
        },
        "rawDeferredStatus": "<string>"
      },
      "executionPrice": {
        "source": "stored_quote_price",
        "value": "<string>",
        "baseSymbol": "<string>",
        "quoteSymbol": "<string>"
      },
      "member": {
        "userId": "<string>",
        "firstName": "<string>",
        "lastName": "<string>",
        "email": "<string>",
        "role": "<string>",
        "kycStatus": "<string>",
        "joinedAt": "2023-11-07T05:31:56Z"
      },
      "routingPath": {
        "type": "direct",
        "brokerWorkspaceId": "<string>",
        "brokerName": "<string>"
      },
      "orderKind": "<string>",
      "deferredSettlement": {
        "stage": "<string>",
        "autoWithdraw": true,
        "executedAt": "2023-11-07T05:31:56Z",
        "estimatedSettlementAvailableAt": "2023-11-07T05:31:56Z",
        "settlementWindowHours": 123,
        "withdrawalStatus": "<string>",
        "withdrawalTrackingId": "<string>",
        "withdrawalTxHash": "<string>"
      },
      "settlementSpeedMs": 123,
      "slippageBps": 123
    }
  ],
  "total": 123,
  "offset": 123,
  "limit": 123
}

Authorizations

apiKeyAuthbearerAuth

X-API-Key · string · header · required

Workspace API key (tfk_test_/tfk_live_); results are scoped to the key's workspace.

Path Parameters

id · string · required

Workspace whose trades are returned - results are scoped to it

Query Parameters

status · string

Filter by settlement status bucket; pass all (or omit) for every status

corridor · string

Directional corridor as source-dest - matches the trade's source and destination chains

dateFrom · string<date-time>

Only trades created at or after this time (RFC 3339)

dateTo · string<date-time>

Only trades created at or before this time (RFC 3339)

member · string

Admin/Owner only - case-insensitive match on member name or email; ignored for other callers

lpName · string

Case-insensitive match on LP display name or solver id

routingPath · string

Filter by routing path type - direct or via_broker; pass all (or omit) for every path

amountMin · number

Minimum trade notional in USD (inclusive)

amountMax · number

Maximum trade notional in USD (inclusive)

limit · integer · default: 25

Page size, clamped to [1, 100]

Required range: 1 <= x <= 100

offset · integer · default: 0

Number of records to skip

sortBy · string

Sort column: created_at (default), order_id, member, corridor, amount_usd, lp_name, routing_path, settlement_status, settlement_speed_ms - unrecognized values fall back to created_at

sortDir · enum<string> · default: desc

Sort direction; defaults to desc

Available options: asc, desc

Response

200

application/json

Successful Response

Paginated trade list response.

items · TradeListItem · object[] · required

Trades in this page

Show child attributes

total · integer · required

Total number of trades matching the filters

offset · integer · required

Offset this page starts at

limit · integer · required

Effective page size