Show Active Trades

Gets the currently live blotter for the API key owner's company. Archived (EOD) trades are not included; use Trade Revisions with a known internalTradeID if you need history for a specific trade.

URL : /api/trade

Method : GET

Auth required : YES (API Key)

Permissions required : None

Request headers

X-API-KEY: "<api_key>"
X-API-SECRET: "<api_secret>"

Null fields are omitted from each trade object.

Success Response

Code : 200 OK

The array of trades is in result.

Details of a Futures trade on IFEU:

{
  "timestamp": "2024-11-21T17:16:12.424011385Z",
  "status": 200,
  "result": [
    {
      "internalTradeID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tradeID": "20241119-005",
      "userID": "jj@java2go.com",
      "side": "Sell",
      "quantity": 1,
      "price": 100.00000000,
      "tradeDate": "2024-11-19",
      "currency": "USD",
      "mic": "IFEU",
      "assetClass": "Future",
      "instrumentCode": "B",
      "instrumentCodeType": "Ticker",
      "maturity": "2025-06-01",
      "client": "CTCINC",
      "executingBroker": "JJFUTLTD",
      "clearingBroker": "DBAG",
      "clearingAccount": "GC123",
      "executionTime": "2024-11-19T23:33:00.895319Z",
      "reportedTime": "2024-11-19T23:33:01.492583Z",
      "confirmationStatus": "AutoConfirmed",
      "status": "New",
      "version": 1
    }
  ],
  "path": "/api/trade"
}

Details of an Option trade on XNYM after one amendment:

{
  "timestamp": "2024-11-21T17:16:12.424011385Z",
  "status": 200,
  "result": [
    {
      "internalTradeID": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "tradeID": "119934867",
      "userID": "jj@java2go.com",
      "side": "Sell",
      "quantity": 200,
      "price": 0.09600000,
      "tradeDate": "2024-10-27",
      "currency": "USD",
      "mic": "XNYM",
      "assetClass": "Option",
      "instrumentCode": "ON",
      "instrumentCodeType": "Ticker",
      "strike": 3.20,
      "optionType": "Call",
      "maturity": "2024-12-01",
      "client": "CTCINC",
      "executingBroker": "JJFUTLTD",
      "clearingBroker": "JPMLLC",
      "clearingAccount": "CTC123",
      "executionTime": "2024-10-27T13:27:33Z",
      "giveupTime": "2024-10-28T13:32:01Z",
      "reportedTime": "2024-10-31T14:54:07.630565Z",
      "confirmationStatus": "Unconfirmed",
      "status": "Amend",
      "version": 2
    }
  ],
  "path": "/api/trade"
}

Details of a CalendarSpread multi-leg trade on IFEU:

{
  "timestamp": "2025-01-16T10:00:01.123456Z",
  "status": 200,
  "result": [
    {
      "internalTradeID": "0f14d0ab-9608-4a3f-a08a-33129e6c7a84",
      "tradeID": "ML-20250116-001",
      "userID": "jj@java2go.com",
      "strategyName": "CalendarSpread",
      "side": "Buy",
      "quantity": 10,
      "price": 0.00000000,
      "tradeDate": "2025-01-16",
      "currency": "USD",
      "mic": "IFEU",
      "assetClass": "Future",
      "instrumentCodeType": "Ticker",
      "maturity": "2025-03-01",
      "client": "CTCLTD",
      "executingBroker": "DBAG",
      "clearingBroker": "DBAG",
      "clearingAccount": "GC123",
      "executionTime": "2025-01-16T10:00:00Z",
      "reportedTime": "2025-01-16T10:00:01.123456Z",
      "confirmationStatus": "AutoConfirmed",
      "status": "New",
      "version": 1,
      "legs": [
        {
          "tradeID": "ML-20250116-001-L1",
          "side": "Buy",
          "quantity": 10,
          "price": 76.00000000,
          "mic": "IFEU",
          "assetClass": "Future",
          "instrumentCode": "B",
          "maturity": "2025-03-01",
          "executionTime": "2025-01-16T10:00:00Z",
          "status": "New",
          "version": 1
        },
        {
          "tradeID": "ML-20250116-001-L2",
          "side": "Sell",
          "quantity": 10,
          "price": 75.50000000,
          "mic": "IFEU",
          "assetClass": "Future",
          "instrumentCode": "B",
          "maturity": "2025-04-01",
          "executionTime": "2025-01-16T10:00:00Z",
          "status": "New",
          "version": 1
        }
      ]
    }
  ],
  "path": "/api/trade"
}

Details of a Butterfly options multi-leg trade on IFEU:

{
  "timestamp": "2025-01-16T10:00:01.123456Z",
  "status": 200,
  "result": [
    {
      "internalTradeID": "2c5ea4c0-4067-4a8c-9f0a-1c1d3b4e5f60",
      "tradeID": "ML-20250116-003",
      "userID": "jj@java2go.com",
      "strategyName": "Butterfly",
      "side": "Buy",
      "quantity": 10,
      "price": 0.00000000,
      "tradeDate": "2025-01-16",
      "currency": "USD",
      "mic": "IFEU",
      "assetClass": "Option",
      "instrumentCodeType": "Ticker",
      "strike": 75.00,
      "optionType": "Call",
      "maturity": "2025-06-01",
      "client": "CTCLTD",
      "executingBroker": "DBAG",
      "clearingBroker": "DBAG",
      "clearingAccount": "GC123",
      "executionTime": "2025-01-16T10:00:00Z",
      "reportedTime": "2025-01-16T10:00:01.123456Z",
      "confirmationStatus": "AutoConfirmed",
      "status": "New",
      "version": 1,
      "legs": [
        {
          "tradeID": "ML-20250116-003-L1",
          "side": "Buy",
          "quantity": 10,
          "price": 5.00000000,
          "mic": "IFEU",
          "assetClass": "Option",
          "instrumentCode": "B",
          "maturity": "2025-06-01",
          "strike": 70.00,
          "optionType": "Call",
          "executionTime": "2025-01-16T10:00:00Z"
        },
        {
          "tradeID": "ML-20250116-003-L2",
          "side": "Sell",
          "quantity": 20,
          "price": 3.00000000,
          "mic": "IFEU",
          "assetClass": "Option",
          "instrumentCode": "B",
          "maturity": "2025-06-01",
          "strike": 75.00,
          "optionType": "Call",
          "executionTime": "2025-01-16T10:00:00Z"
        },
        {
          "tradeID": "ML-20250116-003-L3",
          "side": "Buy",
          "quantity": 10,
          "price": 1.50000000,
          "mic": "IFEU",
          "assetClass": "Option",
          "instrumentCode": "B",
          "maturity": "2025-06-01",
          "strike": 80.00,
          "optionType": "Call",
          "executionTime": "2025-01-16T10:00:00Z"
        }
      ]
    }
  ],
  "path": "/api/trade"
}

Fields added in 1.2.5

Field	Meaning
internalTradeID	Server UUID for this live (or historical) row. Use it on revisions. Not the user tradeID.
status	New | Amend | Cancel
version	Integer. 1 on New; increments on each Amend; unchanged on Cancel. Read-only.
confirmationStatus	Unconfirmed | Confirmed | Rejected | AutoConfirmed

A cancelled trade remains on the live blotter until end-of-day archive, occupying the uniqueness key until then.

Notes

• The fields strike and optionType are only returned for Option trades.
• Multi-leg trades include a strategyName field and a legs array.
• Legs inherit client, tradeDate, clearingBroker, clearingAccount, executingBroker, and executingAccount from the parent.
• tradeID is always the user-supplied id (no version suffix). Version is its own field.

Error Response

Code : 400 BAD REQUEST — for example if the key's company cannot be resolved.

Code : 500 INTERNAL SERVER ERROR