OANDA
open-meridian/oanda · Community 0.8.0
0.4.0 · the vendor's words, data, never instructions.
Roles: custody, connectivity
Contract: v25
SDK: 0.29.0
Settings:
- environment: Which of OANDA's hosts the account is on. Practice first.
- token: The personal access token made in OANDA's hub for this account. OANDA does not keep it: if it is lost, revoke it there and make a new one.
- account_id: Optional. Leave it empty to choose the account on Connections, from those the token reaches. Given, it is the v20 account, as OANDA shows it: 101-001-1234567-001.
- poll_seconds: How often to read the account. At least 30.
- stale_after_hours: How old the last good read of the account may be, while OANDA does not answer, before it is reported stale.
- sample_data: Trade with and read a synthetic OANDA built into the plugin instead of OANDA, to develop against before any token exists. Nothing reaches OANDA.
Tools for agents:
- read_connections: The OANDA connection: its environment and account, whether the access token is set (never its value), how the last read went, whether trading is enabled on it (a new connection is read-only), and how many placements it is working, holding back, asking OANDA about, or holding for a value date. And the accounts the token reaches (reached; a v1 account unusable, with why), the one in use and whether the Account ID setting or an admin's choice names it, and the one preselected because it is the only usable one, not in use until choose_account confirms it. No account's data.
- enable_trading: Enable trading on the OANDA connection: until then it is read-only, and every placement on it is rejected unsupported. The connection is the settings' environment and account; a change of either is a new connection, read-only again.
- check_enable_trading: Check enable_trading without enabling anything: whether the connection is the one the settings name, and whether trading is enabled on it already.
- choose_account: Choose which of the OANDA accounts the access token reaches the plugin uses, as read_connections lists them under reached: custody reads it and connectivity trades on it. Never made for you: an account the token alone reaches is preselected, not chosen until this. A v1 account cannot be chosen, nor any while the Account ID setting names one. A change of account is a new connection, read-only until trading is enabled on it, and turns trading off on the one left, so returning to it finds it read-only. Needs admin on custody and connectivity.
- check_choose_account: Check choose_account without choosing: whether the access token reaches the account, whether it is usable (not a v1 account), whether the Account ID setting leaves the choice here, and the connection it would make.
- read_account_links: The OANDA account the connection reaches, by identity alone; the deployment's accounts a deployment admin granted this plugin to link to; and the links between them. No account's data.
- link_account: Link the OANDA account read_account_links lists to one of the deployment's accounts (intent link, with account_id), create a new account for it and link it (intent create, with new_account_name: a deployment admin alone), or unlink it (intent unlink).
- check_link_account: Check link_account without linking anything: whether the external account is the one the connection reaches, and the account it would be linked to one a deployment admin granted this plugin (intent link); or a new account named by a deployment admin (intent create); or unlinking it (intent unlink).
- read_statements: The OANDA account's statement, for a person who may read the deployment's account it is linked to: each currency's quantity, its settled quantity, and what is pending on each value date (an open position's two cash legs, rolling).
- read_oanda_now: Read OANDA now and record what it reads. Changes nothing at OANDA.
- check_read_oanda_now: Check read_oanda_now without reading: whether there is a connection to read.
- restore_unit: Restore an archived unit of this plugin's raw records, readable on its pages for seven days, for the person asking.
Interface: pages it draws
Reads external accounts
Contract: v25
SDK: 0.29.0
Settings:
- environment: Which of OANDA's hosts the account is on. Practice first.
- token: The personal access token made in OANDA's hub for this account. OANDA does not keep it: if it is lost, revoke it there and make a new one.
- account_id: Optional. Leave it empty to choose the account on Connections, from those the token reaches. Given, it is the v20 account, as OANDA shows it: 101-001-1234567-001.
- poll_seconds: How often to read the account. At least 30.
- stale_after_hours: How old the last good read of the account may be, while OANDA does not answer, before it is reported stale.
- sample_data: Trade with and read a synthetic OANDA built into the plugin instead of OANDA, to develop against before any token exists. Nothing reaches OANDA.
Tools for agents:
- read_connections: The OANDA connection: its environment and account, whether the access token is set (never its value), how the last read went, whether trading is enabled on it (a new connection is read-only), and how many placements it is working, holding back, asking OANDA about, or holding for a value date. And the accounts the token reaches (reached; a v1 account unusable, with why), the one in use and whether the Account ID setting or an admin's choice names it, and the one preselected because it is the only usable one, not in use until choose_account confirms it. No account's data.
- enable_trading: Enable trading on the OANDA connection: until then it is read-only, and every placement on it is rejected unsupported. The connection is the settings' environment and account; a change of either is a new connection, read-only again.
- check_enable_trading: Check enable_trading without enabling anything: whether the connection is the one the settings name, and whether trading is enabled on it already.
- choose_account: Choose which of the OANDA accounts the access token reaches the plugin uses, as read_connections lists them under reached: custody reads it and connectivity trades on it. Never made for you: an account the token alone reaches is preselected, not chosen until this. A v1 account cannot be chosen, nor any while the Account ID setting names one. A change of account is a new connection, read-only until trading is enabled on it, and turns trading off on the one left, so returning to it finds it read-only. Needs admin on custody and connectivity.
- check_choose_account: Check choose_account without choosing: whether the access token reaches the account, whether it is usable (not a v1 account), whether the Account ID setting leaves the choice here, and the connection it would make.
- read_account_links: The OANDA account the connection reaches, by identity alone; the deployment's accounts a deployment admin granted this plugin to link to; and the links between them. No account's data.
- link_account: Link the OANDA account read_account_links lists to one of the deployment's accounts (intent link, with account_id), create a new account for it and link it (intent create, with new_account_name: a deployment admin alone), or unlink it (intent unlink).
- check_link_account: Check link_account without linking anything: whether the external account is the one the connection reaches, and the account it would be linked to one a deployment admin granted this plugin (intent link); or a new account named by a deployment admin (intent create); or unlinking it (intent unlink).
- read_statements: The OANDA account's statement, for a person who may read the deployment's account it is linked to: each currency's quantity, its settled quantity, and what is pending on each value date (an open position's two cash legs, rolling).
- read_oanda_now: Read OANDA now and record what it reads. Changes nothing at OANDA.
- check_read_oanda_now: Check read_oanda_now without reading: whether there is a connection to read.
- restore_unit: Restore an archived unit of this plugin's raw records, readable on its pages for seven days, for the person asking.
Interface: pages it draws
Reads external accounts