WebSocketPositionDTO

APIGateway

Schemas

WebSocketOrderStatusDTO

idinteger(int64)

The row ID. Read-only. Only present in response

orderIdstring or null

The OrderId. Only required in NewAutotradeOrder and ReplaceAutotradeOrder endpoints

strategyIdinteger or null(int64)

The C2 StrategyId

strategyNamestring or null

The C2 Strategy name. Read-only. Only present in response

signalIdinteger or null(int64)

Only required in ReplaceAutotradeOrder endpoint. The C2 SignalId

avgPxnumber or null(double)

The order average fill price

orderTypestring or null

'1' = Market, '2' = Limit, '3' = Stop

Enum Value	Description
1	Market
2	Limit
3	Stop

Example: "1"

sidestring or null

'1' = Buy, '2' = Sell

Enum Value	Description
1	Buy
2	Sell

Example: "1"

openClosestring or null

Only required in ReplaceAutotradeOrder endpoint. 'O' = Open, 'C' = Close

Enum Value	Description
O	Open
C	Close

Example: "O"

orderQuantitynumber or null(double)

The unsigned order quantity

limitnumber or null(double)

The C2-formatted Limit Price

stopnumber or null(double)

The C2-formatted Stop Price

tifstring or null

The time in force. 0 = Day, 1 = Good Till Cancel (GTC)

Enum Value	Description
0	Day
1	GTC

Example: "0"

profitTargetnumber or null(double)

Only available in NewStrategyOrder endpoint. The C2-formatted Price at which to place a exit conditional order

stopLossnumber or null(double)

Only available in NewStrategyOrder endpoint. The C2-formatted Price at which to place a exit conditional order

doNotCreateOCAGroupboolean or null

Only available in NewStrategyOrder endpoint. Default is false. Used to indicate the ProfitTarget and StopLoss orders should not be added to a OCA group. Each exit order will be managed separately

cancelReplaceSignalIdinteger or null(int64)

Used to specify that this order replaces another

parentSignalIdinteger or null(int64)

Used to specify that this order is conditional (a child) on another

parkedUntilDatestring or null(date-time)

The New-York date/time when the signal should be released. Applies only to Strategy signals

doNotSyncToOpenboolean or null

Used to indicate this order should not be synched in the brokerage account. Only applies to Opening non-market orders

c2Symbolobject(WebSocketC2SymbolDTO)

exchangeSymbolobject(WebSocketExchangeSymbolDTO)

rejectMessagestring or null

The order rejection message. Only available in response when OrderStatus = '8' (Rejected)

brokerIdinteger or null(int64)

BrokerId

orderStatusstring or null

'A' = PendingNew, '0' = Working, '1' = Partially filled, '2' = Filled, '4' = Canceled, '5' = Replaced, '6' = Pending Cancel, '8' = Rejected, 'C' = Expired, 'E' = Pending Replace

filledQuantitynumber or null(double)

The unsigned quantity filled

avgFillPricenumber or null(double)

The average execution price for FilledQuantity. For AutoTrade orders, omitted when there are no fills or matching cumulative execution data is not yet available; never estimated from quotes or limit prices.

postedDatestring or null(date-time)

UTC DateTime when the order was posted

signalTypeinteger(int32)

The type of signal. 1 = StrategySignal, 4 = ManualSignal, 5 = StrategySignalManualOverride, 6 = AutoStopLoss

infostring or null

Detailed information about the order, if available

{
  "id": 0,
  "orderId": "string",
  "strategyId": 0,
  "strategyName": "string",
  "signalId": 0,
  "avgPx": 0.1,
  "orderType": "1",
  "side": "1",
  "openClose": "O",
  "orderQuantity": 0.1,
  "limit": 0.1,
  "stop": 0.1,
  "tif": "0",
  "profitTarget": 0.1,
  "stopLoss": 0.1,
  "doNotCreateOCAGroup": true,
  "cancelReplaceSignalId": 0,
  "parentSignalId": 0,
  "parkedUntilDate": "2019-08-24T14:15:22Z",
  "doNotSyncToOpen": true,
  "c2Symbol": {
    "fullSymbol": "string",
    "symbolType": "string",
    "underlying": "string",
    "expiry": "string",
    "putOrCall": "string",
    "strikePrice": 0.1,
    "description": "string"
  },
  "exchangeSymbol": {
    "symbol": "string",
    "currency": "string",
    "securityExchange": "string",
    "securityType": "string",
    "maturityMonthYear": "string",
    "putOrCall": 0,
    "strikePrice": 0.1,
    "priceMultiplier": 0.1
  },
  "rejectMessage": "string",
  "brokerId": 0,
  "orderStatus": "string",
  "filledQuantity": 0.1,
  "avgFillPrice": 0.1,
  "postedDate": "2019-08-24T14:15:22Z",
  "signalType": 0,
  "info": "string"
}

WebSocketPositionDTO

strategyIdinteger or null(int64)

The C2 StrategyId

quantitynumber or null(double)

The net signed position quantity. Short positions will be negative.

avgPxnumber or null(double)

The position average price

c2Symbolobject(WebSocketC2SymbolDTO)

exchangeSymbolobject(WebSocketExchangeSymbolDTO)

strategyNamestring or null

The C2 Strategy name

currencystring or null

The 3-character ISO instrument currency. E.g. 'USD'

openedDatestring or null(date-time)

UTC DateTime when the position was opened

{
  "strategyId": 0,
  "quantity": 0.1,
  "avgPx": 0.1,
  "c2Symbol": {
    "fullSymbol": "string",
    "symbolType": "string",
    "underlying": "string",
    "expiry": "string",
    "putOrCall": "string",
    "strikePrice": 0.1,
    "description": "string"
  },
  "exchangeSymbol": {
    "symbol": "string",
    "currency": "string",
    "securityExchange": "string",
    "securityType": "string",
    "maturityMonthYear": "string",
    "putOrCall": 0,
    "strikePrice": 0.1,
    "priceMultiplier": 0.1
  },
  "strategyName": "string",
  "currency": "string",
  "openedDate": "2019-08-24T14:15:22Z"
}

WebSocketSubscriptionMessage

msg_typestring or null

idstring or nullread-only

seq_idinteger or null(int64)

SeqId

request_idstring or null

timestampstring(date-time)

vinteger(int32)

accountstring or null

broker_idinteger or null(int32)

is_snapshotboolean or null

payloadobject(SubscriptionPayload)

{
  "msg_type": "string",
  "id": "string",
  "seq_id": 0,
  "request_id": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "v": 0,
  "account": "string",
  "broker_id": 0,
  "is_snapshot": true,
  "payload": {
    "action": "string",
    "channel": "string",
    "account": "string",
    "broker_id": 0,
    "person_id": 0,
    "strategy_id": 0,
    "resume_from": 0
  }
}

GetAutotradedStrategies

Request

Request the Autotraded strategies of the person. Paginated endpoint.

Query

PersonIdinteger or null(int64)required

PersonId

Accountstring

The Autotrade account (optional)

curl -i -X GET \
  'https://api4-general.collective2.com/Autotrade/GetAutotradedStrategies?PersonId=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(AutotradedStrategyDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "PersonId": 0,
      "Account": "string",
      "ScalingPercentage": 0.1,
      "StrategyId": 0,
      "StrategyName": "string",
      "BrokerId": 0,
      "BrokerName": "string",
      "StartDate": "2019-08-24T14:15:22Z",
      "LastModified": "2019-08-24T14:15:22Z"
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetAutotraders

Request

A list of Autotraders. Paginated endpoint.

Query

StrategyIdinteger or null(int64)

(Optional) StrategyId filter

BrokerIdinteger or null(int32)

(optional) The Autotrade BrokerId

WhiteLabelSiteIdinteger or null(int64)

(optional) The White Label Site Id

curl -i -X GET \
  https://api4-general.collective2.com/Autotrade/GetAutotraders

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(AutotradedStrategyDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "PersonId": 0,
      "Account": "string",
      "ScalingPercentage": 0.1,
      "StrategyId": 0,
      "StrategyName": "string",
      "BrokerId": 0,
      "BrokerName": "string",
      "StartDate": "2019-08-24T14:15:22Z",
      "LastModified": "2019-08-24T14:15:22Z"
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetAutotradeSettings

Request

The Autotrade Settings. Non-paginated endpoint.

Query

PersonIdinteger or null(int64)required

PersonId

Accountstring

(Optional) Account

curl -i -X GET \
  'https://api4-general.collective2.com/Autotrade/GetAutotradeSettings?PersonId=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(AutotradeSettingsDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "PersonId": 0,
      "FirstName": "string",
      "LastName": "string",
      "Email": "string",
      "Country": "string",
      "State": "string",
      "Language": "string",
      "SiteDomain": "string",
      "BrokerId": 0,
      "Connection": "string",
      "IntroducingBrokerId": 0,
      "IntroducingBroker": "string",
      "StrategyId": 0,
      "StrategyName": "string",
      "Account": "string",
      "AccountType": 0,
      "BrokerUserID": "string",
      "Currency": "string",
      "SalesRepId": 0,
      "SalesRep": "string",
      "IsTradeLeader": true,
      "IgnoreManualOrders": true,
      "IsConfirmationNeeded": true,
      "IsSyncEnabled": true,
      "WillSyncToOpenStocksUSA": true,
      "WillSyncToOpenStocksEurope": true,
      "WillSyncToOpenOptionsUSA": true,
      "WillSyncToOpenOptionsEurope": true,
      "WillSyncToOpenFuturesUSA": true,
      "WillSyncToOpenFuturesEurope": true,
      "WillSyncToOpenFuturesAsia": true,
      "WillSyncToOpenForex": true,
      "LastSyncStocksUSA": "2019-08-24T14:15:22Z",
      "LastSyncStocksEurope": "2019-08-24T14:15:22Z",
      "LastSyncOptionsUSA": "2019-08-24T14:15:22Z",
      "LastSyncOptionsEurope": "2019-08-24T14:15:22Z",
      "LastSyncFuturesUSA": "2019-08-24T14:15:22Z",
      "LastSyncFuturesEurope": "2019-08-24T14:15:22Z",
      "LastSyncFuturesAsia": "2019-08-24T14:15:22Z",
      "LastSyncForex": "2019-08-24T14:15:22Z",
      "IsBrokerEnabled": true,
      "IsAutotradeDisabled": true,
      "IsAutotradeDisabledReason": "string",
      "SyncDisabledReason": "string",
      "FirstBrokerActivationDate": "2019-08-24T14:15:22Z",
      "NetLiquidationValue": 0.1,
      "NetLiquidationValueDate": "2019-08-24T14:15:22Z",
      "VirtualLimitOrdersEnabled": true,
      "ScalingPercentage": 0.1,
      "SettingsLastUpdateUTC": "2019-08-24T14:15:22Z",
      "Approved": true,
      "BrokerAuthorizationStatus": "string",
      "ClosingOrdersOnly": true,
      "EnabledFutures": true,
      "FuturesLong": true,
      "FuturesShort": true,
      "MinFutures": 0,
      "MaxFutures": 0,
      "EnabledForex": true,
      "ForexEnabledLong": true,
      "ForexEnabledShort": true,
      "ForexLotSize": 0,
      "MinForex": 0,
      "MaxForex": 0,
      "EnabledStocks": true,
      "StocksLong": true,
      "StocksShort": true,
      "MaxStocksDollars": 0,
      "TradeStocksAsCFD": true,
      "EnabledOptions": true,
      "OptionsLong": true,
      "OptionsShort": true,
      "MinOptions": 0,
      "MaxOptions": 0
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

SetAutotradeSettings

Request

Enable or disable Autotrade or Autosync in the specified account.

Bodyapplication/jsonrequired

Accountstring or null

The Autotrade account

PersonIdinteger or null(int64)

The C2 PersonID

BrokerIdinteger or null(int32)

The C2 PersonID

IsAutotradeEnabledboolean or null

Set to TRUE if you want to enable the account for Autotrade. The StartAutotrade endpoint will automatically enable this setting. It may be disabled if your account is delinked by the broker, or if we detect rare unexpected activity in your account such as a margin call, pattern day trader, account becomes restricted by the broker, etc.

IsAutoSyncEnabledboolean or null

Set to TRUE if you want to enable or disable AutoSync for the account. AutoSync automatically gets disabled whenever an external (i.e. non-C2) order is executed in the account.

curl -i -X PUT \
  https://api4-general.collective2.com/Autotrade/SetAutotradeSettings \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

ResultsArray of booleans or null

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    true
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetDashBoard

Request

Request the Person's Autotraded strategies and a performance summary. Non-paginated endpoint.

Query

PersonIdinteger or null(int64)required

PersonId

Accountstringrequired

The brokerage Account

curl -i -X GET \
  'https://api4-general.collective2.com/Autotrade/GetDashBoard?PersonId=0&Account=string'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(DashBoardItemDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "PersonId": 0,
      "BrokerName": "string",
      "Account": "string",
      "StrategyId": 0,
      "StrategyName": "string",
      "StartDate": "2019-08-24T14:15:22Z",
      "TodayReturn": 0.1,
      "TotalReturn": 0.1
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

SearchAccounts

Request

Request a list of brokerage and Papertrade accounts, including accounts not currently autotrading. Partial matches will be returned. Paginated endpoint.

Query

Accountstring

(optional) The brokerage account

PersonIdinteger or null(int64)

(optional) PersonId

BrokerIdinteger or null(int32)

(optional) The BrokerId

FirstNamestring

(optional) The FirstName. Not case-sensitive

LastNamestring

(optional) The FirstName. Not case-sensitive

Emailstring

(optional) The Email

WhiteLabelSiteIdinteger or null(int64)

(optional) The White Label site Id

CountryCodestring

(optional) The person's country code. Not case-sensitive

IPAddressstring

(optional) The person's last known IP address

Phonestring

(optional) The Phone number

curl -i -X GET \
  https://api4-general.collective2.com/Autotrade/SearchAccounts

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(AccountDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "PersonId": 0,
      "Account": "string",
      "BrokerName": "string",
      "BrokerId": 0,
      "FirstName": "string",
      "LastName": "string",
      "Email": "string",
      "Language": "string",
      "WhiteLabelSiteId": 0,
      "GeoSite": "string",
      "CountryCode": "string",
      "DivisionCode": "string",
      "AuthenticatedDate": "2019-08-24T14:15:22Z"
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetAutotradeActiveOrders

Request

Request the Working orders of the Account. Non-paginated endpoint.

Query

Accountstringrequired

The Brokerage Account

PersonIdinteger or null(int64)required

The PersonId owning the account

StrategyIdinteger or null(int64)

(Optional) StrategyId filter

curl -i -X GET \
  'https://api4-general.collective2.com/Autotrade/GetAutotradeActiveOrders?Account=string&PersonId=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(OrderStatusDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "OrderId": "string",
      "StrategyId": 0,
      "StrategyName": "string",
      "SignalId": 0,
      "AvgPx": 0.1,
      "OrderType": "1",
      "Side": "1",
      "OpenClose": "O",
      "OrderQuantity": 0.1,
      "Limit": 0.1,
      "Stop": 0.1,
      "TIF": "0",
      "ProfitTarget": 0.1,
      "StopLoss": 0.1,
      "DoNotCreateOCAGroup": true,
      "CancelReplaceSignalId": 0,
      "ParentSignalId": 0,
      "ParkedUntilDate": "2019-08-24T14:15:22Z",
      "DoNotSyncToOpen": true,
      "C2Symbol": { … },
      "ExchangeSymbol": { … },
      "RejectMessage": "string",
      "BrokerId": 0,
      "OrderStatus": "string",
      "FilledQuantity": 0.1,
      "AvgFillPrice": 0.1,
      "PostedDate": "2019-08-24T14:15:22Z",
      "SignalType": 0,
      "Info": "string"
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetAutotradeHistoricalOrders

Request

Request the historical orders of the Account. Paginated endpoint.

Query

Accountstringrequired

Brokerage Account filter

PersonIdinteger or null(int64)required

The PersonId owning the account

BrokerIdinteger or null(int32)

BrokerId (Optional)

StrategyIdinteger or null(int64)

StrategyId (Optional)

OrderStatusstring

'A' = PendingNew, '0' = Working, '1' = Partially filled, '2' = Filled, '4' = Canceled, '5' = Replaced, '6' = Pending Cancel, '8' = Rejected, 'C' = Expired, 'E' = Pending Replace (Optional)

StartDatestring or null(date-time)

StartDate (Optional)

EndDatestring or null(date-time)

EndDate (Optional)

curl -i -X GET \
  'https://api4-general.collective2.com/Autotrade/GetAutotradeHistoricalOrders?Account=string&PersonId=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(OrderStatusDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "OrderId": "string",
      "StrategyId": 0,
      "StrategyName": "string",
      "SignalId": 0,
      "AvgPx": 0.1,
      "OrderType": "1",
      "Side": "1",
      "OpenClose": "O",
      "OrderQuantity": 0.1,
      "Limit": 0.1,
      "Stop": 0.1,
      "TIF": "0",
      "ProfitTarget": 0.1,
      "StopLoss": 0.1,
      "DoNotCreateOCAGroup": true,
      "CancelReplaceSignalId": 0,
      "ParentSignalId": 0,
      "ParkedUntilDate": "2019-08-24T14:15:22Z",
      "DoNotSyncToOpen": true,
      "C2Symbol": { … },
      "ExchangeSymbol": { … },
      "RejectMessage": "string",
      "BrokerId": 0,
      "OrderStatus": "string",
      "FilledQuantity": 0.1,
      "AvgFillPrice": 0.1,
      "PostedDate": "2019-08-24T14:15:22Z",
      "SignalType": 0,
      "Info": "string"
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetAutoTradeOpenPositions

Request

Request the open positions of the Account. Non-paginated endpoint.

Query

Accountstringrequired

Brokerage Account filter

StrategyIdinteger or null(int64)

(Optional) StrategyId filter

curl -i -X GET \
  'https://api4-general.collective2.com/Autotrade/GetAutoTradeOpenPositions?Account=string'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(PositionDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "StrategyId": 0,
      "Quantity": 0.1,
      "AvgPx": 0.1,
      "C2Symbol": { … },
      "ExchangeSymbol": { … },
      "StrategyName": "string",
      "Currency": "string",
      "OpenedDate": "2019-08-24T14:15:22Z"
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

NewAutotradeOrder

Request

Send a new closing order to the specified account. Only Stop and Limit OrderTypes are supported. Non-paginated endpoint.

Bodyapplication/jsonrequired

Accountstring or null

The Autotrade account

PersonIdinteger or null(int64)

The C2 PersonID

Orderobject(OrderDTO)

curl -i -X POST \
  https://api4-general.collective2.com/Autotrade/NewAutotradeOrder \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(SignalIdDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "SignalId": 0,
      "ProfitTargetSignalId": 0,
      "StopLossSignalId": 0,
      "ExitSignalsOCAGroupId": 0,
      "ParkedUntilDate": "2019-08-24T14:15:22Z"
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

CancelAutotradeOrder

Request

Cancel an order in the specified account. Auto Stop-Loss orders are not currently supported. Non-paginated endpoint.

Query

Accountstringrequired

The Autotrade account

PersonIdinteger or null(int64)required

The C2 PersonID

OrderIdstringrequired

The OrderID to be cancelled

curl -i -X DELETE \
  'https://api4-general.collective2.com/Autotrade/CancelAutotradeOrder?Account=string&PersonId=0&OrderId=string'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(SignalIdDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "SignalId": 0,
      "ProfitTargetSignalId": 0,
      "StopLossSignalId": 0,
      "ExitSignalsOCAGroupId": 0,
      "ParkedUntilDate": "2019-08-24T14:15:22Z"
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

ReplaceAutotradeOrder

Request

Cancel/Replace an open closing order in the specified account. Only strategy and manual exit orders are currently supported.

Bodyapplication/jsonrequired

Accountstring or null

The Autotrade account

PersonIdinteger or null(int64)

The C2 PersonID

OrderIdstring or null

The OrderID to be replaced

Pricenumber or null(double)

The new Order price

curl -i -X PUT \
  https://api4-general.collective2.com/Autotrade/ReplaceAutotradeOrder \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(SignalIdDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "SignalId": 0,
      "ProfitTargetSignalId": 0,
      "StopLossSignalId": 0,
      "ExitSignalsOCAGroupId": 0,
      "ParkedUntilDate": "2019-08-24T14:15:22Z"
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetBrokers

Request

Get a list of Autotrade brokers. Non-Paginated endpoint.

Query

IncludeDisabledboolean or null

Include the disabled brokers. Default is FALSE. (optional)

curl -i -X GET \
  https://api4-general.collective2.com/Autotrade/GetBrokers

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(BrokerDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "Name": "string",
      "IsEnabled": true,
      "ConnectionName": "string"
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

StartAutotrade

Request

Start or modify an Autotrade setup. Non-paginated endpoint.

Bodyapplication/jsonrequired

Accountstring or null

The Autotrade account

PersonIdinteger or null(int64)

The C2 PersonID

BrokerIdinteger or null(int32)

The BrokerId

StrategyIdinteger or null(int64)

The StrategyId

ScalingPercentageinteger(int64)

The Autotrade Scaling factor. e.g. Enter 105 for 105%

FuturesEnabledboolean

(optional) TRUE to enable the Futures asset class when autotrading this strategy. Default is FALSE

Default false

MaxFuturesinteger or null(int32)

(optional) Set a maximum number of contracts to hold in a position for this strategy

ForexEnabledboolean

(optional) TRUE to enable autotrading Forex for this strategy. Default is FALSE

Default false

MaxForexinteger or null(int32)

(optional) Set a maximum number of units (each unit on C2 is 1000 currency units) to hold in a position for this strategy

StocksEnabledboolean

(optional) TRUE to enable autotrading Stocks for this strategy. Default is FALSE

Default false

MaxStocksDollarsinteger or null(int32)

(optional) Set a maximum number of dollars to hold in a position for this strategy (no decimals)

OptionsEnabledboolean

(optional) TRUE to enable autotrading Options for this strategy. Default is FALSE

Default false

ShortOptionsEnabledboolean

(optional) TRUE to enable the shorting of Options when autotrading this strategy. Default is FALSE

Default false

MaxOptionsinteger or null(int32)

(optional) Set a maximum number of contracts to hold in a position for this strategy

DoNotJoinCurrentSystemPositionsboolean or null

(optional) TRUE to prevent joining currently open positions in the strategy. Only applies to new Autotrade setups: this setting must not be set when modifing an existing Autotrade setup.

AutoStopLossinteger or null(int64)

(optional) Dollar value of the automated stop loss which will rest in addition to the strategy stop loss orders

AccountUserNamestring or null

(optional) The Brokerage account username. Only needed for specific Brokers, please enquire with support at help@collective2.com

AccountPasswordstring or null

(optional) The Brokerage account password. Only needed for specific Brokers, please enquire with support at help@collective2.com

curl -i -X POST \
  https://api4-general.collective2.com/Autotrade/StartAutotrade \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

boolean

Response

application/json

true

StopAutotrade

Request

Request that AutoTrading stop, subject to the caller's permissions. PlatformTransmit does not support this operation. The stop is accepted immediately and applied asynchronously when the AutoTrade server processes the account; show stop requested until the stopped state is observed. Repeated stops are safe. To change an active White Label setup, stop it and use WhiteLabelStartAutotrade for fresh customer approval. On the White Label API, stopping attempts to close the selected strategy's positions unless LeavePositionsOpen=true. Keeping positions is allowed only for the last AutoTrading strategy in the account; otherwise the request is refused so the customer can confirm closing. Other strategies continue. Pending approvals are retired and the customer is notified. The strategy subscription remains active; stop it separately. Non-paginated endpoint.

Query

Accountstringrequired

The Autotrade account

PersonIdinteger or null(int64)required

The C2 PersonID

BrokerIdinteger or null(int32)required

The BrokerId

StrategyIdinteger or null(int64)required

The StrategyId

LeavePositionsOpenboolean

TRUE to leave positions open; allowed only for the last AutoTrading strategy in the account. FALSE (default) requests closing this strategy's positions. White Label callers must show the customer the intended action; a keep request is refused if other strategies remain. A successful stop response does not guarantee closing orders have filled.

TerminateStrategySubscriptionboolean

TRUE to stop the Strategy subscription. Default is FALSE. Ignored on the White Label API; stop its subscription separately.

curl -i -X DELETE \
  'https://api4-general.collective2.com/Autotrade/StopAutotrade?Account=string&PersonId=0&BrokerId=0&StrategyId=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(StopAutotradeDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "RequestId": "string",
      "IsAlreadyStopped": true,
      "IsSubscriptionTerminated": true,
      "Message": "string"
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetSimResults

Request

Return free SIM subscription results, measured since each SIM started, not over a fixed 90-day window. Use IsResultReady before displaying performance; unavailable values are null or omitted. This is not an eligibility check or a daily-history endpoint. Non-Paginated endpoint.

Query

PersonIdinteger or null(int64)

PersonId (optional)

WhiteLabelSiteIdinteger or null(int64)

The WhiteLabel SiteId (optional)

ActiveOnlyboolean

Set to FALSE to get the full history of all Simulation results (optional). Default is TRUE

MaxAccountDaysinteger or null(int32)

The maximum account number of days to include (optional). Maximum default value is 365 days

MinLoginDaysinteger or null(int32)

The minimum number of days since the user logged in (optional)

curl -i -X GET \
  https://api4-general.collective2.com/Autotrade/GetSimResults

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(SimResultDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "PersonId": 0,
      "FirstName": "string",
      "LastName": "string",
      "Email": "string",
      "Account": "string",
      "StrategyId": 0,
      "StrategyName": "string",
      "StartDate": "2019-08-24T14:15:22Z",
      "EndDate": "2019-08-24T14:15:22Z",
      "StartEquity": 0.1,
      "EndEquity": 0,
      "TotalReturn": 0.1,
      "TotalDelta": 0.1,
      "ScalingFactor": 0.1,
      "SubscriptionId": 0,
      "IsResultReady": true
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetAutotradeSyncStatusReport

Request

The Autotrade Account Sync Report. Non-Paginated endpoint.

Query

PersonIdinteger or null(int64)required

PersonId

Accountstringrequired

Account

StrategyIdinteger or null(int64)

(Optional) StrategyId filter

curl -i -X GET \
  'https://api4-general.collective2.com/Autotrade/GetAutotradeSyncStatusReport?PersonId=0&Account=string'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(AutotradeSyncStatusReportDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "ReportType": 0,
      "PersonId": 0,
      "Account": "string",
      "StrategyId": 0,
      "SignalId": 0,
      "StrategyName": "string",
      "BrokerName": "string",
      "AccountQuantity": 0.1,
      "StrategyQuantity": 0.1,
      "ScaledQuantity": 0.1,
      "SignalType": 0,
      "InSync": true,
      "NotInSyncReason": "string",
      "C2Symbol": { … },
      "ExchangeSymbol": { … },
      "AutotradeSettings": { … }
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

ResetPaperTrade

Request

Reset the specified PaperTrade account.

Bodyapplication/jsonrequired

Accountstring or null

The Autotrade account

PersonIdinteger or null(int64)

The C2 PersonID

curl -i -X PUT \
  https://api4-general.collective2.com/Autotrade/ResetPaperTrade \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

ResultsArray of booleans or null

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    true
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

SyncPositionsToOpen

Request

Reset the Autosync PositionsToOpen flags for all enabled asset classes in the specified account/strategy. Account will sync-to-open positions once for the strategy, then resume normal operation (i.e. sync open orders and the closing of positions).

Bodyapplication/jsonrequired

Accountstring or null

The Autotrade account

PersonIdinteger or null(int64)

The C2 PersonID

BrokerIdinteger or null(int32)

The C2 PersonID

StrategyIdsArray of integers or null(int64)

A list of Strategy IDs

curl -i -X POST \
  https://api4-general.collective2.com/Autotrade/SyncPositionsToOpen \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(SyncPositionsToOpenDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "StrategyId": 0,
      "Success": true,
      "Reason": "string",
      "ReasonCode": 0
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

Hello

Request

Test endpoint that can be used to test your API Key, RateLimits, Headers, etc

Bodyapplication/jsonrequired

Namestring or null

Your name (or any string)

curl -i -X POST \
  https://api4-general.collective2.com/General/Hello \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

ResultsArray of strings or null

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    "string"
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetProfile

Request

Request details of a Person. Public profiles are visible to all. Private profile information will only be visible to the account owner. Non-paginated endpoint.

Query

PersonIdinteger or null(int64)

The C2 PersonId. If omitted, the requester's information will be returned.

IncludeIconInResponseboolean or null

(Optional) Set to TRUE to include the profile icon in the response.

curl -i -X GET \
  https://api4-general.collective2.com/General/GetProfile

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(PersonDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "Alias": "string",
      "FirstName": "string",
      "LastName": "string",
      "Email": "string",
      "Phone": "string",
      "IsPhoneVerified": true,
      "Language": "string",
      "WhiteLabelSiteId": 0,
      "CountryCode": "string",
      "DivisionCode": "string",
      "Created": "2019-08-24T14:15:22Z",
      "LastLoggedIn": "2019-08-24T14:15:22Z",
      "LastIP": "string",
      "IsEmailValidated": true,
      "IsAlive": true,
      "ApprovedAccounts": [ … ],
      "IsManager": true,
      "IsInvestor": true,
      "GeoSite": "string",
      "IsGeoSiteAdmin": true,
      "SupportCompanyName": "string",
      "SupportSiteURL": "string",
      "SupportEmail": "string",
      "Icon": "string"
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

SearchProfiles

Request

Search profiles using any field combination. Partial matches will be returned. Paginated endpoint. Only Admins, Geo and White-Label Admins can access this endpoint. If you're a GeoSite admin, you will see all your GeoSite members including your WhiteLabel members. If you're a WhiteLabel admin, you will see your WhiteLabel members, but not other GeoSite members. If you're neither, you will get a 403 error.

Query

PersonIdinteger or null(int64)

The C2 PersonId (optional)

FirstNamestring

The FirstName. Not case-sensitive (optional)

LastNamestring

The FirstName. Not case-sensitive (optional)

Emailstring

The Email. Not case-sensitive (optional)

WhiteLabelSiteIdinteger or null(int64)

The White Label site Id (optional)

CountryCodestring

The person's country code. Not case-sensitive. (optional) See https://en.wikipedia.org/wiki/ISO_3166-2

DivisionCodestring

The person's subdivision (e.g. provinces or states). Not case-sensitive. (optional) See https://en.wikipedia.org/wiki/ISO_3166-2

IPAddressstring

The person's last known IP address (optional)

Phonestring

The verified Phone number (optional)

IsAliveboolean or null

The Person's Status (optional)

IncludeIconInResponseboolean or null

(Optional) Set to TRUE to include the profile icon in the response.

IsEmailValidatedboolean or null

The Person's email validation status (optional)

curl -i -X GET \
  https://api4-general.collective2.com/General/SearchProfiles

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(PersonDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "Alias": "string",
      "FirstName": "string",
      "LastName": "string",
      "Email": "string",
      "Phone": "string",
      "IsPhoneVerified": true,
      "Language": "string",
      "WhiteLabelSiteId": 0,
      "CountryCode": "string",
      "DivisionCode": "string",
      "Created": "2019-08-24T14:15:22Z",
      "LastLoggedIn": "2019-08-24T14:15:22Z",
      "LastIP": "string",
      "IsEmailValidated": true,
      "IsAlive": true,
      "ApprovedAccounts": [ … ],
      "IsManager": true,
      "IsInvestor": true,
      "GeoSite": "string",
      "IsGeoSiteAdmin": true,
      "SupportCompanyName": "string",
      "SupportSiteURL": "string",
      "SupportEmail": "string",
      "Icon": "string"
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

UpdateProfile

Request

Update customer contact information. A site administrator with write authority may edit a customer belonging to that site without customer participation. Supports FirstName, LastName, Phone, CountryCode, Street, Street2, City, DivisionCode and ZipCode only. Brokerage accounts, credentials, AutoTrade settings and approval records cannot be changed here. A changed phone number becomes unverified; supplying the same number preserves its verification. Omitted/null fields are unchanged; use IsClearPhone to remove the number. General API does not yet implement this endpoint.

Bodyapplication/jsonrequired

PersonIdinteger or null(int64)

The C2 PersonId

FirstNamestring or null

Optional first name, 1-40 characters.

LastNamestring or null

Optional last name, 1-40 characters.

Phonestring or null

Optional phone in international format, e.g. +14155550123. Changing the number removes its verified status.

IsClearPhoneboolean or null

Remove the customer's contact phone and its verification. Cannot be combined with Phone.

CountryCodestring or null

Optional two-letter contact-country code. Does not change site membership or location recorded at login.

Streetstring or null

Optional street address, up to 80 characters. Empty clears it; null leaves it unchanged.

Street2string or null

Optional second address line, up to 80 characters. Empty clears it; null leaves it unchanged.

Citystring or null

Optional city, up to 40 characters. Empty clears it; null leaves it unchanged.

DivisionCodestring or null

Optional state or province, up to 20 characters. Empty clears it; null leaves it unchanged.

ZipCodestring or null

Optional postal code, up to 16 characters. Empty clears it; null leaves it unchanged.

curl -i -X PUT \
  https://api4-general.collective2.com/General/UpdateProfile \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(AddPersonResponseDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "PersonId": 0,
      "CSRF": "string"
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetInvestorPlanSubscriptions

Request

Request details of a Person's strategy subscriptions. Paginated endpoint

Query

PersonIdinteger or null(int64)required

The C2 PersonId

ActiveOnlyboolean

Set to FALSE to get all transactions (optional). Default is TRUE

curl -i -X GET \
  'https://api4-general.collective2.com/General/GetInvestorPlanSubscriptions?PersonId=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(SubscriptionDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "PersonId": 0,
      "LicenseType": "string",
      "LicenseTypeId": 0,
      "StartDate": "2019-08-24T14:15:22Z",
      "EndDate": "2019-08-24T14:15:22Z",
      "IsRecurring": true,
      "Cost": 0.1
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetManagerPlanSubscriptions

Request

Request details of a Person's strategy manager subscriptions. Paginated endpoint

Query

PersonIdinteger or null(int64)required

The C2 PersonId

ActiveOnlyboolean

Set to FALSE to get all transactions (optional). Default is TRUE

curl -i -X GET \
  'https://api4-general.collective2.com/General/GetManagerPlanSubscriptions?PersonId=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(SubscriptionDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "PersonId": 0,
      "LicenseType": "string",
      "LicenseTypeId": 0,
      "StartDate": "2019-08-24T14:15:22Z",
      "EndDate": "2019-08-24T14:15:22Z",
      "IsRecurring": true,
      "Cost": 0.1
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetSubscribedStrategies

Request

Request the subscribed strategies of the person. Paginated endpoint.

Query

PersonIdinteger or null(int64)required

PersonId

ActiveOnlyboolean

Set to FALSE to get all transactions (optional). Default is TRUE

curl -i -X GET \
  'https://api4-general.collective2.com/General/GetSubscribedStrategies?PersonId=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(SubcribedStrategyDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "PersonId": 0,
      "StrategyId": 0,
      "StrategyName": "string",
      "IsSimulation": true,
      "IsPaperTrade": true,
      "IsAlive": true,
      "StartDate": "2019-08-24T14:15:22Z",
      "EndDate": "2019-08-24T14:15:22Z",
      "MonthlyCost": 0.1,
      "NextChargeDate": "2019-08-24T14:15:22Z",
      "NextBillingPrice": 0.1,
      "BillingInterval": "string",
      "BillingIntervalCount": 0,
      "IsCancelPending": true,
      "BillingFailureCount": 0,
      "LastBillingFailureReason": "string",
      "LastBillingFailureAt": "2019-08-24T14:15:22Z"
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetAccessKey

Request

Get the requester's APIKey Role and expiration

curl -i -X GET \
  https://api4-general.collective2.com/General/GetAccessKey

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(AccessKeyDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "AccessKey": "string",
      "PersonId": 0,
      "FirstName": "string",
      "LastName": "string",
      "Email": "string",
      "WhiteLabelSiteId": 0,
      "GeoSiteId": "string",
      "Role": "string",
      "Message": "string",
      "CreateDate": "2019-08-24T14:15:22Z",
      "DeleteDate": "2019-08-24T14:15:22Z",
      "Comment": "string"
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

CreateSubscriptionCheckout

Request

Create a strategy-subscription checkout for the authenticated user. Returns an IntentId and an ApprovalUrl; the account holder must open the ApprovalUrl in a browser, review the price and terms, consent, and pay. Nothing is charged until the account holder approves. Poll GetSubscriptionCheckoutStatus for progress. Non-paginated endpoint.

Bodyapplication/jsonrequired

StrategyIdinteger or null(int64)

The StrategyId to subscribe to

BillingIntervalstring or null

(Optional) Billing interval: month (the default) or year (only for strategies that offer annual billing). Omit for the strategy's standard interval.

BillingIntervalCountinteger or null(int32)

(Optional) Number of billing intervals per charge. Defaults to 1.

curl -i -X POST \
  https://api4-general.collective2.com/General/CreateSubscriptionCheckout \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(SubscriptionCheckoutDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "IntentId": 0,
      "Status": "string",
      "StatusDetail": "string",
      "ApprovalUrl": "string",
      "WebCheckoutUrl": "string",
      "Price": 0.1,
      "Currency": "string",
      "BillingInterval": "string",
      "BillingIntervalCount": 0,
      "StrategyId": 0,
      "SubscriptionId": 0,
      "TrialDays": 0
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetSubscriptionCheckoutStatus

Request

Read the current state of a subscription checkout created with CreateSubscriptionCheckout. While a human step is pending the payload carries the ApprovalUrl; once active it carries the SubscriptionId. Poll no more than once every few seconds. Non-paginated endpoint.

Query

IntentIdinteger or null(int64)required

The IntentId returned by CreateSubscriptionCheckout

curl -i -X GET \
  'https://api4-general.collective2.com/General/GetSubscriptionCheckoutStatus?IntentId=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(SubscriptionCheckoutDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "IntentId": 0,
      "Status": "string",
      "StatusDetail": "string",
      "ApprovalUrl": "string",
      "WebCheckoutUrl": "string",
      "Price": 0.1,
      "Currency": "string",
      "BillingInterval": "string",
      "BillingIntervalCount": 0,
      "StrategyId": 0,
      "SubscriptionId": 0,
      "TrialDays": 0
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetStrategyDetails

Request

Request the strategy statistics. Non-paginated endpoint.

Query

StrategyIdinteger or null(int64)required

The Strategy ID

curl -i -X GET \
  'https://api4-general.collective2.com/Strategies/GetStrategyDetails?StrategyId=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(StrategyDetailsDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "StrategyId": 0,
      "StrategyName": "string",
      "ShortDescription": "string",
      "LongDescription": "string",
      "IsAlive": true,
      "IsResellable": true,
      "StartDate": "2019-08-24T14:15:22Z",
      "PrimarySecurityTypes": "string",
      "SecurityTypesEnabled": { … },
      "MonthlyCost": 0.1,
      "StrategyOwnerId": 0,
      "StrategyOwnerName": "string",
      "SuggestedCapital": 0,
      "LastModified": "2019-08-24T14:15:22Z",
      "Score": 0,
      "IsTradeOwnSystem": true,
      "TradeOwnSystemPercent": 0.1,
      "WhiteLabelSiteId": 0,
      "IsPrivate": true,
      "AUM": 0,
      "AUM_NumberOfAccounts": 0,
      "Return": 0.1,
      "ReturnLabel": "string",
      "Equity": 0.1,
      "Cash": 0.1,
      "StartingCash": 0.1,
      "ProfitFactor": 0.1,
      "CashDividends": 0.1,
      "BuyingPower": 0.1,
      "MarginUsed": 0.1,
      "AgeInDays": 0,
      "ModelAccountValue": 0.1,
      "NumTrades": 0,
      "NumWinners": 0,
      "NumLosers": 0,
      "PercentWinTrades": 0.1,
      "SumDollarWinners": 0.1,
      "SumDollarLosers": 0.1,
      "NumMonths": 0,
      "WinMonthsInUI": 0,
      "WinMonths": 0.1,
      "WinMonthsRatio": 0.1,
      "MaxDrawdown": 0.1,
      "MaxDrawdownDays": 0.1,
      "MaxDrawdownStartDate": "string",
      "MaxDrawdownEndDate": "string",
      "AvgWinDollars": 0.1,
      "AvgLossDollars": 0.1,
      "AvgTradeDuration": 0.1,
      "CorrelationSP500": 0.1,
      "SP500Return": 0.1,
      "ReturnVsSP500": 0.1,
      "AvgLeverage": 0.1,
      "MaxLeverage": 0.1,
      "CorrelationToSP500": 0.1,
      "Alpha": 0.1,
      "Beta": 0.1,
      "Treynor": 0.1,
      "Sortino": 0.1,
      "Sharpe": 0.1,
      "Calmar": 0.1,
      "NoSubsAllowed": true,
      "LatestTrade": "2019-08-24T14:15:22Z"
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

SearchStrategies

Request

Request a list of strategies available to the user. Paginated endpoint.

Query

SecurityTypestring

(optional) SecurityType filter. e.g. Stocks = 'CS', Futures = 'FUT', Options = 'OPT', Forex = 'FOR'

CreatedBeforeDatestring

(optional) Filter used to search old stategies. The date must be in ISO 8601 Date Format.

StrategyNamestring

Search strategies on name (optional). Partial matches will be returned. Wildcards % and _ are supported

StrategyOwnerPersonIdinteger or null(int64)

(optional) The C2 PersonId

WhiteLabelSiteIdinteger or null(int64)

(optional) The White Label site Id

IsTradeOwnSystemboolean or null

(optional) Filter on whether Strategy owner Trades his Own Strategy

curl -i -X GET \
  https://api4-general.collective2.com/Strategies/SearchStrategies

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(StrategyBasicDetailsDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "StrategyId": 0,
      "IsAlive": true,
      "IsPrivate": true,
      "StrategyName": "string",
      "StartDate": "2019-08-24T14:15:22Z",
      "SecurityTypesEnabled": { … },
      "MonthlyCost": 0.1,
      "StrategyOwnerId": 0,
      "WhiteLabelSiteId": 0,
      "IsTradeOwnSystem": true,
      "IsResellable": true
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetLeaderBoard

Request

Request the curated public leaderboard of strategies. Non-Paginated endpoint.

Query

SecurityTypestring

(optional) SecurityType filter. e.g. Stocks = 'CS', Futures = 'FUT', Options = 'OPT', Forex = 'FOR'

curl -i -X GET \
  https://api4-general.collective2.com/Strategies/GetLeaderBoard

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(StrategyBasicDetailsDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "StrategyId": 0,
      "IsAlive": true,
      "IsPrivate": true,
      "StrategyName": "string",
      "StartDate": "2019-08-24T14:15:22Z",
      "SecurityTypesEnabled": { … },
      "MonthlyCost": 0.1,
      "StrategyOwnerId": 0,
      "WhiteLabelSiteId": 0,
      "IsTradeOwnSystem": true,
      "IsResellable": true
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetSubscribers

Request

Request the list of subscribers of a strategy and their subscrition history. Paginated endpoint.

Query

StrategyIdinteger or null(int64)required

The C2 StrategyId

ActiveOnlyboolean or null

Set to True to include only currently active subscribers. Default is False

curl -i -X GET \
  'https://api4-general.collective2.com/Strategies/GetSubscribers?StrategyId=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(StrategySubscriberDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "StrategyId": 0,
      "StrategyName": "string",
      "PersonId": 0,
      "SubscriptionId": 0,
      "SubscriberId": 0,
      "IsStrategyOwner": true,
      "Alias": "string",
      "FirstName": "string",
      "LastName": "string",
      "Email": "string",
      "StartDate": "2019-08-24T14:15:22Z",
      "EndDate": "2019-08-24T14:15:22Z",
      "BasePrice": 0.1,
      "Markup": 0.1,
      "Cost": 0.1,
      "LastTransactionDate": "2019-08-24T14:15:22Z",
      "LastTransactionAmount": 0.1,
      "IsResale": 0.1,
      "WhiteLabelSiteId": 0,
      "GeoSiteId": "string"
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetSubscriptionRevenue

Request

Request the subscriber revenue of a strategy. Paginated endpoint. You must provide at least one parameter other than Start/End date.

Query

StrategyIdinteger or null(int64)

The C2 StrategyId (Optional)

StartDatestring

StartDate (Optional)

EndDatestring

EndDate (Optional)

StrategyOwnerPersonIdinteger or null(int64)

The Strategy Owner's PersonId (Optional)

SubscriberPersonIdinteger or null(int64)

The Subscriber's PersonId (Optional)

WhiteLabelSiteIdinteger or null(int64)

The White Label Site Id (Optional)

curl -i -X GET \
  https://api4-general.collective2.com/Strategies/GetSubscriptionRevenue

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(StrategySubscriberDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "StrategyId": 0,
      "StrategyName": "string",
      "PersonId": 0,
      "SubscriptionId": 0,
      "SubscriberId": 0,
      "IsStrategyOwner": true,
      "Alias": "string",
      "FirstName": "string",
      "LastName": "string",
      "Email": "string",
      "StartDate": "2019-08-24T14:15:22Z",
      "EndDate": "2019-08-24T14:15:22Z",
      "BasePrice": 0.1,
      "Markup": 0.1,
      "Cost": 0.1,
      "LastTransactionDate": "2019-08-24T14:15:22Z",
      "LastTransactionAmount": 0.1,
      "IsResale": 0.1,
      "WhiteLabelSiteId": 0,
      "GeoSiteId": "string"
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

NewStrategyOrder

Request

Send a new order for the strategy. Non-paginated endpoint.

Bodyapplication/jsonrequired

Orderobject(OrderDTO)

curl -i -X POST \
  https://api4-general.collective2.com/Strategies/NewStrategyOrder \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(SignalIdDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "SignalId": 0,
      "ProfitTargetSignalId": 0,
      "StopLossSignalId": 0,
      "ExitSignalsOCAGroupId": 0,
      "ParkedUntilDate": "2019-08-24T14:15:22Z"
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

CancelStrategyOrder

Request

Cancel a order. Non-paginated endpoint.

Query

StrategyIdinteger or null(int64)required

The Strategy ID

SignalIdinteger or null(int64)required

The Signal ID to be cancelled

curl -i -X DELETE \
  'https://api4-general.collective2.com/Strategies/CancelStrategyOrder?StrategyId=0&SignalId=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(SignalIdDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "SignalId": 0,
      "ProfitTargetSignalId": 0,
      "StopLossSignalId": 0,
      "ExitSignalsOCAGroupId": 0,
      "ParkedUntilDate": "2019-08-24T14:15:22Z"
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

ReplaceStrategyOrder

Request

Send a cancel/replace a order for the strategy. Non-paginated endpoint.

Bodyapplication/jsonrequired

Orderobject(OrderDTO)

curl -i -X PUT \
  https://api4-general.collective2.com/Strategies/ReplaceStrategyOrder \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(SignalIdDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "SignalId": 0,
      "ProfitTargetSignalId": 0,
      "StopLossSignalId": 0,
      "ExitSignalsOCAGroupId": 0,
      "ParkedUntilDate": "2019-08-24T14:15:22Z"
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetStrategyActiveOrders

Request

Request the open orders for the strategies. Non-paginated endpoint.

Query

StrategyIdsArray of integers(int64)required

A list of Strategy IDs

SecurityTypestring

(optional) SecurityType filter. e.g. Stocks = 'CS', Futures = 'FUT', Options = 'OPT', Forex = 'FOR'

OrderTypestring

(optional) OrderType filter. e.g. '1' = Market, '2' = Limit, '3' = Stop

curl -i -X GET \
  'https://api4-general.collective2.com/Strategies/GetStrategyActiveOrders?StrategyIds=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(OrderStatusDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "OrderId": "string",
      "StrategyId": 0,
      "StrategyName": "string",
      "SignalId": 0,
      "AvgPx": 0.1,
      "OrderType": "1",
      "Side": "1",
      "OpenClose": "O",
      "OrderQuantity": 0.1,
      "Limit": 0.1,
      "Stop": 0.1,
      "TIF": "0",
      "ProfitTarget": 0.1,
      "StopLoss": 0.1,
      "DoNotCreateOCAGroup": true,
      "CancelReplaceSignalId": 0,
      "ParentSignalId": 0,
      "ParkedUntilDate": "2019-08-24T14:15:22Z",
      "DoNotSyncToOpen": true,
      "C2Symbol": { … },
      "ExchangeSymbol": { … },
      "RejectMessage": "string",
      "BrokerId": 0,
      "OrderStatus": "string",
      "FilledQuantity": 0.1,
      "AvgFillPrice": 0.1,
      "PostedDate": "2019-08-24T14:15:22Z",
      "SignalType": 0,
      "Info": "string"
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetStrategyOpenPositions

Request

Request the open positions for the strategy. Non-paginated endpoint.

Query

StrategyIdsArray of integers(int64)required

A list of Strategy IDs

SecurityTypestring

(optional) SecurityType filter. e.g. Stocks = 'CS', Futures = 'FUT', Options = 'OPT', Forex = 'FOR'

curl -i -X GET \
  'https://api4-general.collective2.com/Strategies/GetStrategyOpenPositions?StrategyIds=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(PositionDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "StrategyId": 0,
      "Quantity": 0.1,
      "AvgPx": 0.1,
      "C2Symbol": { … },
      "ExchangeSymbol": { … },
      "StrategyName": "string",
      "Currency": "string",
      "OpenedDate": "2019-08-24T14:15:22Z"
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetStrategyHistoricalOrders

Request

Returns the historical orders of the strategy. Paginated endpoint.

Query

StrategyIdinteger or null(int64)

StrategyId (optional: StrategyId or SignalId must be present)

SignalIdinteger or null(int64)

SignalId (optional: StrategyId or SignalId must be present)

OrderStatusstring

Optional. Available values: '2' = Filled, '4' = Canceled, 'C' = Expired

StartDatestring

UTC StartDate (Optional)

EndDatestring

UTC EndDate (Optional)

curl -i -X GET \
  https://api4-general.collective2.com/Strategies/GetStrategyHistoricalOrders

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(OrderStatusDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "OrderId": "string",
      "StrategyId": 0,
      "StrategyName": "string",
      "SignalId": 0,
      "AvgPx": 0.1,
      "OrderType": "1",
      "Side": "1",
      "OpenClose": "O",
      "OrderQuantity": 0.1,
      "Limit": 0.1,
      "Stop": 0.1,
      "TIF": "0",
      "ProfitTarget": 0.1,
      "StopLoss": 0.1,
      "DoNotCreateOCAGroup": true,
      "CancelReplaceSignalId": 0,
      "ParentSignalId": 0,
      "ParkedUntilDate": "2019-08-24T14:15:22Z",
      "DoNotSyncToOpen": true,
      "C2Symbol": { … },
      "ExchangeSymbol": { … },
      "RejectMessage": "string",
      "BrokerId": 0,
      "OrderStatus": "string",
      "FilledQuantity": 0.1,
      "AvgFillPrice": 0.1,
      "PostedDate": "2019-08-24T14:15:22Z",
      "SignalType": 0,
      "Info": "string"
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

AddStrategy

Request

Create a new, empty strategy. Only Admins have the ability to set a OwnerPersonId or InitialSiteVisibility. Non-paginated endpoint.

Bodyapplication/jsonrequired

StrategyNamestring or null

The desired strategy name

StartingCapitalinteger or null(int64)

(Optional) The starting capital. Must be set when Account is not specified, ignored when Account is specified

StrategyOwnerPersonIdinteger or null(int64)

(Optional) The Strategy Owner's PersonId. Ignored on the General API (the owner is the caller by default). If you are a White Label site admin, the customer must belong to your White Label site

InitialSiteVisibilityboolean or null

(Optional) Whether the strategy is initially listed on the white-label site. Defaults to hidden. Applies only to platform/white-label strategy creation.

curl -i -X POST \
  https://api4-general.collective2.com/Strategies/AddStrategy \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(StrategyIdDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "StrategyId": 0
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

UpdateStrategy

Request

Update the name and descriptions of a strategy you own. Omitted or null fields are unchanged; an empty description clears it. Descriptions follow the hosted compliance review process, so acceptance does not mean immediate publication. Trading settings, ownership, pricing and customer AutoTrade permissions cannot be changed here. Non-paginated endpoint.

Bodyapplication/jsonrequired

StrategyIdinteger or null(int64)

The C2 StrategyId

Namestring or null

Optional strategy name: 3-40 characters, letters, digits, spaces, apostrophe, # or /.

ShortDescriptionstring or null

Optional short description, up to 300 characters. Empty clears it; null leaves it unchanged.

LongDescriptionstring or null

Optional long description, up to 20000 characters. Empty clears it; null leaves it unchanged.

curl -i -X PUT \
  https://api4-general.collective2.com/Strategies/UpdateStrategy \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(StrategyIdDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "StrategyId": 0
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetStrategyHistoricalEquity

Request

Returns monthly returns for the strategy. Non-paginated endpoint.

Query

StrategyIdinteger or null(int64)required

The Strategy ID to get data for

CommissionPlanstringrequired

(Optional) The commission plan to use. The default C2 web site CommissionPlan is used if none is specified. Available values: 0 = Default, 1 = C2Europe, 3 = IB, 4 = Tradovate, 5 = StoneX

curl -i -X GET \
  'https://api4-general.collective2.com/Strategies/GetStrategyHistoricalEquity?StrategyId=0&CommissionPlan=string'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(StrategyHistoricalEquityDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "StrategyId": 0,
      "StrategyName": "string",
      "StartDate": "2019-08-24T14:15:22Z",
      "SecurityTypesEnabled": { … },
      "MonthlyCost": 0.1,
      "StrategyOwnerId": 0,
      "MonthlyResults": [ … ]
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetStrategyHistoricalDailyEquity

Request

Returns daily returns for the strategy. Non-paginated endpoint.

Query

StrategyIdinteger or null(int64)required

The Strategy ID to get data for

CommissionPlanstringrequired

(Optional) The commission plan to use. The default C2 web site CommissionPlan is used if none is specified. Available values: 0 = Default, 1 = C2Europe, 3 = IB, 4 = Tradovate, 5 = StoneX

PublicationRevisionstring

Optional Revision from equity.daily_ready. Creates a separate viewer-scoped cache entry for the completed publication, so an earlier cached response is not reused. Does not bypass strategy access or viewing delays.

curl -i -X GET \
  'https://api4-general.collective2.com/Strategies/GetStrategyHistoricalDailyEquity?StrategyId=0&CommissionPlan=string'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(StrategyHistoricalEquityDTO)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "StrategyId": 0,
      "StrategyName": "string",
      "StartDate": "2019-08-24T14:15:22Z",
      "SecurityTypesEnabled": { … },
      "MonthlyCost": 0.1,
      "StrategyOwnerId": 0,
      "MonthlyResults": [ … ]
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetStrategyHistoricalClosedTrades

Request

Returns the historical closed trades of the strategy. The difference between an order and a trade is trades group orders on 'tradeid', much like you would see on our web site. Pagination is optional and disabled by default. Paginated results use trade ID order.

Query

CommissionPlanstringrequired

(Optional) The commission plan to use. The default web site CommissionPlan is used if none is specified. Available values: 0 = Default, 1 = C2Europe, 3 = IB, 4 = Tradovate, 5 = StoneX

StrategyIdinteger or null(int64)

The StrategyId

PersonIdinteger or null(int64)

(optional) The PersonId who will view the information. Available to WhiteLabel and GeoSite admins only. Default is the requester's PersonId

Paginateboolean

Enable cursor pagination. Default is false and returns all visible closed trades for backward compatibility.

AscendingOrderboolean

Set to true for oldest trade IDs first. Default is false (newest trade IDs first). Applies when Paginate is true.

curl -i -X GET \
  'https://api4-general.collective2.com/Strategies/GetStrategyHistoricalClosedTrades?CommissionPlan=string'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(HistoricalTradeDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "TradeId": 0,
      "StrategyId": 0,
      "OpenDate": "2019-08-24T14:15:22Z",
      "CloseDate": "2019-08-24T14:15:22Z",
      "AvgOpenFillPrice": 0.1,
      "AvgCloseFillPrice": 0.1,
      "OpenedQuantity": 0.1,
      "ClosedQuantity": 0.1,
      "OpenSide": "1",
      "CloseSide": "1",
      "ProfitLoss": 0.1,
      "Commission": 0.1,
      "MaxDrawdown": 0.1,
      "MaxDrawdown_DateCalculated": "2019-08-24T14:15:22Z",
      "MaxDrawdown_WorstPrice": 0.1,
      "MaxDrawdown_WorstPriceDate": "2019-08-24T14:15:22Z",
      "MaxDrawdown_StrategyEquity": 0.1,
      "MaxDrawdown_EntryPrice": 0.1,
      "MaxDrawdown_OpenQuantity": 0.1,
      "C2Symbol": { … },
      "ExchangeSymbol": { … }
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

SetDesiredPositionsV2

Request

The list of positions that must exist in the strategy. All C2 positions not in this list will be closed with market orders. Non-paginated endpoint.

Bodyapplication/jsonrequired

StrategyIdinteger or null(int64)

The C2 StrategyId

PositionsArray of objects or null(PositionBase)

The list of positions that must exist in the strategy. Quantity must be non-zero. To close a position, simply omit it from the Positions array. Sending an empty Positions array will close all positions.

curl -i -X POST \
  https://api4-general.collective2.com/v2/Strategies/SetDesiredPositions \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(DesiredPositionResponseDTOV2)

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "NewSignals": [ … ],
      "CanceledSignals": [ … ],
      "RejectedSignals": [ … ]
    }
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

SearchHistoricalStrategies

Request

Request a list of strategies available for the nearest date. Non-Paginated endpoint.

Bodyapplication/jsonrequired

ReportDateinteger or null(int64)

The date to look for. The server will automatically adjust the date to the nearest previous available day. Format must be YYYYMMDD.

RequirementsArray of objects or null(HistoricalStatDTO)

(optional) Add a maximum of 6 statistics requirements here. Use the GetHistoricalStrategiesStatsList endpoint for a list of available statistics for the specified date

Graveyardboolean or null

(optional) Set to TRUE to also include dead, killed, and archived strategies — for survivorship-bias-free research. Default is FALSE: only live, publicly subscribable strategies are returned. Strategies hidden for rights or administrative reasons are never returned in either mode.

curl -i -X POST \
  https://api4-general.collective2.com/Strategies/SearchHistoricalStrategies \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(HistoricalStrategyResponseDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "StrategyId": 0,
      "ReportDate": 0,
      "Statistics": [ … ]
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetHistoricalStrategiesStatsList

Request

Request a list of statistics available for the nearest date. Non-paginated endpoint.

Query

ReportDateinteger or null(int64)required

The date to look for. The server will automatically adjust the date to the nearest previous available day. Format must be YYYYMMDD.

curl -i -X GET \
  'https://api4-general.collective2.com/Strategies/GetHistoricalStrategiesStatsList?ReportDate=0'

Responses

OK

Bodyapplication/json

ResultsArray of strings or null

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    "string"
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetWatchLists

Request

Request all watchlists available to the user. Paginated endpoint.

Query

PersonIdinteger or null(int64)required

The C2 PersonId

curl -i -X GET \
  'https://api4-general.collective2.com/Strategies/GetWatchLists?PersonId=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(WatchListDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "PersonId": 0,
      "CreatedDate": "2019-08-24T14:15:22Z",
      "ListName": "string"
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetWatchListMembers

Request

Request a list of strategies in the watchlist. Paginated endpoint.

Query

PersonIdinteger or null(int64)required

The C2 PersonId

WatchListIdinteger or null(int64)required

The WatchList Id

curl -i -X GET \
  'https://api4-general.collective2.com/Strategies/GetWatchListMembers?PersonId=0&WatchListId=0'

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(WatchListMemberDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "AddedDate": "2019-08-24T14:15:22Z",
      "StrategyId": 0,
      "PersonId": 0
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

ManageWatchList

Request

Edit watchlists and their members. Non-paginated endpoint.

Bodyapplication/jsonrequired

PersonIdinteger or null(int64)

The C2 PersonId

WatchListIdinteger or null(int64)

The WatchList Id. Required except when ModificationAction=ADD and ModificationSource=LIST

ModificationSourcestring or null

The Type of list to modify. Valid values are 'LIST' (for the whole watchlist), 'MEMBER' (for the list items)

ModificationActionstring or null

The change to make. Valid values are: ADD, DELETE

StrategyIdinteger or null(int64)

The Strategy Id. Only required when ModificationSource=MEMBER

WatchListNamestring or null

The name of the watchlist. Only required when ModificationAction=ADD and ModificationSource=LIST

curl -i -X POST \
  https://api4-general.collective2.com/Strategies/ManageWatchList \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

OK

Bodyapplication/json

ResultsArray of booleans or null

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    true
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

ManageWatchList

Request

Edit watchlists and their members. Non-paginated endpoint.

Query

PersonIdinteger or null(int64)required

The C2 PersonId

ModificationSourcestringrequired

The Type of list to modify. Valid values are 'LIST' (for the whole watchlist), 'MEMBER' (for the list items)

ModificationActionstringrequired

The change to make. Valid values are: ADD, DELETE

WatchListIdinteger or null(int64)

The WatchList Id. Required except when ModificationAction=ADD and ModificationSource=LIST

StrategyIdinteger or null(int64)

The Strategy Id. Only required when ModificationSource=MEMBER

WatchListNamestring

The name of the watchlist. Only required when ModificationAction=ADD and ModificationSource=LIST

curl -i -X DELETE \
  'https://api4-general.collective2.com/Strategies/ManageWatchList?PersonId=0&ModificationSource=string&ModificationAction=string'

Responses

OK

Bodyapplication/json

ResultsArray of booleans or null

Result array

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    true
  ],
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

GetSupportedSymbols

Request

Request a list of supported Futures and Forex symbols. All US stocks > $5 and all US equity options are supported by default so they will not be sent in the response. We will include a few non-standard stock symbols that require special C2 symbology. Paginated and cached endpoint.

curl -i -X GET \
  https://api4-general.collective2.com/Strategies/GetSupportedSymbols

Responses

OK

Bodyapplication/json

ResultsArray of objects or null(SupportedSymbolDTO)

Result array

Paginationobject(PaginationProperties)

ResponseStatusobject(ResponseStatus)

Response

application/json

{
  "Results": [
    {
      "Id": 0,
      "Currency": "string",
      "Description": "string",
      "PointValue": 0.1,
      "TickSize": 0.1,
      "DecimalPrecision": 0,
      "C2Symbol": { … },
      "ExchangeSymbol": { … },
      "MarginRequirements": { … },
      "BrokerMarginRequirements": [ … ]
    }
  ],
  "Pagination": {
    "prev_cursor": "string",
    "next_cursor": "string"
  },
  "ResponseStatus": {
    "ErrorCode": "string",
    "Message": "string",
    "Errors": [
      { … }
    ]
  }
}

Collective2 General API (v4)CopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from ClaudeConnect to CursorInstall MCP server on CursorConnect to VS CodeInstall MCP server on VS Code

APIGateway

Schemas

WebSocketOrderStatusDTO

WebSocketPositionDTO

WebSocketSubscriptionMessage

GetAutotradedStrategies

Request

Responses

Was this helpful?

GetAutotraders

Request

Responses

Was this helpful?

GetAutotradeSettings

Request

Responses

Was this helpful?

SetAutotradeSettings

Request

Responses

Was this helpful?

GetDashBoard

Request

Responses

Was this helpful?

SearchAccounts

Request

Responses

Was this helpful?

GetAutotradeActiveOrders

Request

Responses

Was this helpful?

GetAutotradeHistoricalOrders

Request

Responses

Was this helpful?

GetAutoTradeOpenPositions

Request

Responses

Was this helpful?

NewAutotradeOrder

RequestExpand all

Responses

Was this helpful?

CancelAutotradeOrder

Request

Responses

Was this helpful?

ReplaceAutotradeOrder

Request

Responses

Was this helpful?

GetBrokers

Request

Responses

Was this helpful?

StartAutotrade

Request

Responses

Was this helpful?

StopAutotrade

Request

Responses

Was this helpful?

GetSimResults

Request

Responses

Was this helpful?

GetAutotradeSyncStatusReport

Request

Responses

Was this helpful?

ResetPaperTrade

Request

Responses

Was this helpful?

SyncPositionsToOpen

Request

Collective2 General API (v4)
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude
Connect to Cursor
Install MCP server on Cursor
Connect to VS Code
Install MCP server on VS Code

Request

Request