contractLibrary

Roll Contracts

Resolve the next or previous contract for multiple contracts in one request.

Available to: All authenticated users

Environments: Demo, Live

Rate Limit: 1,000 requests per hour, 1-second back-off, counts all requests

Batch version of rollContract. Supply a rollContracts array, each entry naming a contract (name) with a forward direction (true for the next maturity, false for the previous) and an optional ifExpired flag. Each entry is resolved independently to the adjacent contract in its product's maturity sequence. This resolves contract definitions only — it does not move positions or place orders.

On success, the response contracts field is a map keyed by the requested contract name, with each value the resolved Contract (its id, name, and contractMaturityId). If the request fails, errorText describes the reason.

Common Failure Scenarios

  • A supplied name does not match any contract.
  • There is no adjacent maturity in the requested direction for one of the entries.

Error Messages

errorTextTrigger
Non-empty errorTextThe request failed; the field describes the reason.
post/contract/rollcontracts

Request

  • Base URL: https://demo.tradovateapi.com/v1
  • URL: https://demo.tradovateapi.com/v1/contract/rollcontracts
  • Auth: HTTP bearer

Request body

Response

RollContractsResponse

errorTextstring

Non-empty if the request failed

contractsRollContractsResponseContracts required

Changes

No recorded changes to this operation across all 1 revision of this API.