OANDA · Schema
PositionSide
The representation of a Position for a single direction (long or short).
ForexFX TradingCFD TradingFinancial-ServicesTrading APIs
Properties
| Name | Type | Description |
|---|---|---|
| units | string | Number of units in the position (negative value indicates short position, positive indicates long position). |
| averagePrice | string | Volume-weighted average of the underlying Trade open prices for the Position. |
| tradeIDs | array | List of the open Trade IDs which contribute to the open Position. |
| pl | string | Profit/loss realized by the PositionSide over the lifetime of the Account. |
| unrealizedPL | string | The unrealized profit/loss of all open Trades that contribute to this PositionSide. |
| resettablePL | string | Profit/loss realized by the PositionSide since the Account's resettablePL was last reset by the client. |
| financing | string | The total amount of financing paid/collected for this PositionSide over the lifetime of the Account. |
| guaranteedExecutionFees | string | The total amount of fees charged over the lifetime of the Account for the execution of guaranteed Stop Loss Orders attached to Trades for this PositionSide. |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "PositionSide",
"description": "The representation of a Position for a single direction (long or short).",
"type": "object",
"properties": {
"units": {
"type": "string",
"description": "Number of units in the position (negative value indicates short position, positive indicates long position).",
"format": "A decimal number encoded as a string. The amount of precision provided depends on what the number represents."
},
"averagePrice": {
"type": "string",
"description": "Volume-weighted average of the underlying Trade open prices for the Position.",
"format": "A decimal number encodes as a string. The amount of precision provided depends on the Instrument."
},
"tradeIDs": {
"type": "array",
"description": "List of the open Trade IDs which contribute to the open Position.",
"items": {
"type": "string",
"description": "The Trade's identifier, unique within the Trade's Account.",
"format": "The string representation of the OANDA-assigned TradeID. OANDA-assigned TradeIDs are positive integers, and are derived from the TransactionID of the Transaction that opened the Trade."
}
},
"pl": {
"type": "string",
"description": "Profit/loss realized by the PositionSide over the lifetime of the Account.",
"format": "A decimal number encoded as a string. The amount of precision provided depends on the Account's home currency."
},
"unrealizedPL": {
"type": "string",
"description": "The unrealized profit/loss of all open Trades that contribute to this PositionSide.",
"format": "A decimal number encoded as a string. The amount of precision provided depends on the Account's home currency."
},
"resettablePL": {
"type": "string",
"description": "Profit/loss realized by the PositionSide since the Account's resettablePL was last reset by the client.",
"format": "A decimal number encoded as a string. The amount of precision provided depends on the Account's home currency."
},
"financing": {
"type": "string",
"description": "The total amount of financing paid/collected for this PositionSide over the lifetime of the Account.",
"format": "A decimal number encoded as a string. The amount of precision provided depends on the Account's home currency."
},
"guaranteedExecutionFees": {
"type": "string",
"description": "The total amount of fees charged over the lifetime of the Account for the execution of guaranteed Stop Loss Orders attached to Trades for this PositionSide.",
"format": "A decimal number encoded as a string. The amount of precision provided depends on the Account's home currency."
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/PositionSide"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.