Skip to content

DerivAPI.md

Latest commit

 

History

History
3139 lines (2126 loc) · 107 KB

DerivAPI.md

File metadata and controls

3139 lines (2126 loc) · 107 KB

Table of Contents

Main Modules

DerivAPI

The main class of the DerivAPI module. This class extends the minimum functionality provided by the DerivAPIBasic adding abstract objects that can be used to read data and interact with the API.

Parameters

Properties

  • basic DerivAPIBasic Basic API, used for making low-level calls to the API

Examples

// Returns an abstract ticks object
const ticks = api.ticks('R_100');

// Subscribe to updates on the ticks object
ticks.onUpdate().subscribe(console.log);

// Read the last ticks available in the default range
const ticks_history = ticks.list;

// Read the last 100 ticks until yesterday
const older_history = await ticks.history({ count: 100, end: new Date(yesterday) });

// Access to low-level API
const api_basic = api.basic;

ticks

Provides a ticks stream and a list of available ticks

Parameters

Returns Promise<Ticks>

candles

Provides a list of available candles with the default granularity

Parameters

Returns Promise<Candles>

contract

A contract object with latest market values, cannot be bought or sold

Parameters

Returns Promise<Contract>

underlying

An underlying object, including contract groups, pip size, etc.

Parameters
  • symbol String The underlying symbol

Returns Promise<Underlying>

account

An account object, including loginid, balance, contracts, etc.

Parameters
  • token String Token to create the account with

Returns Promise<Account>

assets

Trading assets including multiple underlyings and trading times

Returns Promise<Assets>

websiteStatus

Website status stream

Returns Promise<WebsiteStatus>

contractOptions

Request contract options to display in UI

Parameters
  • symbol

Returns Promise<ContractOptions>

DerivAPIBasic

Extends DerivAPICalls

The minimum functionality provided by DerivAPI, provides direct calls to the API. api.cache is available if you want to use the cached data (see Cache)

Parameters

  • options Object (optional, default {})
    • options.app_id Number Application ID of the API user
    • options.connection WebSocket? A ready to use connection
    • options.endpoint String API server to connect to (optional, default 'frontend.binaryws.com')
    • options.lang String Language of the API communication (optional, default 'EN')
    • options.brand String Brand name (optional, default '')
    • options.middleware Object A middleware to call on certain API actions (optional, default {})
    • options.storage
    • options.cache (optional, default new InMemory())

Properties

  • events Observable
  • cache Cache Temporary cache default to @link{InMemory}
  • storage Cache If specified, uses a more presistent cache (local storage, etc.)

Examples

const apiFromOpenConnection = new DerivAPI({ connection });
const apiFromEndpoint = new DerivAPI({ endpoint: 'ws.binaryws.com', app_id: 1234 });

closeHandler

Reconnects to the API in case of connection error, unless connection is passed as an argument, in that case reconnecting should be handled in the API user side.

onClose

Returns Observable for close events

onOpen

Returns Observable for open events

onMessage

Returns Observable for new messages

expectResponse

Parameters
  • types String Expect these types to be received by the API

Returns (Promise<Object> | Promise<Array>) Resolves to a single response or an array

Abstract Objects

Immutables

Abstract objects that provide static content and methods to make use of them, changing internal fields of these objects is blocked and they do not receive updates.

Account

Extends Immutable

Abstract class for user accounts

Parameters
Properties
Examples
const account = await api.accounts(your_token);

// Returns the open contracts of this account
const open_contracts = account.open_contracts;

const siblings = account.siblings;

// Switches the API account to the first sibling
// The existing account instance is not authorized anymore and should be discarded
const sibling = await api.account(loginidToToken(siblings[0].loginid));

Assets

Extends Immutable

Abstract class for trading assets

Parameters
Properties
Examples
const assets = await api.assets();

// Get the current open markets
const open_markets = assets.open_markets;

const trading_times = assets.trading_times;

Underlying

Extends Immutable

Abstract class for an underlying

Parameters
Properties
Examples
const underlying = await api.underlying('R_100');

const pip_sized = underlying.pipSizedValue(123.1);

// Same as api.tickStream(symbol);
const tick_stream = underlying.tickStream();

if (underlying.is_open) await contract.buy();
toPipSized

Returns the pipSized display of the value in string

Parameters
  • value
ticks

Shortcut for api.ticks(symbol)

candles

Shortcut for api.candles(symbol)

Tick

Extends Immutable

A wrapper class for Tick

Parameters
Properties

Candle

Extends Immutable

A wrapper class for Candle

Parameters
Properties

Transaction

Extends Immutable

A class for transaction objects

Parameters
Properties

Buy

Extends Immutable

Wrapper around a Buy response

Parameters
Properties

Sell

Extends Immutable

Wrapper around a Sell response

Parameters
Properties

ContractOptions

Extends Immutable

Abstract objects for options needed to create a contract

Parameters
  • api
  • symbol
Properties

Streams

Live stream of data, plus some dynamically updated fields, you can subscribe to changes using the onUpdate method on all of these classes.

Balance

Extends Stream

An abstract class for balance information

Parameters
Properties
  • amount Monetary
  • value Number numeric balance value
  • currency String currency of the amount
  • display String display value of amount (decimal point)
  • format String formatted amount (decimal point, comma separated)
Examples
const balance = accounts.balance;

const formatted_balance = balance.format;

balance.onUpdate().subscribe(balance => console.log)

Candles

Extends Stream

An abstract class for Candles stream returned from DerivAPI#candleStream

Parameters
Properties
history

Resolves to a list of candles given the range

Parameters
Examples
const old_candles = await candle_stream.history({count: 10, end: yesterday})

Returns Promise<Array<Candle>>

Contract

Extends Stream

Abstract class for contracts

Parameters
Properties
  • status String 'proposal', 'open', 'expired', 'sold', 'won', 'lost'
  • ask_price Monetary Price to pay to buy a contract
  • type String contract type
  • payout Monetary Potential or realized payout
  • longcode String
  • symbol String
  • currency String
  • current_spot Spot
  • start_time CustomDate Start time of the contract (estimated for proposal)
  • buy_price Monetary? (After buy)
  • bid_price Monetary? (After buy)
  • sell_price Monetary? (After sell)
  • profit Profit? Potential or realized profit (After buy)
  • proposal_id Number? The proposal ID used to buy
  • id Number? The contract ID (After buy)
  • purchase_time CustomDate? (After buy)
  • expiry_time CustomDate? (After buy)
  • sell_time CustomDate? (After sell)
  • barrier_count Number? (For contracts with barrier)
  • high_barrier MarketValue? (For contracts with two barriers)
  • low_barrier MarketValue? (For contracts with two barriers)
  • barrier MarketValue? (For contracts with one barrier)
  • tick_count Number? (For tick contracts)
  • ticks Array<Tick>? (For tick contracts)
  • multiplier Number? (For loopback contracts)
  • shortcode String?
  • validation_error String?
  • is_forward_starting Boolean?
  • is_intraday Boolean?
  • is_path_dependent Boolean?
  • is_valid_to_sell Boolean? We still allow a sell call, let API handle the error
  • is_expired Boolean?
  • is_settleable Boolean?
  • is_open Boolean? Is this contract still open
  • entry_spot Spot?
  • exit_spot Spot?
  • audit_details Object?
  • code FullName? only if both short and long codes are available
Examples
const contract = account.contract({ contract_type: 'CALL', ...options })

const buy = await contract.buy();

contract.onUpdate().subscribe(console.log)
buy

Buys this contract

Parameters
  • buy BuyParam (optional, default {})
    • buy.max_price (optional, default this.ask_price.value)

Returns Buy

sell

Sells this contract

Parameters
  • sell SellParam zero price means sell at market (optional, default {})
    • sell.max_price (optional, default 0)

Returns Sell

Ticks

Extends Stream

Abstract class for ticks stream returned by the DerivAPI#tickStream

Parameters
Properties
  • list Array<Tick> An immutable list of ticks
history

Resolves to a list of Ticks using the given range

Parameters
Examples
const old_ticks = await tickStream.history({count: 10, end: yesterday})

Returns Promise<Array<Tick>>

Transactions

Extends Stream

A stream of transactions

Parameters
Properties
Examples
const tx_stream = accounts.transaction_stream;

const tx_list = tx_stream.list;

tx_stream.onUpdate(console.log)

WebsiteStatus

Extends Stream

An abstract class for website status info

Parameters
Properties
Examples
const website_status = await api.websiteStatus();

const is_website_up = website_status.is_website_up;

website_status.onUpdate(s => console.log(`Site is ${s.status}`));

Fields

Container classes for data types, providing means to convert them to other types and represent them to the UI. These are mostly simpler objects used for representing data.

Barrier

Extends MarketValue

A barrier info, either absolute or relative

Parameters
Properties

CustomDate

Extends Immutable

An alternative date object

Parameters
Properties
isBefore
Parameters

Returns Boolean

isSameOrAfter
Parameters

Returns Boolean

isSameOrBefore
Parameters

Returns Boolean

isAfter
Parameters

Returns Boolean

isSame
Parameters

Returns Boolean

addDuration

Adds a duration to the current date

Parameters

Returns CustomDate

DateRange

Extends Immutable

An abstract class for date range

Parameters

Duration

Extends Immutable

Duration object

Parameters
Properties
addToDate

Adds this duration to a date object

Parameters

Returns CustomDate

DurationRange

Extends Immutable

An abstract class for date range

Parameters

FullName

Extends Immutable

A class for keeping short and full name of things

Parameters
  • short_name
  • full String Full form of the name
  • short String short form of the name
Properties
Examples
const lc = account.landing_company;

console.log(`Landing Company: ${lc.full}, Short code: ${lc.short}`);

MarketValue

Extends Immutable

Keeps a market value and pip size

Parameters
Properties

Monetary

Extends Immutable

Keeps money related values

Parameters
Properties
  • value Number
  • currency String
  • display String decimal value based on currency
  • format String comma separated decimal value based on currency

Profit

Extends Monetary

Keeps money related values

Parameters
Properties
  • value Number Absolute value of the profit
  • percentage Number
  • sign Number 0: no profit, 1: positive profit, -1: loss
  • is_win Boolean True if the initial profit is positive
  • currency String
  • display String decimal value based on currency
  • format String comma separated decimal value based on currency

Spot

Extends MarketValue

Keeps a market value at a time

Parameters
Properties

Core Functionality

Cache

Extends DerivAPICalls

Cache - A class for implementing in-memory and persistent cache

The real implementation of the underlying cache is delegated to the storage object (See the params).

The storage object needs to implement the API.

Parameters

  • api DerivAPIBasic API instance to get data that is not cached
  • storage Object A storage instance to use for caching

Examples

// Read the latest active symbols
const symbols = await api.activeSymbols();

// Read the data from cache if available
const cached_symbols = await api.cache.activeSymbols();

SubscriptionManager

Subscription Manager - manage subscription channels

Makes sure there is always only one subscription channel for all requests of subscriptions, keeps a history of received values for the subscription of ticks and forgets channels that do not have subscribers. It also ensures that subscriptions are revived after connection drop/account changed.

Parameters

  • api

Examples

// This one creates a new subscription assuming it is the first one for R_100
const subscriber1 = api.subscribe({ ticks: 'R_100' }, console.log);

// This one uses the existing subscription to R_100
const subscriber2 = api.subscribe({ ticks: 'R_100' }, console.log);

subscriber1.unsubscribe(); // no API forget yet
subscriber2.unsubscribe(); // Issues API forget

subscribe

Subscribe to a given request, returns a stream of new responses, Errors should be handled by the user of the stream

Parameters
  • request Object A request object acceptable by the API
Examples
const ticks = api.subscribe({ ticks: 'R_100' });
ticks.subscribe(console.log) // Print every new tick

Returns Observable An RxJS Observable

Object References

These are plain JavaScript objects that are named to easily refer to them in this documentation, they don't physically exist as a class in this codebase.

Parameters

CandlesParam

Type: Object

Properties
  • granularity Number Granularity in seconds
  • range HistoryRange A chunk of history to return with start and end time
  • symbol String Symbol of the candles

TicksParam

Type: Object

Properties
  • range HistoryRange A chunk of history to return with start and end time
  • symbol String The ticks symbol

BuyParam

Type: Object

Properties
  • max_price Number? Maximum acceptable price for buying the contract

SellParam

Type: Object

Properties
  • max_price Number? Maximum acceptable price for selling the contract

ContractParam

Type: Object

Properties

HistoryRange

Type: Object

Properties
  • start (Number | Date) An epoch in seconds or a Date object
  • end (Number | Date) An epoch in seconds or a Date object
  • count Number Number of ticks returned by history

accountClosure

Parameters

  • args Object (optional, default {})
    • args.account_closure Number Must be 1
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.reason String Reason for closing off accounts.
    • args.req_id Number Optional field to map request to response

accountSecurity

Parameters

  • args Object (optional, default {})
    • args.account_security Number Must be 1
    • args.otp String OTP (one-time passcode) generated by a 2FA application like Authy, Google Authenticator or Yubikey.
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.totp_action Any Action to be taken for managing TOTP (time-based one-time password, RFC6238). Generate will create a secret key which is then returned in the secret_key response field, you can then enable by using that code in a 2FA application.

accountStatistics

Parameters

  • args Object (optional, default {})
    • args.account_statistics Number Must be 1.
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field
    • args.req_id Number Optional field to map request to response

activeSymbols

Parameters

  • args Object (optional, default {})
    • args.active_symbols Any If you use 'brief', only a subset of fields will be returned.
    • args.landing_company Any [Optional] If you specify this field, only symbols available for trading by that landing company will be returned. If you are logged in, only symbols available for trading by your landing company will be returned regardless of what you specify in this field.
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.product_type Any [Optional] If you specify this field, only symbols that can be traded through that product type will be returned.
    • args.req_id Number [Optional] Used to map request to response.

apiToken

Parameters

  • args Object (optional, default {})
    • args.api_token Number Must be 1
    • args.delete_token String The token to remove
    • args.new_token String The name of the created token
    • args.new_token_scopes Any -
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.valid_for_current_ip_only Number Optional field, if you set this parameter during token creation, then the token created will only work for the IP address that was used to create the token

appDelete

Parameters

  • args Object (optional, default {})
    • args.app_delete Number Application app_id
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

appGet

Parameters

  • args Object (optional, default {})
    • args.app_get Number Application app_id
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

appList

Parameters

  • args Object (optional, default {})
    • args.app_list Number -
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

appMarkupDetails

Parameters

  • args Object (optional, default {})
    • args.app_id Number Optional: specific application app_id to report on
    • args.app_markup_details Number Must be 1.
    • args.client_loginid String Optional: specific client loginid to report on, like CR12345
    • args.date_from String Start date (epoch or YYYY-MM-DD HH:MM:SS). Results are inclusive of this time.
    • args.date_to String End date (epoch or YYYY-MM-DD HH::MM::SS). Results are inclusive of this time.
    • args.description Number If set to 1, will return app_markup transaction details.
    • args.limit Number Optional: (default 1000): Apply upper limit to count of transactions received
    • args.offset Number Optional: Skip this many transactions
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.sort String Optional transaction_time sort direction, default DESC. Other fields sort order is ASC.
    • args.sort_fields Any Optional one or more of the specified fields to sort on. Default sort field is by transaction_time.

appRegister

Parameters

  • args Object (optional, default {})
    • args.app_markup_percentage Number Markup to be added to contract prices (as a percentage of contract payout). Min: 0, Max: 5
    • args.app_register Number Must be 1
    • args.appstore String Application's App Store URL (if applicable)
    • args.github String Application's GitHub page (for open-source projects)
    • args.googleplay String Application's Google Play URL (if applicable)
    • args.homepage String Application's homepage
    • args.name String Application name
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.redirect_uri String Application redirect_uri
    • args.req_id Number Optional field to map request to response
    • args.scopes Any -
    • args.verification_uri String Application verification_uri

appUpdate

Parameters

  • args Object (optional, default {})
    • args.app_markup_percentage Number Markup to be added to contract prices (as a percentage of contract payout). Min: 0, Max: 5
    • args.app_update Number Application app_id
    • args.appstore String Application's App Store URL (if applicable)
    • args.github String Application's GitHub page (for open-source projects)
    • args.googleplay String Application's Google Play URL (if applicable)
    • args.homepage String Application's homepage
    • args.name String Application name
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.redirect_uri String Application redirect_uri
    • args.req_id Number Optional field to map request to response
    • args.scopes Any Change scopes will revoke all user's grants and log them out.
    • args.verification_uri String Application verification_uri

assetIndex

Parameters

  • args Object (optional, default {})
    • args.asset_index Number Must be 1.
    • args.landing_company Any [Optional] If specified, will return only the underlyings for the specified landing company.
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.

authorize

Parameters

  • args Object (optional, default {})
    • args.add_to_login_history Any [Optional] Send this when you use api tokens for authorization and want to track activity using login_history call.
    • args.authorize String Authentication token. May be retrieved from https://www.binary.com/en/user/security/api_tokenws.html
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.

balance

Parameters

  • args Object (optional, default {})
    • args.balance Number Must be 1.
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.subscribe Any If set to 1, will send updates whenever the balance changes.

buy

Parameters

  • args Object (optional, default {})
    • args.buy String Either the id received from a Price Proposal (proposal) call, or 1 if contract buy parameters are passed in the parameters field
    • args.parameters Any -
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.price Number Maximum price at which to purchase the contract.
    • args.req_id Number Optional field to map request to response
    • args.subscribe Any 1 - to stream

buyContractForMultipleAccounts

Parameters

  • args Object (optional, default {})
    • args.buy_contract_for_multiple_accounts String Either the id received from a Price Proposal (proposal) call, or 1 if contract buy parameters are passed in the parameters field
    • args.parameters Any -
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.price Number Maximum price at which to purchase the contract.
    • args.req_id Number Optional field to map request to response
    • args.tokens Any -

cashier

Parameters

  • args Object (optional, default {})
    • args.cashier Any either deposit or withdraw, default to deposit
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.provider Any Note only doughflow is supported currently.
    • args.req_id Number Optional field to map request to response
    • args.verification_code String Email verification code (received from a verify_email call, which must be done first)

cashierPassword

Parameters

  • args Object (optional, default {})
    • args.cashier_password Number Must be 1
    • args.lock_password String new password to lock cashier, required for lock (length within 6-25 chars, accepts any printable ASCII character)
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.unlock_password String old password to unlock cashier, required for unlock (length within 6-25 chars, accepts any printable ASCII character)

changePassword

Parameters

  • args Object (optional, default {})
    • args.change_password Number Must be 1
    • args.new_password String New password (length within 6-25 chars, accepts any printable ASCII character)
    • args.old_password String Old password for validation (non-empty string, accepts any printable ASCII character)
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

contractsFor

Parameters

  • args Object (optional, default {})
    • args.contracts_for String The short symbol name (obtained from active_symbols call).
    • args.currency String [Optional] Currency of the contract's stake and payout (obtained from payout_currencies call).
    • args.landing_company Any [Optional] Indicates which landing_company to get a list of contracts for. If you are logged in, your landing company will override this field.
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.product_type Any [Optional] If you specify this field, only contracts tradable through that contract type will be returned.
    • args.req_id Number [Optional] Used to map request to response.

copyStart

Parameters

  • args Object (optional, default {})
    • args.assets Any Optional field, used to set assets to be copied. E.x ["frxUSDJPY", "R_50"]
    • args.copy_start String API tokens identifying the accounts of trader which will be used to copy trades
    • args.max_trade_stake Number Optional field, used to set maximum trade stake to be copied
    • args.min_trade_stake Number Optional field, used to set minimal trade stake to be copied
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.trade_types Any Optional field, used to set trade types to be copied. E.x ["CALL", "PUT"]

copyStop

Parameters

  • args Object (optional, default {})
    • args.copy_stop String API tokens identifying the accounts which needs not to be copied
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

copytradingList

Parameters

  • args Object (optional, default {})
    • args.copytrading_list Number Must be 1
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

copytradingStatistics

Parameters

  • args Object (optional, default {})
    • args.copytrading_statistics Number Must be 1.
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.
    • args.trader_id String The id of the target trader.

documentUpload

Parameters

  • args Object (optional, default {})
    • args.document_format Any Document file format
    • args.document_id String [Optional] Document ID (required for Passport, Proof of ID and Driver's License)
    • args.document_type String Document type
    • args.document_upload Number Must be 1
    • args.expected_checksum String The checksum of the file to be uploaded
    • args.expiration_date String [Optional] Document expiration date (required for Passport, Proof of ID and Driver's License)
    • args.file_size Number Document size (should be less than 3MB)
    • args.page_type Any Optional field to determine document side
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

exchangeRates

Parameters

  • args Object (optional, default {})
    • args.base_currency String Base currency (can be obtained from payout_currencies call)
    • args.exchange_rates Number Must be 1
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.

forget

Parameters

  • args Object (optional, default {})
    • args.forget String ID of the real-time stream of messages to cancel.
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.

forgetAll

Parameters

  • args Object (optional, default {})
    • args.forget_all Any Cancel all streams by type (it can be a single string e.g. 'ticks', or an array of multiple values, e.g. ['ticks', 'candles']). Possible values are: 'ticks', 'candles', 'proposal', 'proposal_open_contract', 'balance', 'transaction', 'proposal_array', 'website_status'.
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.

getAccountStatus

Parameters

  • args Object (optional, default {})
    • args.get_account_status Number Must be 1
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

getFinancialAssessment

Parameters

  • args Object (optional, default {})
    • args.get_financial_assessment Number -
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

getLimits

Parameters

  • args Object (optional, default {})
    • args.get_limits Number Must be 1
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

getSelfExclusion

Parameters

  • args Object (optional, default {})
    • args.get_self_exclusion Number Must be 1
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

getSettings

Parameters

  • args Object (optional, default {})
    • args.get_settings Number Must be 1
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

landingCompany

Parameters

  • args Object (optional, default {})
    • args.landing_company String Client's 2-letter country code (obtained from residence_list call).
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.

landingCompanyDetails

Parameters

  • args Object (optional, default {})
    • args.landing_company_details Any Landing company shortcode.
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.

loginHistory

Parameters

  • args Object (optional, default {})
    • args.limit Number Apply limit to count of login history records, default to 10. Max:50
    • args.login_history Number Must be 1.
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

logout

Parameters

  • args Object (optional, default {})
    • args.logout Number Must be 1
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

mt5Deposit

Parameters

  • args Object (optional, default {})
    • args.amount Number Amount to deposit (in the currency of from_binary); min = $1 or an equivalent amount, max = $20000 or an equivalent amount
    • args.from_binary String Binary account loginid to transfer money from
    • args.mt5_deposit Number -
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.to_mt5 String MT5 account login to deposit money to

mt5GetSettings

Parameters

  • args Object (optional, default {})
    • args.login String MT5 user login
    • args.mt5_get_settings Number Must be 1
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

mt5LoginList

Parameters

  • args Object (optional, default {})
    • args.mt5_login_list Number Must be 1
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

mt5Mamm

Parameters

  • args Object (optional, default {})
    • args.action Any [Optional] Pass this if you want to revoke current manager assigned to mt5 account
    • args.login String MT5 user login
    • args.mt5_mamm Number -
    • args.passthrough Any [Optional] field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] field to map request to response

mt5NewAccount

Parameters

  • args Object (optional, default {})
    • args.account_type Any Account type
    • args.address String [Optional] The address of the user. The maximum length of this address field is 128 characters.
    • args.city String [Optional] User's city of residence.
    • args.company String [Optional] Name of the client's company. The maximum length of the company name is 64 characters.
    • args.country String [Optional] 2-letter country code (value received from residence_list call).
    • args.email String Email address
    • args.investPassword String The investor password of the account. The password must contain at least two of three types of characters (lower case, upper case and digits) and meet the minimum length requirements set for the group. This field is required.
    • args.leverage String Client leverage (from 1 to 1000).
    • args.mainPassword String the master password of the account. The password must contain at least two of three types of characters (lower case, upper case and digits) and meet the minimum length requirements set for the group. This field is required.
    • args.manager_id Number [Optional] Login id of manager whom you want to assign to manage your assets, applicable for MT5 Multiple Accounts Manager only.
    • args.mt5_account_type Any Standard: Variable spreads, High leverage. Advanced: Variable spreads, Medium Leverage, more products.
    • args.mt5_new_account Number Must be 1
    • args.name String Client's name. The maximum length here is 101 characters.
    • args.passthrough Any [Optional] field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.phone String [Optional] User's phone number. Max length 50.
    • args.phonePassword String the user's phone password. Max length 50.
    • args.req_id Number [Optional] field to map request to response
    • args.state String [Optional] User's state (region) of residence.
    • args.zipCode String [Optional] User's zip code. Max length 50.

mt5PasswordChange

Parameters

  • args Object (optional, default {})
    • args.login String MT5 user login
    • args.mt5_password_change Number Must be 1
    • args.new_password String New password (length within 8-25 chars, accepts any printable ASCII character)
    • args.old_password String Old password for validation (non-empty string, accepts any printable ASCII character)
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.password_type Any Password type main/investor (default: main)
    • args.req_id Number Optional field to map request to response

mt5PasswordCheck

Parameters

  • args Object (optional, default {})
    • args.login String MT5 user login
    • args.mt5_password_check Number Must be 1
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.password String the password of the account.
    • args.password_type Any the password type main/investor (default: main)
    • args.req_id Number Optional field to map request to response

mt5PasswordReset

Parameters

  • args Object (optional, default {})
    • args.login String MT5 user login
    • args.mt5_password_reset Number Must be 1
    • args.new_password String New password of the account (length within 8-25 chars, accepts any printable ASCII character).
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.password_type String Password type main/investor (default: main)
    • args.req_id Number Optional field to map request to response
    • args.verification_code String Email verification code (received from a verify_email call, which must be done first)

mt5Withdrawal

Parameters

  • args Object (optional, default {})
    • args.amount Number Amount to withdraw (in the currency of the MT5 account); min = $1 or an equivalent amount, max = $20000 or an equivalent amount.
    • args.from_mt5 String MT5 account login to withdraw money from
    • args.mt5_withdrawal Number -
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.to_binary String Binary account loginid to transfer money to

newAccountMaltainvest

Parameters

  • args Object (optional, default {})
    • args.accept_risk Number Show whether client has accepted risk disclaimer, boolean value 1 or 0
    • args.account_opening_reason String Purpose and reason for requesting the account opening
    • args.account_turnover Any The anticipated account turnover
    • args.address_city String Within 35 characters
    • args.address_line_1 String Within 70 characters.
    • args.address_line_2 String Optional field, within 70 characters.
    • args.address_postcode String Optional field, within 20 characters and may not contain '+'.
    • args.address_state String Optional field, possible value receive from states_list call.
    • args.affiliate_token String Affiliate token, within 32 characters.
    • args.binary_options_trading_experience Any Binary options trading experience
    • args.binary_options_trading_frequency Any Binary options trading frequency
    • args.cfd_trading_experience Any CFDs trading experience
    • args.cfd_trading_frequency Any CFDs trading frequency
    • args.citizen String Country of legal citizenship, 2-letter country code.
    • args.client_type Any Optional field, indicates whether this is for a client requesting an account with professional status. Defaults to retail.
    • args.date_of_birth String Date of birth format: yyyy-mm-dd.
    • args.education_level Any Level of Education
    • args.employment_industry Any Industry of Employment
    • args.employment_status Any Employment Status
    • args.estimated_worth Any Estimated Net Worth
    • args.first_name String Within 2-50 characters, use only letters, spaces, hyphens, full-stops or apostrophes.
    • args.forex_trading_experience Any Forex trading experience
    • args.forex_trading_frequency Any Forex trading frequency
    • args.income_source Any Income Source
    • args.last_name String Within 2-50 characters, use only letters, spaces, hyphens, full-stops or apostrophes.
    • args.net_income Any Net Annual Income
    • args.new_account_maltainvest Number Must be 1
    • args.occupation Any Occupation
    • args.other_instruments_trading_experience Any Trading experience in other financial instruments
    • args.other_instruments_trading_frequency Any Trading frequency in other financial instruments
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.phone String Within 8-35 digits, allowing '+' in front, numbers, hyphens or space.
    • args.place_of_birth String Place of birth, 2-letter country code.
    • args.req_id Number Optional field to map request to response
    • args.residence String 2-letter country code, possible value receive from residence_list call.
    • args.salutation Any Accept any value in enum list.
    • args.secret_answer String Answer to secret question, within 4-50 characters.
    • args.secret_question Any Accept any value in enum list.
    • args.source_of_wealth Any Source of wealth
    • args.tax_identification_number String Tax identification number. Only applicable for real money account. Required for maltainvest landing company.
    • args.tax_residence String Residence for tax purpose. Comma separated iso country code if multiple jurisdictions. Only applicable for real money account. Required for maltainvest landing company.

newAccountReal

Parameters

  • args Object (optional, default {})
    • args.account_opening_reason String Purpose and reason for requesting the account opening
    • args.account_turnover Any The anticipated account turnover
    • args.address_city String Within 35 characters
    • args.address_line_1 String -
    • args.address_line_2 String Optional field, within 70 characters.
    • args.address_postcode String Optional field, within 20 characters and may not contain '+'.
    • args.address_state String Optional field, possible value receive from states_list call.
    • args.affiliate_token String Affiliate token, within 32 characters.
    • args.citizen Any Country of legal citizenship, 2-letter country code.
    • args.client_type Any Optional field, indicates whether this is for a client requesting an account with professional status. Defaults to retail.
    • args.currency Any Optional field to set currency of the account. List of supported currencies can be acquired with 'payout_currencies' call
    • args.date_of_birth String Date of birth format: yyyy-mm-dd.
    • args.first_name String Within 2-50 characters, use only letters, spaces, hyphens, full-stops or apostrophes.
    • args.last_name String Within 2-50 characters, use only letters, spaces, hyphens, full-stops or apostrophes.
    • args.new_account_real Number Must be 1
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.phone String Within 8-35 digits, allowing '+' in front, numbers, hyphens or space.
    • args.place_of_birth String Place of birth, 2-letter country code.
    • args.req_id Number Optional field to map request to response
    • args.residence String 2-letter country code, possible value receive from residence_list call.
    • args.salutation Any Accept any value in enum list.
    • args.secret_answer String Answer to secret question, within 4-50 characters. Required for new account and existing client details will be used if client open another account.
    • args.secret_question Any Accept any value in enum list. Required for new account and existing client details will be used if client open another account.
    • args.tax_identification_number String Tax identification number. Only applicable for real money account. Required for maltainvest landing company.
    • args.tax_residence String Residence for tax purpose. Comma separated iso country code if multiple jurisdictions. Only applicable for real money account. Required for maltainvest landing company.

newAccountVirtual

Parameters

  • args Object (optional, default {})
    • args.affiliate_token String [Optional] Affiliate token, within 32 characters.
    • args.client_password String Password (length within 6-25 chars, accepts any printable ASCII character).
    • args.date_first_contact String [Optional] Date of first contact, format: yyyy-mm-dd in GMT timezone.
    • args.gclid_url String [Optional] Google Click Identifier to track source.
    • args.new_account_virtual Number Must be 1.
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.
    • args.residence String 2-letter country code (obtained from residence_list call).
    • args.signup_device Any [Optional] Show whether user has used mobile or desktop.
    • args.utm_campaign String [Optional] Identifies a specific product promotion or strategic campaign such as a spring sale or other promotions.
    • args.utm_medium String [Optional] Identifies the medium the link was used upon such as: email, CPC, or other methods of sharing.
    • args.utm_source String [Optional] Identifies the source of traffic such as: search engine, newsletter, or other referral.
    • args.verification_code String Email verification code (received from a verify_email call, which must be done first).

notificationEvent

Parameters

  • args Object (optional, default {})
    • args.category String The category or nature of the event.
    • args.event String The name of the event.
    • args.notification_event Number Must be 1.
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.

oauthApps

Parameters

  • args Object (optional, default {})
    • args.oauth_apps Number -
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response

paymentagentList

Parameters

  • args Object (optional, default {})
    • args.currency String [Optional] If specified, only payment agents that supports that currency will be returned (obtained from payout_currencies call).
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.paymentagent_list String Client's 2-letter country code (obtained from residence_list call).
    • args.req_id Number [Optional] Used to map request to response.

paymentagentTransfer

Parameters

  • args Object (optional, default {})
    • args.amount Number -
    • args.currency String -
    • args.description String Optional field for remarks about the transfer.
    • args.dry_run Number If 1, just do validation
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.paymentagent_transfer Number -
    • args.req_id Number Optional field to map request to response
    • args.transfer_to String The transfer_to loginid

paymentagentWithdraw

Parameters

  • args Object (optional, default {})
    • args.amount Number -
    • args.currency String -
    • args.description String Optional field for remarks about the withdraw. Only letters, numbers, space, period, comma, - ' are allowed.
    • args.dry_run Number If 1, just do validation
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.paymentagent_loginid String The payment agent loginid received from the paymentagent_list call
    • args.paymentagent_withdraw Number -
    • args.req_id Number Optional field to map request to response
    • args.verification_code String Email verification code (received from a verify_email call, which must be done first)

payoutCurrencies

Parameters

  • args Object (optional, default {})
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.payout_currencies Number Must be 1.
    • args.req_id Number [Optional] Used to map request to response.

ping

Parameters

  • args Object (optional, default {})
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.ping Number Must be 1.
    • args.req_id Number [Optional] Used to map request to response.

portfolio

Parameters

  • args Object (optional, default {})
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.portfolio Number Must be 1
    • args.req_id Number Optional field to map request to response

profitTable

Parameters

  • args Object (optional, default {})
    • args.date_from String Optional start date (epoch or YYYY-MM-DD)
    • args.date_to String Optional end date (epoch or YYYY-MM-DD)
    • args.description Number If set to 1, will return full contracts description.
    • args.limit Number Apply upper limit to count of transactions received
    • args.offset Number Skip this many transactions
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.profit_table Number Must be 1.
    • args.req_id Number Optional field to map request to response
    • args.sort String sort direction, default DESC

proposal

Parameters

  • args Object (optional, default {})
    • args.amount Number Proposed contract payout or stake, or multiplier (for lookbacks).
    • args.barrier String Barrier for the contract (or last digit prediction for digit contracts). Contracts less than 24 hours in duration would need a relative barrier (barriers which need +/-), where entry spot would be adjusted accordingly with that amount to define a barrier, except for Volatility Indices as they support both relative and absolute barriers. Not needed for lookbacks.
    • args.barrier2 String Low barrier for the contract (for contracts with two barriers). Contracts less than 24 hours in duration would need a relative barrier (barriers which need +/-), where entry spot would be adjusted accordingly with that amount to define a barrier, except for Volatility Indices as they support both relative and absolute barriers. Not needed for lookbacks.
    • args.basis Any Indicates whether amount is 'payout' or 'stake' for binary options, and 'multiplier' for lookbacks.
    • args.contract_type Any The proposed contract type
    • args.currency String This can only be the account-holder's currency (obtained from payout_currencies call).
    • args.date_expiry Number Epoch value of the expiry time of the contract. Either date_expiry or duration is required.
    • args.date_start Number [Optional] Indicates epoch value of the starting time of the contract. If left empty, the start time of the contract is now.
    • args.duration Number Duration quantity. Either date_expiry or duration is required.
    • args.duration_unit Any [Optional] Duration unit - s(seconds), m(minutes), h(hours), d(days), t(ticks).
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.product_type Any The product type.
    • args.proposal Number Must be 1.
    • args.req_id Number [Optional] Used to map request to response.
    • args.selected_tick Number The tick that is predicted to have the highest/lowest value - for tickhigh and ticklow contracts.
    • args.subscribe Any [Optional] 1 - to initiate a realtime stream of prices. Note that tick trades (without a user-defined barrier), digit trades and less than 24 hours at-the-money contracts for the following underlying symbols are not streamed: R_10, R_25, R_50, R_75, R_100, RDBULL, RDBEAR (this is because their price is constant).
    • args.symbol String The short symbol name (obtained from active_symbols call).
    • args.trading_period_start Number Required only for multi-barrier trading. Defines the epoch value of the trading period start time.

proposalArray

Parameters

  • args Object (optional, default {})
    • args.amount Number Proposed contract payout or stake value.
    • args.barriers Any Array of barrier(s) for the contract.
    • args.basis Any Indicate whether amount is 'payout' or 'stake'.
    • args.contract_type Any One or two valid contract-types.
    • args.currency String This can only be the account-holder's currency.
    • args.date_expiry Number Epoch value of the expiry time of the contract. You must either specify date_expiry or duration.
    • args.date_start Number [Optional] Indicates epoch value of the starting time of the contract. If left empty, the start time of the contract is now.
    • args.duration Number Duration quantity.
    • args.duration_unit Any [Optional] Duration unit - s(seconds), m(minutes), h(hours), d(days), t(ticks).
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.product_type Any [Optional] If you specify this field, only contracts tradable through that contract type will be returned.
    • args.proposal_array Number Must be 1.
    • args.req_id Number [Optional] Used to map request to response.
    • args.subscribe Any [Optional] 1 - to initiate a realtime stream of prices. Note that tick trades (without a user-defined barrier), digit trades and less than 24 hours at-the-money contracts for the following underlying symbols are not streamed: R_10, R_25, R_50, R_75, R_100, RDBULL, RDBEAR (this is because their price is constant).
    • args.symbol String Symbol code.
    • args.trading_period_start Number Required only for multi-barrier trading. Defines the epoch value of the trading period start time.

proposalOpenContract

Parameters

  • args Object (optional, default {})
    • args.contract_id Number Contract id received from a Portfolio request. If not set, you will receive stream of all open contracts.
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.proposal_open_contract Any Must be 1
    • args.req_id Number Optional field to map request to response
    • args.subscribe Number 1 - to stream

realityCheck

Parameters

  • args Object (optional, default {})
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.reality_check Number Must be 1
    • args.req_id Number Optional field to map request to response

requestReport

Parameters

  • args Object (optional, default {})
    • args.date_from Number Start date of the report
    • args.date_to Number End date of the report
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field
    • args.report_type String Type of report to be sent to client's registered e-mail address
    • args.req_id Number Optional field to map request to response
    • args.request_report Number Must be 1.

resetPassword

Parameters

  • args Object (optional, default {})
    • args.date_of_birth String Date of birth format: yyyy-mm-dd. Only required for clients with real-money accounts.
    • args.new_password String New password for validation (length within 6-25 chars, accepts any printable ASCII characters, need to include capital and lowercase letters with numbers). Password strength is evaluated with: http://archive.geekwisdom.com/js/passwordmeter.js
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.reset_password Number -
    • args.verification_code String Email verification code (received from a verify_email call, which must be done first)

residenceList

Parameters

  • args Object (optional, default {})
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.
    • args.residence_list Number Must be 1.

revokeOauthApp

Parameters

  • args Object (optional, default {})
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.revoke_oauth_app Number -

sell

Parameters

  • args Object (optional, default {})
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.price Number Minimum price at which to sell the contract, or '0' for 'sell at market'
    • args.req_id Number Optional field send in request to map to response, present only when request contains req_id
    • args.sell Number Pass contract_id received from the Portfolio call

sellContractForMultipleAccounts

Parameters

  • args Object (optional, default {})
    • args.passthrough Any Optional field used to pass data through the websocket API. May be retrieved via the echo_req output field.
    • args.price Number Minimum price at which to sell the contract, or '0' for 'sell at market'
    • args.req_id Number Optional field send in request to map to response, present only when request contains req_id
    • args.sell_contract_for_multiple_accounts Number -
    • args.shortcode String An internal ID used to identify the contract which was originally bought. This is returned from the buy and buy_for_multiple_accounts calls
    • args.tokens Any Authorisation tokens which select the accounts to sell use for the affected accounts

sellExpired

Parameters

  • args Object (optional, default {})
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.sell_expired Number Must be 1.

serviceToken

Parameters

  • args Object (optional, default {})
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.referrer String The URL of the web page where the Web SDK will be used.
    • args.req_id Number [Optional] Used to map request to response.
    • args.service String The service name to retrieve the token for.
    • args.service_token Number Must be 1.

setAccountCurrency

Parameters

  • args Object (optional, default {})
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.set_account_currency Any Currency of the account. List of supported currencies can be acquired with 'payout_currencies' call

setFinancialAssessment

Parameters

  • args Object (optional, default {})
    • args.account_turnover Any The anticipated account turnover
    • args.binary_options_trading_experience Any Binary options trading experience
    • args.binary_options_trading_frequency Any Binary options trading frequency
    • args.cfd_trading_experience Any CFDs trading experience
    • args.cfd_trading_frequency Any CFDs trading frequency
    • args.education_level Any Level of Education
    • args.employment_industry Any Industry of Employment
    • args.employment_status Any Employment Status
    • args.estimated_worth Any Estimated Net Worth
    • args.forex_trading_experience Any Forex trading experience
    • args.forex_trading_frequency Any Forex trading frequency
    • args.income_source Any Income Source
    • args.net_income Any Net Annual Income
    • args.occupation Any Occupation
    • args.other_instruments_trading_experience Any Trading experience in other financial instruments
    • args.other_instruments_trading_frequency Any Trading frequency in other financial instruments
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.set_financial_assessment Number Must be 1
    • args.source_of_wealth Any Source of wealth

setSelfExclusion

Parameters

  • args Object (optional, default {})
    • args.exclude_until Any Exclude me from the website (for a minimum of 6 months, up to a maximum of 5 years). Note: uplifting this self-exclusion may require contacting the company.
    • args.max_30day_losses Any 30-day limit on losses
    • args.max_30day_turnover Any 30-day turnover limit
    • args.max_7day_losses Any 7-day limit on losses
    • args.max_7day_turnover Any 7-day turnover limit
    • args.max_balance Any Maximum account cash balance
    • args.max_deposit Any Deposit limit.
    • args.max_deposit_end_date Any Exclude me from making deposits when the cumulative sum of deposits exceeds specified deposit limit.
    • args.max_losses Any Daily limit on losses
    • args.max_open_bets Any Maximum number of open positions
    • args.max_turnover Any Daily turnover limit
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.session_duration_limit Any Session duration limit, in minutes
    • args.set_self_exclusion Number -
    • args.timeout_until Any Exclude me from the website (for up to 6 weeks). Requires time in epoch format. Note: unlike exclude_until, this self-exclusion will be lifted automatically at the expiry of the timeout period.

setSettings

Parameters

  • args Object (optional, default {})
    • args.account_opening_reason String Purpose and reason for requesting the account opening. Only applicable for real money account. Required for clients that have not set it yet. Can only be set once.
    • args.address_city String Note: not applicable for virtual account. Required field for real money account.
    • args.address_line_1 String Note: not applicable for virtual account. Required field for real money account.
    • args.address_line_2 Any Note: not applicable for virtual account. Optional field for real money account.
    • args.address_postcode String Note: not applicable for virtual account. Optional field for real money account.
    • args.address_state String Note: not applicable for virtual account. Optional field for real money account.
    • args.allow_copiers Number Boolean value 1 or 0, indicating permission to allow others to follow your trades. Note: not applicable for Virtual account. Only allow for real money account.
    • args.citizen Any Country of legal citizenship, 2-letter country code.
    • args.date_of_birth String Date of birth format: yyyy-mm-dd (can only be changed on unauthenticated svg accounts).
    • args.email_consent Number Boolean value 1 or 0, indicating permission to use email address for any contact which may include marketing
    • args.first_name String Within 2-50 characters, use only letters, spaces, hyphens, full-stops or apostrophes (can only be changed on unauthenticated svg accounts).
    • args.last_name String Within 2-50 characters, use only letters, spaces, hyphens, full-stops or apostrophes (can only be changed on unauthenticated svg accounts).
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.phone Any Note: not applicable for virtual account. Required field for real money account and within 8-35 digits, allowing '+' in front, numbers, hyphens or space.
    • args.place_of_birth String Place of birth, 2-letter country code.
    • args.req_id Number Optional field to map request to response
    • args.request_professional_status Number Required when client wants to be treated as professional. Applicable for financial accounts only.
    • args.residence Any 2-letter country code. Note: not applicable for real money account. Only allow for Virtual account without residence set.
    • args.salutation Any Accept any value in enum list (can only be changed on unauthenticated svg accounts).
    • args.secret_answer String Answer to secret question, within 4-50 characters. Required for new account and existing client details will be used if client opens another account.
    • args.secret_question Any Accept any value in enum list. Required for new account and existing client details will be used if client opens another account.
    • args.set_settings Number -
    • args.tax_identification_number String Tax identification number. Only applicable for real money account. Required for maltainvest landing company.
    • args.tax_residence String Residence for tax purpose. Comma separated iso country code if multiple jurisdictions. Only applicable for real money account. Required for maltainvest landing company.

statement

Parameters

  • args Object (optional, default {})
    • args.action_type String Optional filter for statement (deposit,withdrawal,buy,sell)
    • args.date_from Number Optional start date (epoch)
    • args.date_to Number Optional end date (epoch)
    • args.description Number If set to 1, will return full contracts description.
    • args.limit Number Apply upper limit to count of transactions received
    • args.offset Number Skip this many transactions
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.statement Number Must be 1.

statesList

Parameters

  • args Object (optional, default {})
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.
    • args.states_list String Client's 2-letter country code (obtained from residence_list call)

ticks

Parameters

  • args Object (optional, default {})
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.
    • args.subscribe Any If set to 1, will send updates whenever a new tick is received.
    • args.ticks Any The short symbol name or array of symbols (obtained from active_symbols call).

ticksHistory

Parameters

  • args Object (optional, default {})
    • args.adjust_start_time Number [Optional] 1 - if the market is closed at the end time, or license limit is before end time, adjust interval backwards to compensate.
    • args.count Number An upper limit on ticks to receive.
    • args.end String Epoch value representing the latest boundary of the returned ticks. If "latest" is specified, this will be the latest available timestamp.
    • args.granularity Number Only applicable for style : "candles". Candle time-dimension width setting. Allowed values 60, 120, 180, 300, 600, 900, 1800, 3600, 7200, 14400, 28800, 86400 (default: '60').
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.
    • args.start Number Epoch value representing the earliest boundary of the returned ticks (For styles: 'ticks', this will default to 1 day ago. For styles: 'candle', it will default to 1 day ago if count or granularity is undefined).
    • args.style Any The tick-output style.
    • args.subscribe Any [Optional] 1 - to send updates whenever a new tick is received.
    • args.ticks_history String Short symbol name (obtained from the active_symbols call).

time

Parameters

  • args Object (optional, default {})
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.
    • args.time Number Must be 1.

tncApproval

Parameters

  • args Object (optional, default {})
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.tnc_approval Number Must be 1
    • args.ukgc_funds_protection Number for ASK_UK_FUNDS_PROTECTION in cashier

topupVirtual

Parameters

  • args Object (optional, default {})
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.topup_virtual Number it's only allowed for virtual account.

tradingDurations

Parameters

  • args Object (optional, default {})
    • args.landing_company Any [Optional] If specified, will return only the underlyings for the specified landing company.
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.
    • args.trading_durations Number Must be 1.

tradingTimes

Parameters

  • args Object (optional, default {})
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.
    • args.trading_times String Date to receive market opening times for. (yyyy-mm-dd format. 'today' can also be specified).

transaction

Parameters

  • args Object (optional, default {})
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.subscribe Number If set to 1, will send updates whenever there is an update to transactions. If not to 1 then it will not return any records.
    • args.transaction Any Must be 1.

transferBetweenAccounts

Parameters

  • args Object (optional, default {})
    • args.account_from String The account_from loginid
    • args.account_to String The account_to loginid
    • args.accounts Any Optional field to control the list of accounts returned when account_from or account_to is not provided. 'Brief' will only include standard trading accounts and can be faster.
    • args.amount Number -
    • args.currency String -
    • args.passthrough Any Optional field, used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number Optional field to map request to response
    • args.transfer_between_accounts Number If account_from or account_to is not provided, we'll just return available accounts.

verifyEmail

Parameters

  • args Object (optional, default {})
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.
    • args.type Any Purpose of the email verification call.
    • args.url_parameters Any -
    • args.verify_email String Email address to be verified.

websiteStatus

Parameters

  • args Object (optional, default {})
    • args.passthrough Any [Optional] Used to pass data through the websocket, which may be retrieved via the echo_req output field.
    • args.req_id Number [Optional] Used to map request to response.
    • args.subscribe Any [Optional] 1 - to stream the server/website status updates (default = 1)
    • args.website_status Any Must be 1.

InMemory

An in memory storage which can be used for caching

TransactionParams

Type: Object

Immutable

An abstract class for immutable objects

Parameters

  • props Object A list of properties to add for the immutable object (optional, default {})

init

Override to initialize an immutable object asynchronously

ExpiryType

Type: Object

Properties

ContractCategory

Type: Object

Properties

Stream

Extends Immutable

An abstract class for stream objects

Parameters

  • args

onUpdate

Listen on updates of a stream

Parameters

Examples

const tick_stream = api.tickStream('R_100');

tick_stream.onUpdate(console.log);

tick_stream.onUpdate().subscribe(console.log);

Returns Observable