Skip to navigation
REST API EndpointsUsers

Accept Trading Permission

View as Markdown

Accept a trading permission granted by another party.

Available to: All authenticated users

Environments: Demo, Live

Rate Limit: No endpoint-specific limit

Accepts a pending trading permission, transitioning its status from Requested to Accepted. A trading permission authorizes a CTA (commodity trading advisor) to trade on an account holder’s behalf; accepting it is the step where the named CTA confirms the arrangement. Identify the permission with tradingPermissionId (the integer entity ID).

Only the CTA named on the permission can accept it — the request fails for any other caller. The permission must still be in Requested status; once it has moved to another status, it can no longer be accepted.

To find pending permissions and their IDs, query tradingPermissionList.

On success, the response returns the updated tradingPermission with its new status and an empty errorText. On a handled failure, the tradingPermission is still returned alongside a non-empty errorText describing the problem.

Common Failure Scenarios

  • The permission is no longer in Requested status, so it is too late to accept it.
  • The caller is not the CTA named on the permission (returns an access-denied error).
  • The tradingPermissionId doesn’t exist or isn’t accessible to the caller.
  • The access token is missing or invalid (returns HTTP 401).

Error Messages

errorTextTrigger
"It is too late, the status has been changed"The permission is no longer in Requested status.
Non-empty errorTextThe request failed; the field describes the reason.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.
tradingPermissionIdlongRequired

Response

TradingPermissionResponse
errorTextstringOptional<=8192 characters

Non-empty if the request failed

tradingPermissionobjectOptional