openapi: 3.0.1 info: title: Services.AutoTrading Account Values Balances API description: 'The AutoTrading service group provides endpoints for interacting with Saxo Bank''s SaxoSelect offering.Through these interfaces a client application can get Saxo Select trade leaders, portfolios and investments. Portfolio investments can be created and modifed.
Note:
This service is subject to special licensing agreements and not generally available to all OpenAPI applications.
' version: 2.4.138+710c760591 x-framework-version: 38.0.2+439c5b0ec3 x-machine: SIMOAWEB11-DK2 servers: - url: https://gateway.saxobank.com/sim/openapi tags: - name: Balances description: "Read-only endpoint serving client and account balances. The client or account balance is identified by the supplied ClientKey, AccountGroupKey or AccountKey. \n Access to balance data is further restricted by the access rights of the identity represented by the authorization token." paths: /port/v1/balances/subscriptions/{ContextId}/{ReferenceId}: delete: tags: - Balances summary: Remove subscription description: Removes subscription for the current session identified by subscription id. operationId: BalancesV1DeleteSubscription parameters: - name: ContextId in: path description: Unique streaming context ID part of the streaming session. required: true schema: type: string example: '29931122' - name: ReferenceId in: path description: Unique ID of the subscription required: true schema: type: string example: B345356 responses: '204': description: No Content '202': description: Subscription delete request will be processed eventually. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '503': $ref: '#/components/responses/ServiceUnavailable' '429': $ref: '#/components/responses/TooManyRequests' security: - OpenApiOAuthSecurityScheme: [] - OpenApiJWTSecurityScheme: [] x-required-permissions: personal: Subscribe community: Subscribe /port/v1/balances/subscriptions/{ContextId}: delete: tags: - Balances summary: Remove all subscriptions marked with a specific tag description: Removes multiple subscriptions for the current session on this resource and frees all resources on the server. operationId: BalancesV1DeleteSubscriptions parameters: - name: ContextId in: path description: Unique streaming context ID part of the streaming session. required: true schema: type: string example: '29931122' - name: Tag in: query description: Tag that subscriptions are marked with. schema: type: string example: PAGE1 responses: '204': description: No Content '202': description: Subscription delete request will be processed eventually. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '503': $ref: '#/components/responses/ServiceUnavailable' '429': $ref: '#/components/responses/TooManyRequests' security: - OpenApiOAuthSecurityScheme: [] - OpenApiJWTSecurityScheme: [] x-required-permissions: personal: Subscribe community: Subscribe /port/v1/balances/subscriptions: post: tags: - Balances summary: Create a subscription on a balance description: Sets up a subscription and returns an initial snapshot of a balance. operationId: BalancesV1AddActiveSubscription requestBody: content: application/json: schema: $ref: '#/components/schemas/BalanceSubscriptionRequest' example: Arguments: AccountGroupKey: null AccountKey: null ClientKey: 7m4I|vtYLUnEGg77o9uQhw== ContextId: '20221030064906306' ReferenceId: B49083 RefreshRate: 500 Tag: MyBalancesRelatedSubscriptions responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/BalanceSubscriptionResponse' example: ContextId: '20221030064906306' Format: application/json InactivityTimeout: 1500 ReferenceId: B49083 RefreshRate: 500 Snapshot: CalculationReliability: Ok CashAvailableForTrading: 100573853.73 CashBalance: 100573853.73 CashBlocked: 0 ChangesScheduled: false ClosedPositionsCount: 0 CollateralAvailable: 99839075.64 CorporateActionUnrealizedAmounts: 0 CostToClosePositions: -1677.57 Currency: EUR CurrencyDecimals: 0 InitialMargin: CollateralAvailable: 12254541.55 MarginAvailable: 12254541.55 MarginCollateralNotAvailable: 0 MarginUsedByCurrentPositions: -1225544.66 MarginUtilizationPct: 15.11 NetEquityForMargin: 1222521.77 OtherCollateralDeduction: 0 IntradayMarginDiscount: 0 IsPortfolioMarginModelSimple: true MarginAndCollateralUtilizationPct: 0.38 MarginAvailableForTrading: 99839075.64 MarginCollateralNotAvailable: -468419.84 MarginExposureCoveragePct: 344.35 MarginNetExposure: 29088391.02 MarginUsedByCurrentPositions: -326828.87 MarginUtilizationPct: 0.33 NetEquityForMargin: 85539075.64 NetPositionsCount: 0 NonMarginPositionsValue: 509207.41 OpenIpoOrdersCount: 0 OpenPositionsCount: 0 OptionPremiumsMarketValue: 0 OrdersCount: 0 OtherCollateral: 103798.26 SettlementValue: 0 ShareSpendingPower: 50 SpendingPower: 50 SpendingPowerDetail: Current: 50 Maximum: 50 SrdSpendingPower: 50 TotalValue: 100634324.36 TransactionsNotBooked: -118.71 TriggerOrdersCount: 0 UnrealizedMarginClosedProfitLoss: 0 UnrealizedMarginOpenProfitLoss: 0 UnrealizedMarginProfitLoss: -550738.76 UnrealizedPositionsValue: -43208.92 State: Active Tag: MyBalancesRelatedSubscriptions '400': description: Bad Request content: application/json: schema: required: - ErrorCode - Message type: object properties: ErrorCode: enum: - InvalidClientId - InvalidInput - InvalidModelState - NoValidInput - UnsupportedSubscriptionFormat type: string example: None x-enum-descriptions: InvalidModelState: Error code returned when model state is invalid. UnsupportedSubscriptionFormat: Error code returned when a subscription format that isn't supported by the publisher is requested. InvalidClientId: Indicates that the requested client id was invalid. InvalidInput: An error was encountered when processing given input parameters. NoValidInput: No valid input values passed. Message: type: string ModelState: $ref: '#/components/schemas/ModelStateDictionary' '409': description: Conflict content: application/json: schema: required: - ErrorCode - Message type: object properties: ErrorCode: enum: - SubscriptionLimitExceeded type: string example: None x-enum-descriptions: SubscriptionLimitExceeded: Error code returned when more than the maximum allowed number of subscriptions for a specified type, is exceeded. Message: type: string ModelState: $ref: '#/components/schemas/ModelStateDictionary' '401': $ref: '#/components/responses/Unauthorized' '503': $ref: '#/components/responses/ServiceUnavailable' '429': $ref: '#/components/responses/TooManyRequests' security: - OpenApiOAuthSecurityScheme: [] - OpenApiJWTSecurityScheme: [] x-required-permissions: personal: Subscribe community: Subscribe x-streaming-type: $ref: '#/components/schemas/BalanceResponse' /port/v1/balances/marginoverview: get: tags: - Balances summary: Get margin overview description: Get margin overview for a client, account group or an account operationId: BalancesV1GetMarginOverview parameters: - name: AccountGroupKey in: query description: The key of the account group for which the margin overview is returned schema: title: The key of the account group for which the margin overview is returned minLength: 1 type: string x-type-name: AccountGroupKey example: stringValue - name: AccountKey in: query description: The key of the account for which the margin overview is returned schema: title: The key of the account for which the margin overview is returned minLength: 1 type: string x-type-name: AccountKey example: 01b64edf-da03-4145-bf33-ae21527d4c86 - name: ClientKey in: query description: The key of the client for which the margin overview is returned required: true schema: title: The key of the client for which the margin overview is returned minLength: 1 type: string x-type-name: ClientKey example: 493b43a5-fe85-4d1f-9071-dd4a9d4e42a4 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MarginOverviewByGroup' example: Groups: - Contributors: - AssetTypes: - FxSpot InstrumentDescription: EURUSD description InstrumentSpecifier: EURUSD Margin: 1235 Uic: 21 - AssetTypes: - FxSpot InstrumentDescription: GBPUSD description InstrumentSpecifier: GBPUSD Margin: 789 Uic: 22 GroupType: FX TotalMargin: 100000 - Contributors: - AssetTypes: - CfdOnIndex InstrumentDescription: SP500 description InstrumentSpecifier: SP500.I Margin: 4321 Uic: 4910 - AssetTypes: - CfdOnIndex InstrumentDescription: CSE20 description InstrumentSpecifier: CSE20.I Margin: 975 Uic: 5768 - AssetTypes: - CfdOnIndex InstrumentDescription: DAX description InstrumentSpecifier: DAX.I Margin: 864 Uic: 27098 GroupType: CFDs TotalMargin: 200000 '400': description: Bad Request content: application/json: schema: required: - ErrorCode - Message type: object properties: ErrorCode: enum: - InvalidClientId - NoValidInput type: string example: None x-enum-descriptions: NoValidInput: No valid input values passed. InvalidClientId: Indicates that the requested client id was invalid. Message: type: string ModelState: $ref: '#/components/schemas/ModelStateDictionary' '401': $ref: '#/components/responses/Unauthorized' '503': $ref: '#/components/responses/ServiceUnavailable' '429': $ref: '#/components/responses/TooManyRequests' security: - OpenApiOAuthSecurityScheme: [] - OpenApiJWTSecurityScheme: [] x-required-permissions: personal: Read community: Read /port/v1/balances: get: tags: - Balances summary: Get balance description: Get balance data for a client, account group or an account operationId: GET_BalancesV1GetBalance parameters: - name: AccountGroupKey in: query description: The key of the account group for which the balance data is returned schema: title: The key of the account group for which the balance data is returned minLength: 1 type: string x-type-name: AccountGroupKey example: stringValue - name: AccountKey in: query description: The key of the account for which the balance data is returned schema: title: The key of the account for which the balance data is returned minLength: 1 type: string x-type-name: AccountKey example: 01b64edf-da03-4145-bf33-ae21527d4c86 - name: ClientKey in: query description: The key of the client for which the balance data is returned required: true schema: title: The key of the client for which the balance data is returned minLength: 1 type: string x-type-name: ClientKey example: 493b43a5-fe85-4d1f-9071-dd4a9d4e42a4 - name: FieldGroups in: query description: Specifies which data to return. schema: title: Specifies which data to return. type: array items: $ref: '#/components/schemas/BalanceFieldGroup' example: - MarginOverview responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BalanceResponse' example: CalculationReliability: Ok CashAvailableForTrading: 100573853.73 CashBalance: 100573853.73 CashBlocked: 0 ChangesScheduled: false ClosedPositionsCount: 0 CollateralAvailable: 99839075.64 CorporateActionUnrealizedAmounts: 0 CostToClosePositions: -1677.57 Currency: EUR CurrencyDecimals: 0 InitialMargin: CollateralAvailable: 12254541.55 MarginAvailable: 12254541.55 MarginCollateralNotAvailable: 0 MarginUsedByCurrentPositions: -1225544.66 MarginUtilizationPct: 15.11 NetEquityForMargin: 1222521.77 OtherCollateralDeduction: 0 IntradayMarginDiscount: 0 IsPortfolioMarginModelSimple: true MarginAndCollateralUtilizationPct: 0.38 MarginAvailableForTrading: 99839075.64 MarginCollateralNotAvailable: -468419.84 MarginExposureCoveragePct: 344.35 MarginNetExposure: 29088391.02 MarginUsedByCurrentPositions: -326828.87 MarginUtilizationPct: 0.33 NetEquityForMargin: 85539075.64 NetPositionsCount: 0 NonMarginPositionsValue: 509207.41 OpenIpoOrdersCount: 0 OpenPositionsCount: 0 OptionPremiumsMarketValue: 0 OrdersCount: 0 OtherCollateral: 103798.26 SettlementValue: 0 SpendingPowerDetail: Current: 50 Maximum: 50 TotalValue: 100634324.36 TransactionsNotBooked: -118.71 TriggerOrdersCount: 0 UnrealizedMarginClosedProfitLoss: 0 UnrealizedMarginOpenProfitLoss: 0 UnrealizedMarginProfitLoss: -550738.76 UnrealizedPositionsValue: -43208.92 '400': description: Bad Request content: application/json: schema: required: - ErrorCode - Message type: object properties: ErrorCode: enum: - InvalidClientId - NoValidInput type: string example: None x-enum-descriptions: NoValidInput: No valid input values passed. InvalidClientId: Indicates that the requested client id was invalid. Message: type: string ModelState: $ref: '#/components/schemas/ModelStateDictionary' '401': $ref: '#/components/responses/Unauthorized' '503': $ref: '#/components/responses/ServiceUnavailable' '429': $ref: '#/components/responses/TooManyRequests' security: - OpenApiOAuthSecurityScheme: [] - OpenApiJWTSecurityScheme: [] x-required-permissions: personal: Read community: Read /port/v1/balances/me: get: tags: - Balances summary: Get balance data for logged-in client description: Get balance data for logged-in client. operationId: BalancesV1GetBalance responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BalanceResponse' example: CalculationReliability: Ok CashAvailableForTrading: 100573853.73 CashBalance: 100573853.73 CashBlocked: 0 ChangesScheduled: false ClosedPositionsCount: 0 CollateralAvailable: 99839075.64 CorporateActionUnrealizedAmounts: 0 CostToClosePositions: -1677.57 Currency: EUR CurrencyDecimals: 0 InitialMargin: CollateralAvailable: 12254541.55 MarginAvailable: 12254541.55 MarginCollateralNotAvailable: 0 MarginUsedByCurrentPositions: -1225544.66 MarginUtilizationPct: 15.11 NetEquityForMargin: 1222521.77 OtherCollateralDeduction: 0 IntradayMarginDiscount: 0 IsPortfolioMarginModelSimple: true MarginAndCollateralUtilizationPct: 0.38 MarginAvailableForTrading: 99839075.64 MarginCollateralNotAvailable: -468419.84 MarginExposureCoveragePct: 344.35 MarginNetExposure: 29088391.02 MarginUsedByCurrentPositions: -326828.87 MarginUtilizationPct: 0.33 NetEquityForMargin: 85539075.64 NetPositionsCount: 0 NonMarginPositionsValue: 509207.41 OpenIpoOrdersCount: 0 OpenPositionsCount: 0 OptionPremiumsMarketValue: 0 OrdersCount: 0 OtherCollateral: 103798.26 SettlementValue: 0 SpendingPowerDetail: Current: 50 Maximum: 50 TotalValue: 100634324.36 TransactionsNotBooked: -118.71 TriggerOrdersCount: 0 UnrealizedMarginClosedProfitLoss: 0 UnrealizedMarginOpenProfitLoss: 0 UnrealizedMarginProfitLoss: -550738.76 UnrealizedPositionsValue: -43208.92 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '503': $ref: '#/components/responses/ServiceUnavailable' '429': $ref: '#/components/responses/TooManyRequests' security: - OpenApiOAuthSecurityScheme: [] - OpenApiJWTSecurityScheme: [] x-required-permissions: personal: Read community: Read components: schemas: BalanceSubscriptionRequest: title: Public request contract for setting up a subscription on a balance. required: - ContextId - ReferenceId type: object properties: ContextId: title: "The streaming context id that this request is associated with.\n This parameter must only contain letters (a-z) and numbers (0-9) as well as - (dash) and _ (underscore). It is case insensitive. Max length is 50 characters." pattern: ^[a-zA-Z0-9_-]{1,50}$ type: string example: ContextId-1 x-display-order: 1 ReferenceId: title: "Mandatory client specified reference id for the subscription.\n This parameter must only contain alphanumberic characters as well as - (dash) and _ (underscore). Cannot start with _. It is case insensitive. Max length is 50 characters." pattern: ^[a-zA-Z0-9-][a-zA-Z0-9_-]{0,49}$ type: string example: ReferenceId-1 x-display-order: 2 Arguments: title: Arguments for the subscription request. allOf: - $ref: '#/components/schemas/BalanceRequest' Format: title: "Optional Media type (RFC 2046) of the serialized data updates that are streamed to the client.\n Currently only application/json and application/x-protobuf is supported.\n If an unrecognized format is specified, the subscription end point will return HTTP status code 400 - Bad format." type: string example: application/json RefreshRate: title: "Optional custom refresh rate, measured in milliseconds, between each data update.\n Note that it is not possible to get a refresh rate lower than the rate specified in the\n customer service level agreement (SLA)." maximum: 2147483647 minimum: 0 type: integer format: int32 example: 0 ReplaceReferenceId: title: Reference id of the subscription that should be replaced. pattern: ^[a-zA-Z0-9-][a-zA-Z0-9_-]{0,49}$ type: string example: ReplaceReferenceId-1 Tag: title: Optional client specified tag used for grouping subscriptions. type: string example: ClientTag additionalProperties: false example: Arguments: AccountGroupKey: null AccountKey: null ClientKey: 7m4I|vtYLUnEGg77o9uQhw== ContextId: '20221030064906306' ReferenceId: B49083 RefreshRate: 500 Tag: MyBalancesRelatedSubscriptions InstrumentCollateralDetail: title: Instrument collateral detail type: object properties: AssetType: title: Instrument Asset type allOf: - $ref: '#/components/schemas/AssetType' Description: title: Instrument Description type: string example: stringValue InitialCollateral: title: Initial collateral available of the instrument type: number example: 10 InitialCollateralNotAvailable: title: Initial collateral not available of the instrument type: number example: 10 MaintenanceCollateral: title: Maintenance collateral available of the instrument type: number example: 10 MaintenanceCollateralNotAvailable: title: Maintenance collateral not available of the instrument type: number example: 10 MarketValue: title: Market value of the instrument type: number example: 10 Symbol: title: Instrument Symbol type: string example: stringValue Uic: title: Uic of the instrument type: integer format: int32 example: 99 additionalProperties: false example: AssetType: PortfolioNote Description: stringValue InitialCollateral: 10 InitialCollateralNotAvailable: 10 MaintenanceCollateral: 10 MaintenanceCollateralNotAvailable: 10 MarketValue: 10 Symbol: stringValue Uic: 99 BalanceRequest: title: Represents a request for the account balance for a specified Client, AccountGroup or Account. required: - ClientKey type: object properties: AccountGroupKey: title: The key of the account group for which the balance data is returned minLength: 1 type: string x-type-name: AccountGroupKey AccountKey: title: The key of the account for which the balance data is returned minLength: 1 type: string x-type-name: AccountKey ClientKey: title: The key of the client for which the balance data is returned minLength: 1 type: string x-type-name: ClientKey FieldGroups: title: Specifies which data to return. type: array items: $ref: '#/components/schemas/BalanceFieldGroup' additionalProperties: false example: AccountGroupKey: stringValue AccountKey: 01b64edf-da03-4145-bf33-ae21527d4c86 ClientKey: 493b43a5-fe85-4d1f-9071-dd4a9d4e42a4 FieldGroups: - MarginOverview MarginCollateralNotAvailableDetail: title: Detail of Margin Collateral Not Available type: object properties: InitialFxHaircut: title: Initial Fx Haircut type: number example: 10 InstrumentCollateralDetails: title: Instrument collateral collection type: array items: $ref: '#/components/schemas/InstrumentCollateralDetail' example: - AssetType: GuaranteeNote Description: stringValue InitialCollateral: 10 InitialCollateralNotAvailable: 10 MaintenanceCollateral: 10 MaintenanceCollateralNotAvailable: 10 MarketValue: 10 Symbol: stringValue Uic: 99 MaintenanceFxHaircut: title: Maintenance Fx Haircut type: number example: 10 additionalProperties: false example: InitialFxHaircut: 10 InstrumentCollateralDetails: - AssetType: CompanyWarrant Description: stringValue InitialCollateral: 10 InitialCollateralNotAvailable: 10 MaintenanceCollateral: 10 MaintenanceCollateralNotAvailable: 10 MarketValue: 10 Symbol: stringValue Uic: 99 MaintenanceFxHaircut: 10 MarginOverviewGroup: title: Margin utilization of the AssetType group as applied to the overall margin calculation. type: object properties: Contributors: title: Contributors are either a list of instruments or a single (anonymous) object representing implicitly aggregated contributors type: array items: $ref: '#/components/schemas/MarginOverviewContributor' example: - AssetTypes: - FxSpot InstrumentDescription: EURUSD description InstrumentSpecifier: EURUSD Margin: 1235 Uic: 21 GroupType: title: AssetType group - used by margin calculation. allOf: - $ref: '#/components/schemas/MarginOverviewGroupType' TotalMargin: title: Total margin impact of the group of instrument. type: number example: 10 additionalProperties: false example: Contributors: - AssetTypes: - FxSpot InstrumentDescription: EURUSD description InstrumentSpecifier: EURUSD Margin: 1235 Uic: 21 - AssetTypes: - FxSpot InstrumentDescription: GBPUSD description InstrumentSpecifier: GBPUSD Margin: 789 Uic: 22 GroupType: FX TotalMargin: 100000 TransactionsNotBookedDetail: title: Detail of transaction(s) that yet have to be booked. type: object properties: Accrual: title: Net accrual for the transaction(s) not booked yet type: number example: 10 AdditionalTransactionCost: title: Net additional transaction cost for the transaction(s) not booked yet type: number example: 10 BondValue: title: Net bond value for the transaction(s) not booked yet type: number example: 10 CashDeposit: title: Net cash deposit for the transaction(s) not booked yet type: number example: 10 CashReservation: title: Net cash reservation for the transaction(s) not booked yet type: number example: 10 CashWithdrawal: title: Net cash withdrawal for the transaction(s) not booked yet type: number example: 10 CertificatesValue: title: Net value of certificates for the transaction(s) not booked yet type: number example: 10 Commission: title: Net commission for the transaction(s) not booked yet type: number example: 10 ExchangeFee: title: Net exchange fee for the transaction(s) not booked yet type: number example: 10 ExternalCharges: title: Net external charges for the transaction(s) not booked yet type: number example: 10 FundsReservedByOrder: title: Net funds reserved by order for the transaction(s) not booked yet type: number example: 10 IpoSubscriptionFee: title: IPO subscription fee for the transaction(s) not booked yet type: number example: 10 LeveragedKnockOutProductsValue: title: Net value of leveraged knock-out products (Turbos) for the transaction(s) not booked yet. type: number example: 10 MutualFundValue: title: Net mutual fund value for the transaction(s) not booked yet type: number example: 10 OptionPremium: title: Net option premium for the transaction(s) not booked yet type: number example: 10 ShareValue: title: Net share value for the transaction(s) not booked yet type: number example: 10 StampDuty: title: Net stamp duty for the transaction(s) not booked yet type: number example: 10 WarrantPremium: title: Net warrant premium for the transaction(s) not booked yet type: number example: 10 additionalProperties: false example: Accrual: 10 AdditionalTransactionCost: 10 BondValue: 10 CashDeposit: 10 CashReservation: 10 CashWithdrawal: 10 CertificatesValue: 10 Commission: 10 ExchangeFee: 10 ExternalCharges: 10 FundsReservedByOrder: 10 IpoSubscriptionFee: 10 LeveragedKnockOutProductsValue: 10 MutualFundValue: 10 OptionPremium: 10 ShareValue: 10 StampDuty: 10 WarrantPremium: 10 CalculationReliability: title: To what extent can the calculated values and P/L be trusted enum: - ApproximatedPrice - CurrencyConversionFailed - FailedToCalculateCollateral - NoMarketAccess - Ok - OkWithConditions - PricePending - SystemError - UnknownPrice type: string example: UnknownPrice x-enum-descriptions: Ok: Ok - calculation successful UnknownPrice: Unknown price CurrencyConversionFailed: Currency conversion failed FailedToCalculateCollateral: Failed to calculate collateral OkWithConditions: Calculation was ok given some conditions PricePending: Calculation depends on a price that is currently unavailable. NoMarketAccess: No Market Access for price. SystemError: General error due to system or client configuration. ApproximatedPrice: Profit/loss calculated based on a synthetic non-market price. MarginOverviewContributor: title: Total margin impact by net position. type: object properties: AssetTypes: title: AssetTypes for this contributor. type: array items: $ref: '#/components/schemas/AssetType' example: - FxVanillaOption DisplayHint: title: Hint to the client application about how it should display the instrument. allOf: - $ref: '#/components/schemas/DisplayHintType' InstrumentDescription: title: Description of instrument. Not available for futures. type: string example: stringValue InstrumentSpecifier: title: Instrument identifier. Base contract for futures and symbol for other instruments. type: string example: stringValue Margin: title: Margin impact of the contributor type: number example: 10 Uic: title: Uic identifying the instrument, if any type: integer format: int32 example: 99 additionalProperties: false example: AssetTypes: - FxSpot InstrumentDescription: EURUSD description InstrumentSpecifier: EURUSD Margin: 1235 Uic: 21 MarginOverviewGroupType: title: Margin calculation category of AssetType. enum: - CFDs - FX - FuturesAndOptions - Other type: string example: CFDs x-enum-descriptions: CFDs: Margin impact of CFDs - presumably all categories FuturesAndOptions: Margin impact of future and option contract instruments FX: Margin impact of FX instruments Other: Margin overview group based on unspecified criteria AssetType: title: The possible AssetTypes for which you can get a quote or place an order or a trade. enum: - Bond - Cash - CertificateBonus - CertificateCappedBonus - CertificateCappedCapitalProtected - CertificateCappedOutperformance - CertificateConstantLeverage - CertificateDiscount - CertificateExpress - CertificateTracker - CertificateUncappedCapitalProtection - CertificateUncappedOutperformance - CfdIndexOption - CfdOnCompanyWarrant - CfdOnEtc - CfdOnEtf - CfdOnEtn - CfdOnFund - CfdOnFutures - CfdOnIndex - CfdOnRights - CfdOnStock - CompanyWarrant - ContractFutures - Etc - Etf - Etn - Fund - FuturesOption - FuturesStrategy - FxBinaryOption - FxForwards - FxKnockInOption - FxKnockOutOption - FxNoTouchOption - FxOneTouchOption - FxSpot - FxVanillaOption - GuaranteeNote - IpoOnStock - ManagedFund - MiniFuture - MutualFund - PortfolioNote - Rights - SrdOnEtf - SrdOnStock - Stock - StockIndex - StockIndexOption - StockOption - Warrant - WarrantDoubleKnockOut - WarrantKnockOut - WarrantOpenEndKnockOut - WarrantSpread type: string example: FxForwards x-enum-descriptions: FxSpot: Forex Spot. FxForwards: Forex Forward. FxVanillaOption: Forex Vanilla Option. FxKnockInOption: Forex Knock In Option. FxKnockOutOption: Forex Knock Out Option. FxBinaryOption: Forex Binary Option. FxOneTouchOption: Forex One Touch Option. FxNoTouchOption: Forex No Touch Option. ContractFutures: Contract Futures. FuturesStrategy: Futures Strategy. Stock: Stock. StockOption: Stock Option. Bond: Bond. FuturesOption: Futures Option. StockIndexOption: Stock Index Option. ManagedFund: 'Obsolete: Managed Fund.' Cash: Cash. Not tradeable! CfdOnStock: Cfd on Stock. CfdOnIndex: Cfd on Stock Index. CfdOnFutures: Cfd on Futures. StockIndex: Stock Index. MutualFund: Mutual Fund. CfdIndexOption: Cfd Index Option. CfdOnEtf: Cfd on Etf CfdOnEtc: Cfd on Etc CfdOnEtn: Cfd on Etn CfdOnFund: Cfd on Fund CfdOnRights: Cfd on Rights CfdOnCompanyWarrant: Cfd on unlisted warrant issued by a corporation. Etf: Exchange traded fund. Etc: Etc Etn: Etn Fund: Fund Rights: Rights Warrant: Warrant MiniFuture: MiniFuture. WarrantSpread: Warrant with built-in spread. WarrantKnockOut: Warrant with a knock-out barrier. WarrantOpenEndKnockOut: Knock-out Warrant with no expiry. WarrantDoubleKnockOut: Warrant with two knock-out barriers. CertificateUncappedCapitalProtection: Guarantees a percentage increase of the underlying asset's value above the issue price at expiry/maturity. Max loss is the amount invested multiplied by the CapitalProtection percentage. CertificateCappedCapitalProtected: Guarantees a capped percentage increase of the underlying asset's value above the issue price at expiry/maturity. Max loss is the amount invested multiplied by the CapitalProtection percentage. CertificateDiscount: Yields a capped return if the underlying asset's value is above the specified cap level at expiry. If the underlying's value is below the strike at expiry, the investor received the underlying or equivalent value. Offers direct exposure in underlying at a lower price (discount) with a capped potential profit and limited loss. CertificateCappedOutperformance: Capped Outperformance Certificate. CertificateCappedBonus: Certificate Capped Bonus. CertificateExpress: Certificate Express kick out. CertificateTracker: A certificate that mirrors the price movement of the underlying instrument. Often used to trade movements in indicies. Movements can be a fixed ratio of the underlying and can be inverted for bearish/short speculation. Risk is equivalent to owning the underlying. CertificateUncappedOutperformance: Provides leveraged returns when the underlying price exceeds the threshold strike price. The amount leverage is defined by the Participation %. When the underlying is below the strike price, the certificate mirrors the underlying price 1:1. CertificateBonus: Mirrors the price movement of the underlying only if and when the underlying price exceeds the defined barrier. If the certificate expires below the barrier, it offers partial protection/return of investment. CertificateConstantLeverage: Certificate Constant Leverage. SrdOnStock: SRD. (Service de Règlement Différé) on Stock. SrdOnEtf: SRD. (Service de Règlement Différé) on Etf. IpoOnStock: IPO on Stock CompanyWarrant: Unlisted warrant issued by a corporation, often physically settled. PortfolioNote: Danish pooled investment scheme (“Pulje”). Not online tradeable. GuaranteeNote: Danish investment scheme (“Grantbevis”). Not online tradeable. LineStatus: title: Describes the current utilization and size of a Credit, Risk or Trading line. type: object properties: Exposure: title: The current utilization of the credit line. type: number example: 10 Line: title: The maximum credit limit allowed. type: number example: 10 UtilizationPct: title: The current utilization of the credit line in proportion to the line limit. type: number example: 10 additionalProperties: false example: Exposure: 10 Line: 10 UtilizationPct: 10 MarginOverviewByGroup: title: Margin utilization for positions, broken down into groups of AssetTypes. type: object properties: Groups: title: List of AssetType groups with it's contributing positions and total margin utilization. type: array items: $ref: '#/components/schemas/MarginOverviewGroup' example: - Contributors: - AssetTypes: - FxSpot InstrumentDescription: EURUSD description InstrumentSpecifier: EURUSD Margin: 1235 Uic: 21 - AssetTypes: - FxSpot InstrumentDescription: GBPUSD description InstrumentSpecifier: GBPUSD Margin: 789 Uic: 22 GroupType: FX TotalMargin: 100000 additionalProperties: false example: Groups: - Contributors: - AssetTypes: - FxSpot InstrumentDescription: EURUSD description InstrumentSpecifier: EURUSD Margin: 1235 Uic: 21 - AssetTypes: - FxSpot InstrumentDescription: GBPUSD description InstrumentSpecifier: GBPUSD Margin: 789 Uic: 22 GroupType: FX TotalMargin: 100000 - Contributors: - AssetTypes: - CfdOnIndex InstrumentDescription: SP500 description InstrumentSpecifier: SP500.I Margin: 4321 Uic: 4910 - AssetTypes: - CfdOnIndex InstrumentDescription: CSE20 description InstrumentSpecifier: CSE20.I Margin: 975 Uic: 5768 - AssetTypes: - CfdOnIndex InstrumentDescription: DAX description InstrumentSpecifier: DAX.I Margin: 864 Uic: 27098 GroupType: CFDs TotalMargin: 200000 BalanceFieldGroup: title: Specification of fieldsets to include in results. enum: - CalculateCashForTrading - MarginOverview type: string example: CalculateCashForTrading x-enum-descriptions: MarginOverview: Include instrument margin utilization for positions on a client, account group or an account. CalculateCashForTrading: Calculates cash available for trading from all accounts. x-type-warning: FlaggableEnum BalanceSubscriptionResponse: title: Public response contract returned after setting up a subscription on accounts. type: object properties: ContextId: title: The streaming context id that this response is associated with. type: string example: ContextId-1 x-display-order: 1 ReferenceId: title: The reference id that (along with streaming context id and session id) identifies the subscription (within the context of a specific service/subscription type) type: string example: ReferenceId-1 x-display-order: 2 Format: title: The media type (RFC 2046), of the serialized data updates that are streamed to the client. type: string example: application/json InactivityTimeout: title: The time (in seconds) that the client should accept the subscription to be inactive before considering it invalid. type: integer format: int32 example: 0 RefreshRate: title: Actual refresh rate assigned to the subscription according to the customers SLA. type: integer format: int32 example: 0 Snapshot: title: Snapshot of the current data on hand, when subscription was created. allOf: - $ref: '#/components/schemas/BalanceResponse' State: title: The value "Active". type: string description: This property is kept for backwards compatibility. example: Active Tag: title: Client specified tag assigned to the subscription, if specified in the request. type: string example: ClientTag additionalProperties: false example: ContextId: '20221030064906306' Format: application/json InactivityTimeout: 1500 ReferenceId: B49083 RefreshRate: 500 Snapshot: CalculationReliability: Ok CashAvailableForTrading: 100573853.73 CashBalance: 100573853.73 CashBlocked: 0 ChangesScheduled: false ClosedPositionsCount: 0 CollateralAvailable: 99839075.64 CorporateActionUnrealizedAmounts: 0 CostToClosePositions: -1677.57 Currency: EUR CurrencyDecimals: 0 InitialMargin: CollateralAvailable: 12254541.55 MarginAvailable: 12254541.55 MarginCollateralNotAvailable: 0 MarginUsedByCurrentPositions: -1225544.66 MarginUtilizationPct: 15.11 NetEquityForMargin: 1222521.77 OtherCollateralDeduction: 0 IntradayMarginDiscount: 0 IsPortfolioMarginModelSimple: true MarginAndCollateralUtilizationPct: 0.38 MarginAvailableForTrading: 99839075.64 MarginCollateralNotAvailable: -468419.84 MarginExposureCoveragePct: 344.35 MarginNetExposure: 29088391.02 MarginUsedByCurrentPositions: -326828.87 MarginUtilizationPct: 0.33 NetEquityForMargin: 85539075.64 NetPositionsCount: 0 NonMarginPositionsValue: 509207.41 OpenIpoOrdersCount: 0 OpenPositionsCount: 0 OptionPremiumsMarketValue: 0 OrdersCount: 0 OtherCollateral: 103798.26 SettlementValue: 0 ShareSpendingPower: 50 SpendingPower: 50 SpendingPowerDetail: Current: 50 Maximum: 50 SrdSpendingPower: 50 TotalValue: 100634324.36 TransactionsNotBooked: -118.71 TriggerOrdersCount: 0 UnrealizedMarginClosedProfitLoss: 0 UnrealizedMarginOpenProfitLoss: 0 UnrealizedMarginProfitLoss: -550738.76 UnrealizedPositionsValue: -43208.92 State: Active Tag: MyBalancesRelatedSubscriptions ModelStateDictionary: type: object additionalProperties: type: array items: type: string InitialMarginResponse: title: The calculation entity's initial margin (purchasing power) status. type: object properties: CollateralAvailable: title: Sum of collateral from positions, cash, collateral credit and other holdings available for opening new positions. type: number example: 10 MarginAvailable: title: Margin available for opening new positions. Initial margin available. type: number example: 10 MarginUsedByCurrentPositions: title: Sum of initial margin currently reserved. type: number example: 10 MarginUtilizationPct: title: Level of margin already utilized in percent. I.e. the ratio between the margin collateral used and the total available margin collateral. Indicates distance to margin calls. type: number example: 10 NetEquityForMargin: title: Value used as basis to calculate initial margin available. type: number example: 10 OtherCollateralDeduction: title: Other Collateral Deduction derived from regulatory contributors margin value. type: number example: 10 additionalProperties: false example: CollateralAvailable: 10 MarginAvailable: 10 MarginUsedByCurrentPositions: 10 MarginUtilizationPct: 10 NetEquityForMargin: 10 OtherCollateralDeduction: 10 SpendingPower: title: Describes the spending power. type: object properties: Current: title: The current spending power available. type: number example: 10 Maximum: title: Spending power for shares / ETF (based on max collateral factor defined for shares) type: number example: 10 additionalProperties: false example: Current: 10 Maximum: 10 DisplayHintType: title: Display Hint Type. enum: - Continuous - CryptoCurrencies - Etc - Etf - Etn - Forex - Fund - Interests - None - PreciousMetal - Rights - StockIndices - Warrant type: string example: Continuous x-enum-descriptions: None: Indicates not special display hint is required. PreciousMetal: Metals like XAUUSD. Continuous: Used for the parent ContractFutures. Etf: Exchange Traded Funds. Etn: Exchange Traded Notes. Etc: Exchange Traded Certificates/Currencies. Rights: Rights. Warrant: Warrants. Forex: Forex. Intended to be used for Cfds on Futures on Forex. Interests: Interest rates. Intended to be used for Cfds on Futures on bonds. StockIndices: Stock indices. Intended to be used for Cfds on Futures on stock indices. Fund: Fund. CryptoCurrencies: Crypto currencies. BalanceResponse: title: Data contract for account or client balance type: object properties: AccountFundingLimit: title: Account funding limit. This field is available for TaxSaving AccountType and FrancePea and FrancePeaPme SubAccountTypes. type: number example: 10 AccountNetFundedAmount: title: Account funding limit. This field is available for TaxSaving AccountType and FrancePea and FrancePeaPme SubAccountTypes. type: number example: 10 AccountRemainingFunding: title: Account Remaining Funding. This field is available for TaxSaving and Pension AccountTypes, and FrancePea and FrancePeaPme SubAccountTypes. type: number example: 10 AccountValueProtectionLimit: title: If set, this value shields the account/client value from going below the given limit by automatically triggering closing of open positions should the limit be exceeded. A limit of zero means there is no limit. type: number example: 10 CalculationReliability: title: In case an error was encountered while computing balances, this field indicates the source of the calculation error. allOf: - $ref: '#/components/schemas/CalculationReliability' CashAvailableForTrading: title: Cash available for trading for the current account/client. type: number example: 10 CashBalance: title: Current cash balance of the account/client. type: number example: 10 CashBlocked: title: Cash blocked for the current account/client. type: number example: 10 ChangesScheduled: title: True if there are scheduled changes to margin, collateral or rating changes. type: boolean example: true ClosedPositionsCount: title: Number of current closed positions. type: integer format: int32 example: 99 CollateralAvailable: title: Sum of collateral from positions, cash, collateral credit and other holdings available to maintain positions. type: number example: 10 CollateralCreditLine: title: The utilization state and maximum collateral credit line limit. allOf: - $ref: '#/components/schemas/LineStatus' CollateralCreditValue: title: The utilization state and maximum collateral credit value. allOf: - $ref: '#/components/schemas/LineStatus' CollateralLoan: title: Size of loan secured by collateral type: number example: 10 CorporateActionUnrealizedAmounts: title: Corporate Action Unrealized Amounts. type: number example: 10 CostToClosePositions: title: Estimated costs payable if all position where to be closed on the account/client. The provided value is negative for costs charged to the account. type: number example: 10 CreditLine: title: The utilization state and maximum credit limit. allOf: - $ref: '#/components/schemas/LineStatus' Currency: title: Currency of the Account, AccountGroup, or Client, depending on the selected entity for which balances are requested. All values provided in this response are denominated in this currency unless otherwise specified. type: string example: stringValue CurrencyDecimals: title: 'Number of decimals used to represent values in this currency. For most common currency denominations this value will be: 2.' type: integer format: int32 example: 99 FundsAvailableForSettlement: title: Funds available for trades settling today. type: number example: 10 FundsReservedForSettlement: title: Funds reserved for trades settling today at market opening. type: number example: 10 InitialMargin: title: If set, this represents the calculation entity's initial margin (purchasing power). allOf: - $ref: '#/components/schemas/InitialMarginResponse' IntradayMarginDiscount: title: Margin credited for unnetted positions closed intraday type: number example: 10 IsPortfolioMarginModelSimple: title: True if the given client/account is on simple margining. F.ex. Used to indicate if the account supports close all positions. Typically this means the client has a single account or single account margining and no settlement accounts. As well as no Fx Forwards/Options, listed options or Futures using advanced margining methods. type: boolean example: true MarginAndCollateralUtilizationPct: title: Level of margin already utilized in percent. I.e. the ratio between the margin collateral used and the total available margin collateral. Indicates distance to margin calls. type: number example: 10 MarginAvailableForTrading: title: Margin available for trading. The amount of remaining collateral available for margin trading for the account/client. type: number example: 10 MarginCollateralNotAvailable: title: Current collateral deduction of unrealized positions. type: number example: 10 MarginCollateralNotAvailableDetail: title: Detail of MarginCollateralNotAvailable allOf: - $ref: '#/components/schemas/MarginCollateralNotAvailableDetail' MarginExposureCoveragePct: title: Percentage of total margin exposure to total collateral. I.e. the ratio between the Account Value and the Net Exposure. If account exposure is 0, the coverage percent is also returned as 0. type: number example: 10 MarginNetExposure: title: Total net exposure of margin traded positions across all instruments. type: number example: 10 MarginOverview: title: Instrument margin utilization for positions. allOf: - $ref: '#/components/schemas/MarginOverviewByGroup' MarginUsedByCurrentPositions: title: Sum of maintenance margin used for current positions on the account/client. The provided value is negative for any margin that is charged to the available margin on the account/client. type: number example: 10 MarginUtilizationPct: title: Level of margin already utilized in percent. I.e. the ratio between the margin collateral used and the total available margin collateral. Indicates distance to margin calls. type: number example: 10 NetEquityForMargin: title: Value used as basis to calculate maintinance margin. It is calculated as TotalValue plus pending settlements (funds awaiting settlement for partners), minus MarginCollateralNotAvailable. type: number example: 10 NetPositionsCount: title: Number of current open net positions. type: integer format: int32 example: 99 NonMarginPositionsValue: title: Sum of MarketValue for all non-margin instruments held in the account/by the client. type: number example: 10 OpenIpoOrdersCount: title: Open Ipo order(s) count type: integer format: int32 example: 99 OpenPositionsCount: title: Number of current open positions. type: integer format: int32 example: 99 OptionPremiumsMarketValue: title: Combined market value of premium for all options, both FX and Contract Options. type: number example: 10 OrdersCount: title: Number of current open orders. type: integer format: int32 example: 99 OtherCollateral: title: Indicates the value of securities that have been deposited as collateral for margin. type: number example: 10 OtherCollateralDeduction: title: Other Collateral Deduction derived from regulatory contributor margin value. type: number example: 10 SettlementLine: title: The utilization state and maximum settlement credit limit. allOf: - $ref: '#/components/schemas/LineStatus' SettlementValue: title: Net current settlement value, long and short positions combined. type: number example: 10 SpendingPowerDetail: title: Available spending power on the account/client. allOf: - $ref: '#/components/schemas/SpendingPower' TotalRiskLine: title: The utilization state and risk credit limit. allOf: - $ref: '#/components/schemas/LineStatus' TotalValue: title: Current value of unrealized positions incl. costs, cash balance and transactions not booked. type: number example: 10 TradingLine: title: The utilization state and maximum trading credit limit. allOf: - $ref: '#/components/schemas/LineStatus' TransactionsNotBooked: title: Value of transactions that have yet to be booked to the account/client. type: number example: 10 TransactionsNotBookedDetail: title: Detail of transaction(s) that yet have to be booked to the account/client. allOf: - $ref: '#/components/schemas/TransactionsNotBookedDetail' TriggerOrdersCount: title: Number of current open trigger orders. type: integer format: int32 example: 99 UnrealizedMarginClosedProfitLoss: title: ProfitLoss on all closed (netting and explicit) part of positions (Intraday netting specific). type: number example: 10 UnrealizedMarginOpenProfitLoss: title: ProfitLoss on open part of positions (Intraday netting specific). type: number example: 10 UnrealizedMarginProfitLoss: title: Sum of profit/loss ex. costs for all margin instruments held in the account/by the client. type: number example: 10 UnrealizedPositionsValue: title: The current unrealized profit/loss and face value of all positions excl. costs. type: number example: 10 VariationMargin: title: The change in value of unrealized derivatives positions since opening them. type: number example: 10 VariationMarginCashBalance: title: Cash amount withdrawn from unrealized derivatives positions (VariationMargin). type: number example: 10 VariationMarginThreshold: title: Maximmum amount that may be withdrawn from unrealized derivatives positions (VariationMargin). type: number example: 10 additionalProperties: false example: CalculationReliability: Ok CashAvailableForTrading: 100573853.73 CashBalance: 100573853.73 CashBlocked: 0 ChangesScheduled: false ClosedPositionsCount: 0 CollateralAvailable: 99839075.64 CorporateActionUnrealizedAmounts: 0 CostToClosePositions: -1677.57 Currency: EUR CurrencyDecimals: 0 InitialMargin: CollateralAvailable: 12254541.55 MarginAvailable: 12254541.55 MarginCollateralNotAvailable: 0 MarginUsedByCurrentPositions: -1225544.66 MarginUtilizationPct: 15.11 NetEquityForMargin: 1222521.77 OtherCollateralDeduction: 0 IntradayMarginDiscount: 0 IsPortfolioMarginModelSimple: true MarginAndCollateralUtilizationPct: 0.38 MarginAvailableForTrading: 99839075.64 MarginCollateralNotAvailable: -468419.84 MarginExposureCoveragePct: 344.35 MarginNetExposure: 29088391.02 MarginUsedByCurrentPositions: -326828.87 MarginUtilizationPct: 0.33 NetEquityForMargin: 85539075.64 NetPositionsCount: 0 NonMarginPositionsValue: 509207.41 OpenIpoOrdersCount: 0 OpenPositionsCount: 0 OptionPremiumsMarketValue: 0 OrdersCount: 0 OtherCollateral: 103798.26 SettlementValue: 0 SpendingPowerDetail: Current: 50 Maximum: 50 TotalValue: 100634324.36 TransactionsNotBooked: -118.71 TriggerOrdersCount: 0 UnrealizedMarginClosedProfitLoss: 0 UnrealizedMarginOpenProfitLoss: 0 UnrealizedMarginProfitLoss: -550738.76 UnrealizedPositionsValue: -43208.92 responses: ServiceUnavailable: description: Service Unavailable. Unauthorized: description: Indicates that the request was rejected because the 'Authorization' header was missing in the request or contained an invalid security token. TooManyRequests: description: The request was rejected due to rate limit being exceeded. BadRequest: description: One or more of the provided parameters are invalid. content: application/json: schema: required: - ErrorCode - Message type: object properties: ErrorCode: enum: - InvalidRequest type: string example: None x-enum-descriptions: InvalidRequest: Default error code returned when it cannot be determined which part of the request is malformed. Message: type: string ModelState: $ref: '#/components/schemas/ModelStateDictionary' securitySchemes: OpenApiJWTSecurityScheme: type: http scheme: bearer bearerFormat: JWT OpenApiOAuthSecurityScheme: type: oauth2 flows: authorizationCode: authorizationUrl: https://sim.logonvalidation.net/authorize tokenUrl: https://sim.logonvalidation.net/token scopes: {}