REST Trading API Reference

Account

/accounts
GET 1 Returns a list of the logged-in client's accounts.
/accounts/preferences
GET 1 Returns account preferences.
PUT 1 Updates account preferences.
/history/activity
GET 3 Returns the account activity history.
GET 2 Returns the account activity history.
/history/activity/{fromDate}/{toDate}
GET 1 Returns the account activity history for the given date range.
/history/activity/{lastPeriod}
GET 1 Returns the account activity history for the last specified period.
/history/transactions
GET 2 Returns the transaction history. Returns the minute prices within the last 10 minutes by default.
/history/transactions/{transactionType}/{fromDate}/{toDate}
GET 1 Returns the transaction history for the specified transaction type and given date range.
/history/transactions/{transactionType}/{lastPeriod}
GET 1 Returns the transaction history for the specified transaction type and period.

Dealing

/confirms/{dealReference}
GET 1 Returns a deal confirmation for the given deal reference. Please note, this should only be used if the deal confirmation isn't received via the streaming API.
/positions
GET 2 Returns all open positions for the active account.
GET 1 Returns all open positions for the active account.
/positions/{dealId}
GET 2 Returns an open position for the active account by deal identifier.
GET 1 Returns an open position for the active account by deal identifier.
/positions/otc
DELETE 1 Closes one or more OTC positions.
POST 2 Creates an OTC position.
POST 1 Creates an OTC position.
/positions/otc/{dealId}
PUT 2 Updates an OTC position.
PUT 1 Updates an OTC position.
/working-orders
GET 2 Returns all open working orders for the active account.
GET 1 Returns all open working orders for the active account.
/working-orders/otc
POST 2 Creates an OTC working order.
POST 1 Creates an OTC working order.
/working-orders/otc/{dealId}
DELETE 2 Deletes an OTC working order.
DELETE 1 Deletes an OTC working order.
PUT 2 Updates an OTC working order.
PUT 1 Updates an OTC working order.

Markets

/market-navigation
GET 1 Returns all top-level nodes (market categories) in the market navigation hierarchy.
/market-navigation/{nodeId}
GET 1 Returns all sub-nodes of the given node in the market navigation hierarchy.
/markets
GET 2 Returns the details of the given markets.
GET 1 Returns the details of the given markets.
/markets/{epic}
GET 4 Returns the details of the given market.
GET 3 Returns the details of the given market.
GET 2 Returns the details of the given market.
GET 1 Returns the details of the given market.
/markets?searchTerm={searchTerm}
GET 1 Returns all markets matching the search term.
/prices/{epic}
GET 3 Returns historical prices for a particular instrument. Returns the minute prices within the last 10 minutes by default.
/prices/{epic}/{resolution}/{numPoints}
GET 2 Returns a list of historical prices for the given epic, resolution and number of data points.
GET 1 Returns a list of historical prices for the given epic, resolution and number of data points.
/prices/{epic}/{resolution}/{startDate}/{endDate}
GET 2 Returns a list of historical prices for the given epic, resolution and date range.
/prices/{epic}/{resolution}?startdate={startdate}&enddate={enddate}
GET 1 Returns a list of historical prices for the given epic, resolution and date range.

Watchlists

/watchlists
GET 1 Returns all watchlists belonging to the active account.
POST 1 Creates a watchlist.
/watchlists/{watchlistId}
DELETE 1 Deletes a watchlist.
GET 1 Returns a watchlist.
PUT 1 Add a market to a watchlist.
/watchlists/{watchlistId}/{epic}
DELETE 1 Remove a market from a watchlist.

Client sentiment

/client-sentiment
GET 1 Returns the client sentiment for the given instrument's market.
/client-sentiment/{marketId}
GET 1 Returns the client sentiment for the given instrument's market.
/client-sentiment/related/{marketId}
GET 1 Returns a list of related market sentiment for the given instrument's market.

Login

/session
DELETE 1 Log out of the current session.
GET 1 Returns the user's session details and optionally tokens.
POST 3 Creates a trading session, obtaining session tokens for subsequent API access. Please note, region-specific login restrictions may apply.
POST 2 Creates a trading session, obtaining session tokens for subsequent API access. Please note, region-specific login restrictions may apply.
POST 1 Creates a trading session, obtaining session tokens for subsequent API access. Please note, region-specific login restrictions may apply.
PUT 1 Switches active accounts, optionally setting the default account
/session/encryptionKey
GET 1 Creates a trading session, obtaining session tokens for subsequent API access. Please note, region-specific login restrictions may apply.
/session/refresh-token
POST 1 Refreshes a trading session, obtaining new session tokens for subsequent API access.

Indicative costs and charges

/indicativecostsandcharges/close
POST 1 Returns indicative costs and charges at closing. Supported website IDs: atm, atf, dem, def, det, esm, esf, est, frm, frf, frt, itm, itf, itt, nlm, nlf, nlt, nom, nof, not, sem, sef, set, eng, enf, ent, iei, iem, ief, iet, igi, igm, por, pof.
/indicativecostsandcharges/durablemedium/{indicativeQuoteReference}
GET 1 Download a previously generated indicative costs and charges quote as a pdf. Supported website IDs: atm, atf, dem, def, det, esm, esf, est, frm, frf, frt, itm, itf, itt, nlm, nlf, nlt, nom, nof, not, sem, sef, set, eng, enf, ent, iei, iem, ief, iet, por, pof.
/indicativecostsandcharges/edit
POST 1 Returns indicative costs and charges for editing an order. Supported website IDs: atm, atf, dem, def, det, esm, esf, est, frm, frf, frt, itm, itf, itt, nlm, nlf, nlt, nom, nof, not, sem, sef, set, eng, enf, ent, iei, iem, ief, iet, igi, igm, por, pof.
/indicativecostsandcharges/history/from/{from}/to/{to}
GET 1 Returns indicative costs and charges history for the given date range. Supported website IDs: atm, atf, dem, def, det, esm, esf, est, frm, frf, frt, itm, itf, itt, nlm, nlf, nlt, nom, nof, not, sem, sef, set, eng, enf, ent, iei, iem, ief, iet, por, pof.
/indicativecostsandcharges/open
POST 1 Returns indicative costs and charges at opening. Supported website IDs: atm, atf, dem, def, det, esm, esf, est, frm, frf, frt, itm, itf, itt, nlm, nlf, nlt, nom, nof, not, sem, sef, set, eng, enf, ent, iei, iem, ief, iet, igi, igm, por, pof.

General

/operations/application
GET 1 Returns a list of client-owned applications.
PUT 1 Alters the details of a given user application.
/operations/application/disable
PUT 1 Disables the current application key from processing further requests. Disabled keys may be re-enabled via the 'my account' section on our web dealing platform.