Exness Trade equity, positions and KYC fields
Exness Trade: Online Trading is Exness Global Limited's Android forex and CFD trading app. Retail traders can sign in with email or Google, open Standard, Pro or demo accounts, and use the Exness Terminal or MetaTrader 4 and 5. Live charts, market and pending orders, stop-loss, take-profit and trailing stops sit alongside account controls for leverage and execution mode. The app also supports identity and economic-profile verification, deposits and withdrawals, an economic calendar, copy trading, and reviews of stop-out events, swap-free status and dividend adjustments. It serves traders in Thailand, Indonesia and India, with account management and trade monitoring in the same mobile experience.
Margin headroom connects the app's account snapshots to its trade records: balance, equity, freeMargin and floating sit beside the account number, isReal, platform and leverage. Open trades add ticket, symbol, volume, openPrice, sl, tp and profit; closed records add closePrice, closeReason and dealId. Instrument entries supply baseCurrency, quoteCurrency and digits, while quote records carry bid, ask, bidHigh and askHigh.
Verification records pair kyc_status and kycProfile with has_economic_profile; margin close-out records associate stopOutId, equity, marginLevel and customStopOutValue with the affected tickets. Bookkeeping integrations can reconcile account equity, verification workflows can track outstanding identity steps, and risk teams can relate stop-outs to margin conditions. Research tools can join instrument metadata to bid/ask observations. openData Studio turns these account, trading and verification records into callable open data for authorized integrations.
Screenshots
API surface
The endpoints and request/response examples below are reconstructed from the app's interface — illustrative, not a live capture.
Email login
POST
/v1/session/startosintSigns the trader in with email and password, returning accessToken, refreshToken and the session profile, including entityName, country, currency and isDemo.
Auth: Unauthenticated. The JSON body supplies email and password; accessToken authorizes later requests through Authorization: Bearer, and refreshToken renews the session.
- password
- accessToken
- refreshToken
- id
- name
- country
- currency
- entityName
- securityType
- isDemo
- partnerId
- fakeEmail
POST /v1/session/start HTTP/1.1 Content-Type: application/json { "email": "[email protected]", "password": "<password>" }{ "accessToken": "<access_token>", "refreshToken": "<refresh_token>", "id": "prf_8f21", "email": "[email protected]", "name": "Arun S.", "country": "TH", "currency": "USD", "entityName": "Exness (SC) Ltd", "securityType": "password", "isDemo": false, "partnerId": null, "fakeEmail": null }Trader profile
GET
/v1/trader-cardosintLoads the signed-in trader profile, including entityName, country, kycProfile and kyc_status for the personal profile and verification screens.
Auth: Authorization: Bearer accessToken from the email sign-in session.
- profileId
- name
- country
- currency
- entityName
- partnerId
- isDemo
- kycProfile
- kyc_status
- kycThresholdValue
- has_economic_profile
GET /v1/trader-card HTTP/1.1 Authorization: Bearer <accessToken>{ "profileId": "prf_8f21", "email": "[email protected]", "name": "Arun S.", "country": "TH", "currency": "USD", "entityName": "Exness (SC) Ltd", "partnerId": null, "isDemo": false, "kycProfile": "verified", "kyc_status": "passed", "kycThresholdValue": 10000, "has_economic_profile": true }Trading accounts list
GET
/v1/account-overviewopenbankingLists the profile's trading accounts with balance, equity, freeMargin, leverage and platform for the account cards.
Auth: Authorization: Bearer accessToken. Results are scoped to the signed-in profileId.
- number
- profileId
- name
- balance
- equity
- freeMargin
- floating
- isReal
- currency
- status
- type
- platform
- leverage
- requestedLeverage
- maxLeverage
- server
- region
- serverCode
- customStopOutValue
- customStopOutEnabled
- executionMode
- commissionPerLotFrom
- spreadFrom
GET /v1/account-overview HTTP/1.1 Authorization: Bearer <accessToken>{ "accounts": [ { "number": "12345678", "profileId": "prf_8f21", "name": "Standard USD", "balance": 12500.4, "equity": 12610.15, "freeMargin": 11840.2, "floating": 109.75, "isReal": true, "currency": "USD", "status": "active", "type": "standard", "platform": "exness", "leverage": 2000, "requestedLeverage": 2000, "maxLeverage": 2000, "server": "Exness-MT5Real", "region": "asia", "serverCode": "mt5real", "customStopOutValue": 0.0, "customStopOutEnabled": false, "executionMode": 0, "commissionPerLotFrom": 0.0, "spreadFrom": 0.0 } ] }Open positions
GET
/v1/trade-book/open-itemsopenfinanceReturns open positions for the selected account, including ticket, symbol, volume, sl, tp and floating profit for the trade view.
Auth: Authorization: Bearer accessToken. Query is scoped to the selected account number.
- ticket
- accountNumber
- symbol
- type
- volume
- openPrice
- price
- sl
- tp
- hasTrailingStop
- swap
- commission
- profit
- openTime
- comment
GET /v1/trade-book/open-items?accountNumber=12345678 HTTP/1.1 Authorization: Bearer <accessToken>{ "positions": [ { "ticket": 88451233, "accountNumber": "12345678", "symbol": "EURUSD", "type": 0, "volume": 0.5, "openPrice": 1.08421, "price": 1.0851, "sl": 1.0800, "tp": 1.0900, "hasTrailingStop": false, "swap": -1.12, "commission": 0.0, "profit": 44.5, "openTime": 1729084800, "comment": "" } ] }Position history
GET
/v1/trade-book/closed-itemsopenfinancePages closed positions with closePrice, closeTime, equity at close and closeReason for statements and trading history.
Auth: Authorization: Bearer accessToken. Query is scoped to the selected account number.
- ticket
- accountNumber
- symbol
- type
- volume
- openPrice
- closePrice
- sl
- tp
- hasTrailingStop
- swap
- commission
- profit
- openTime
- closeTime
- equity
- marginLevel
- closeReason
- dealId
GET /v1/trade-book/closed-items?accountNumber=12345678 HTTP/1.1 Authorization: Bearer <accessToken>{ "positions": [ { "ticket": 88450001, "accountNumber": "12345678", "symbol": "XAUUSD", "type": 1, "volume": 0.1, "openPrice": 2645.2, "closePrice": 2651.8, "sl": 2630.0, "tp": 2660.0, "hasTrailingStop": true, "swap": -0.4, "commission": 0.0, "profit": 66.0, "openTime": 1728900000, "closeTime": 1728986400, "equity": 12580.0, "marginLevel": 842.5, "closeReason": 0, "dealId": 99120011 } ] }Working and history orders
GET
/v1/order-book/recordsopenfinanceLists pending and filled orders with ticket, type, price, sl, tp and state for the order ticket and history views.
Auth: Authorization: Bearer accessToken. Query is scoped to the selected account number.
- ticket
- accountNumber
- symbol
- type
- price
- volume
- sl
- tp
- hasTrailingStop
- state
- comment
- openTime
GET /v1/order-book/records?accountNumber=12345678 HTTP/1.1 Authorization: Bearer <accessToken>{ "orders": [ { "ticket": 88451240, "accountNumber": "12345678", "symbol": "GBPUSD", "type": 2, "price": 1.3015, "volume": 0.2, "sl": 1.2950, "tp": 1.3100, "hasTrailingStop": false, "state": 1, "comment": "buy_limit", "openTime": 1729088400 } ] }Instrument catalog
GET
/v1/market-catalogopendataReturns tradeable symbols with baseCurrency, quoteCurrency and digits for the watchlist and instrument details.
Auth: Authorization: Bearer accessToken.
- symbol
- international
- description
- category
- baseCurrency
- quoteCurrency
- digits
GET /v1/market-catalog HTTP/1.1 Authorization: Bearer <accessToken>{ "instruments": [ { "symbol": "EURUSD", "international": "EUR/USD", "description": "Euro vs US Dollar", "category": "forex", "baseCurrency": "EUR", "quoteCurrency": "USD", "digits": 5 } ] }Quote ticks
GET
/v1/price-feed/streamopendataStreams bid and ask prices with session highs and lows for the terminal chart and order ticket.
Auth: Authorization: Bearer accessToken. Streaming quote channel for subscribed symbols.
- symbol
- bid
- ask
- bidHigh
- bidLow
- askHigh
- askLow
GET /v1/price-feed/stream?symbol=EURUSD HTTP/1.1 Authorization: Bearer <accessToken>{ "symbol": "EURUSD", "bid": 1.08505, "ask": 1.08509, "bidHigh": 1.0864, "bidLow": 1.0831, "askHigh": 1.08644, "askLow": 1.08314 }Equity monitoring stats
GET
/v1/account-metrics/equity-snapshotsopenbankingReturns equity measurements, including live_equity_hot, live_equity_cold, equityUSD and equity_time_ms, for account performance charts.
Auth: Authorization: Bearer accessToken. Scoped to the selected account number.
- equity
- equityUSD
- equity_time_ms
- live_equity_hot
- live_equity_cold
- summary_equity
GET /v1/account-metrics/equity-snapshots?accountNumber=12345678 HTTP/1.1 Authorization: Bearer <accessToken>{ "equity": 12610.15, "equityUSD": 12610.15, "equity_time_ms": 1729084900123, "live_equity_hot": 12612.4, "live_equity_cold": 12598.0, "summary_equity": 12610.15 }KYC status
GET
/v1/verification/progressosintReads verification progress, including kyc_status, kycProfile and operations such as ProofOfIdentity and EconomicProfile, for the identity wizard.
Auth: Authorization: Bearer accessToken.
- kyc_status
- kyc_passed
- kycProfile
- kycThresholdValue
- has_economic_profile
- operations
GET /v1/verification/progress HTTP/1.1 Authorization: Bearer <accessToken>{ "kyc_status": "passed", "kyc_passed": true, "kycProfile": "verified", "kycThresholdValue": 10000, "has_economic_profile": true, "operations": [ "ProofOfIdentity", "PersonalInfo", "EconomicProfile", "Email", "Phone", "Docs" ] }Stop-out event detail
GET
/v1/margin-events/{stopOutId}openfinanceLoads a stop-out event with stopOutId, equity, marginLevel and affected tickets for the margin close-out summary.
Auth: Authorization: Bearer accessToken.
- stopOutId
- accountNumber
- equity
- marginLevel
- customStopOutValue
- customStopOutEnabled
- tickets
GET /v1/margin-events/so_4412 HTTP/1.1 Authorization: Bearer <accessToken>{ "stopOutId": "so_4412", "accountNumber": "12345678", "equity": 210.4, "marginLevel": 18.2, "customStopOutValue": 0.0, "customStopOutEnabled": false, "tickets": [88451233, 88451218] }Dividend adjustments
GET
/v1/cash-adjustments/recordsopendataLists the trader's dividend adjustments applied to CFD stock positions.
Auth: Authorization: Bearer accessToken.
- symbol
- accountNumber
- volume
- profit
- openTime
GET /v1/cash-adjustments/records HTTP/1.1 Authorization: Bearer <accessToken>{ "adjustments": [ { "symbol": "AAPL", "accountNumber": "12345678", "volume": 1.0, "profit": 4.25, "openTime": 1728604800 } ] }
Data categories
- balances
- positions
- orders
- quotes
- instruments
- kyc
Where teams use this data
Equity vs free-margin reconciliation
A bookkeeping bot pulls wallets-manager accounts (balance, equity, freeMargin, floating) and matches monitoring equityUSD / live_equity_hot so Standard and demo logins stay on one ledger.
KYC gate before payout
A withdrawals desk reads kyc_status, kycProfile and has_economic_profile, then only releases cash-out when ProofOfIdentity and EconomicProfile operations are complete.
Stop-out margin monitor
Risk ops charts marginLevel and equity against customStopOutValue for each stopOutId so a CFD book can page when freeMargin collapses.
Instrument catalog plus tick overlay
A research board joins instruments.symbol / baseCurrency / quoteCurrency / digits with ChartQuote bid, ask, bidHigh and askHigh for the same pair.
Frequently asked questions
What account fields does the Exness Trade data API describe?
Trading account records include number, profileId, balance, equity, freeMargin, floating, isReal, currency, platform, leverage, requestedLeverage, serverCode, customStopOutValue and executionMode. Equity measurements also include equityUSD, live_equity_hot, live_equity_cold and equity_time_ms for account reconciliation and performance views.
How does authentication work in the illustrative examples?
Email sign-in supplies email and password and returns accessToken and refreshToken with profile attributes such as country and entityName. Subsequent examples use Authorization: Bearer with an access-token placeholder. Account and trading records are scoped to the signed-in profile or selected account; the examples do not provide access to another trader's information.
Does the data cover verification and margin stop-outs?
Yes. Verification records include kyc_status, kycProfile, has_economic_profile and operations such as ProofOfIdentity and EconomicProfile. Stop-out records include stopOutId, equity, marginLevel, customStopOutValue and the affected tickets, supporting verification checklists and review of margin close-outs.
Are the listed paths official Exness production endpoints?
No. The paths and sample payloads are synthetic illustrations of the account, trading and verification data model, not official production endpoints. Account access and any integration require appropriate authorization.
Apps similar to Exness Trade: Online Trading
- XTB Online Investing — XTB is a Poland-founded, publicly listed multi-asset broker that offers forex and CFDs plus real stocks and ETFs on its proprietary xStation 5 web and mobile platform.
- MetaTrader 4 Forex Trading — MetaTrader 4 is MetaQuotes' platform for trading forex, analyzing financial markets and using Expert Advisors, and Exness offers MT4 alongside its own Terminal.
- MetaTrader 5 — Forex, Stocks — MetaTrader 5 is MetaQuotes' trading platform for forex, stocks and futures on desktop, web and Android, and Exness lists MT5 as one of its two MetaTrader builds.
- Pepperstone — Pepperstone is a Melbourne-founded online forex and CFD broker that supports MetaTrader 4, MetaTrader 5, cTrader, TradingView and its own Webtrader.
- XM — XM Group is Trading Point Group's retail forex and CFD brand, with CFDs on forex, stocks, indices, commodities and metals available through proprietary apps and MetaTrader 4 and 5.
- Plus500 — Plus500 is a publicly traded multi-asset broker that offers CFDs, share dealing through Plus500 Invest, and futures through Plus500 Futures on proprietary WebTrader and mobile apps.
- eToro — eToro is an online multi-asset platform for stocks, ETFs, forex, crypto and CFDs whose copy trading feature automatically replicates the trades of other investors.
- IG — IG is a London-based, publicly listed multi-asset broker that offers forex and CFDs plus shares, ETFs and crypto on IG web and mobile, MetaTrader 4, MetaTrader 5 and TradingView.
Topics
- exness trade api
- exness equity freeMargin
- exness positions ticket
- exness kyc_status
- exness stopOutId
- forex cfd account data
- exness margin monitoring
Need this app's data API integrated?
We deliver scoped integrations for any named app — from USD 500 with source-code handoff, or hosted access billed per call. Tell us the data you need.
- NDA + SOW on every engagement
- Delivery in 3–7 days
- Payment only after acceptance
- Work scoped to authorized use