Search…
Tradologics CLI
Meet tctl - Tradologics' command-line utility
For those who live inside the terminal, we made available a command-line tool named
tctl (stands for Tradologics Controller), which simplifies your development workflow by allowing you to communicate with the Tradologics cloud.While
tctl is yet another way of working with Tradologics - it's important to note that it does not perform anything that you cannot do by using the web console or "vanilla" API calls, as they are all merely clients for our API.Installation
To use
tctl you'll need to have Python 3.6 (and pip) installed on your system. Once you have both on your system, simply execute the following command in your terminal of choice:1
$ pip3 install -U tctl
Copied!
Next, run
tctl config to set up your tctl to work in conjunction with your account by providing your account's API key and Secret key.If you're using Windows, you'll need to launch the Command Prompt with admin privileges in order to configure
tctl. Once configured, you can use the Command Prompt as usual.1
$ tctl config
2
3
-----------------------------------------------------
4
_______ _ _ _
5
|__ __| | | | | (_)
6
| |_ __ __ _ __| | ___ | | ___ __ _ _ ___ ___
7
| | '__/ _` |/ _` |/ _ \| |/ _ \ / _` | |/ __/ __|
8
| | | | (_| | (_| | (_) | | (_) | (_| | | (__\__ \
9
|_|_| \__,_|\__,_|\___/|_|\___/ \__, |_|\___|___/
10
__/ |
11
T R A D I N G C L O U D |___/
12
13
-----------------------------------------------------
14
tctl 0.0.45 - Tradologics Controller
15
-----------------------------------------------------
16
17
HELLO 👋
18
19
tctl (Tradologics' Controller) helps you access
20
and control various aspects of your account.
21
22
To get started, make sure you have your API Key
23
and Secret Key handy in order to configure tctl.
24
25
Let's get started...
26
27
-----------------------------------------------------
28
29
[?] API Key : *****************
30
[?] API Secret : *************************************
31
32
...
33
34
SUCCESS 🎉
35
36
`tctl` is now configured!
Copied!
Getting around
Most of
tctl commands are structured in the following format:1
$ tctl COMMAND ACTION --OPTIONS|-O
Copied!
To view available commands, simply type
tctl :1
$ tctl
2
3
Usage: tctl COMMAND ACTION [ARGS]...
4
5
Options:
6
--help Show this message and exit.
7
8
Commands:
9
assets List assets with misc.
10
brokers Access exchange and calendar information
11
config Initialize, authorize, and configure the tctl tool
12
connections List, create, update, or delete connections
13
exchanges Access exchange and calendar information
14
instances List, retrieve, modify, delete, create research instances
15
logo Displays Tradologics logo as ASCII art :)
16
me Get customer information, usage and billing
17
monitors List, create, update, or delete monitors
18
orders List, create, update, or cancel orders
19
positions Retreive position history with filtering options
20
price Retreive asset's price-related information
21
rates Retreive currency exchange rates
22
sandbox Send Tradehooks to a URL for development testing
23
strategies List, create, update, delete, deploy, start/stop strategies
24
tokens List, create, extend, or delete tokens
25
tradehooks List, create, update, or delete Tradehooks
26
trades Retreive trade history with filtering options
27
upgrade Upgrade tctl to the latest version
28
volumes List, retrieve, modify, delete, create research volumes
Copied!
To view available actions for a specific command, type:
1
$ tctl COMMAND
Copied!
For example:
1
$ tctl connections
2
Usage: tctl connections ACTION [OPTIONS]...
3
4
Available actions:
5
6
- list|ls Retreive connections list
7
- info Show connection information: --connection|-c {CONNECTION_ID}
8
- new Create new connection
9
- update|patch Update existing connection: --connection|-c {CONNECTION_ID}
10
- delete|rm Delete connection: --connection|-c {CONNECTION_ID}
Copied!
Conventions
- The pipe character (
|) means "or" – For example, the snippet:list|lstranslates into "you can use eitherlistorls", and for this additional snippet:--connection|-c, this translates into "you can use either--connection CONNECTION_IDor-aCONNECTION_ID``". Simply put, the pipe character (|) represents the "or" in a given statement. - Params with required input are marked with curly brackets (i.e.
--connection|-a {CONNECTION_ID}). Otherwise, they are just flags (i.e.--show-idsintctl tradehooks ls). - Params wrapped by
[]are optional (i.e.[--start {YYYY-MM-DD}]).
TIP: Appending
--raw to any command will display the API's response in raw JSON format. Otherwise, tabular data will be displayed.Common identifiers
--connection|-cconnection-id--order|-oorder-id--broker|-bbroker-id--tradehook|-ttradehook-id--strategy|-sstrategy-id--monitor|-mmonitor-id--exchange|-eexchange-mic--version|-vstrategy's version-id
Common filters
--start {DATE|DATE-TIME}- Filter results to show from this day or this date-time onwards.--end {DATE|DATE-TIME}- Filter results to show until this day or this date-time.-- strategies {STRATEGY_ID,STRATEGY_ID,...}- Filter results to include positions/orders/trades from these strategies only.--connections {CONNECTION_ID,CONNECTION_ID,...}- Filter results to include positions/orders/trades from these connections only.--brokers {BROKER_ID,BROKER_ID,...}- Filter results to include positions/orders/trades from these brokers only.
Common flags
--decode- Instructstctlto decode the data returned (i.e. for tokens and strategy codes).--show-ids- Shows object ids (some objects with very long ids aren't displayed by default for readability).--history- Retrieves an asset's history and indicates whether that asset has had a past name/ticker/exchange changes (fortctl assets info --asset {ASSET}).--delisted- Include delisted assets in the results.--unadjusted- Return/use unadjusted prices (back-adjusted prices are returned by default).--raw- Display the API's response in raw JSON format. Otherwise, tabular data will be displayed.
Last modified 1mo ago