OANDA · Schema
Position
The specification of a Position within an Account.
ForexFX TradingCFD TradingFinancial-ServicesTrading APIs
Properties
| Name | Type | Description |
|---|---|---|
| instrument | string | The Position's Instrument. |
| pl | string | Profit/loss realized by the Position over the lifetime of the Account. |
| unrealizedPL | string | The unrealized profit/loss of all open Trades that contribute to this Position. |
| marginUsed | string | Margin currently used by the Position. |
| resettablePL | string | Profit/loss realized by the Position since the Account's resettablePL was last reset by the client. |
| financing | string | The total amount of financing paid/collected for this instrument over the lifetime of the Account. |
| commission | string | The total amount of commission paid for this instrument 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 for this instrument. |
| long | object | |
| short | object |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Position",
"description": "The specification of a Position within an Account.",
"type": "object",
"properties": {
"instrument": {
"type": "string",
"description": "The Position's Instrument.",
"format": "A string containing the base currency and quote currency delimited by a \"_\"."
},
"pl": {
"type": "string",
"description": "Profit/loss realized by the Position 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 Position.",
"format": "A decimal number encoded as a string. The amount of precision provided depends on the Account's home currency."
},
"marginUsed": {
"type": "string",
"description": "Margin currently used by the Position.",
"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 Position 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 instrument 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."
},
"commission": {
"type": "string",
"description": "The total amount of commission paid for this instrument 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 for this instrument.",
"format": "A decimal number encoded as a string. The amount of precision provided depends on the Account's home currency."
},
"long": {
"$ref": "#/definitions/PositionSide"
},
"short": {
"$ref": "#/definitions/PositionSide"
}
}
}
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/Position"
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.