Quick Start

It is required to deposit funds in the tiger account in advance, before the developer accesses the open platform. After the deposit, you can register as a developer.

Register Developer Information

Developer registration address：https://www.tigersecurities.com/openapi/info

Required information for Registration：

Field	Description	If required
Public Key	RSA public key, used to verify the identity of the developer, public key generation can refer to:RSA key generation	Yes
IPwhitelist	Only the IP in the whitelist can access the API, and multiple IPs are separated.	No
Callback URL	The user application's callback address, which can receive order status change messages as well as change messages for positions and assets. Callback information can also be received through the subscription interface provided by the SDK.	No

Return the following information after registration：

tigerId： Used to uniquely identify a developer that is required when requesting an API.
account： It is used to distinguish the user's account type, and the user can select the corresponding account type when trading. Account types include: Global Account / Standard Account / Demo Account.

Through tigerId，privateKey，account and related information can be used for SSK socket transfer. SDK implementations currently available on open platforms include: Java and Python

SDK Code acquisition

Java developers can get code through the Maven repository:

  <dependency>
    <groupId>io.github.tigerbrokers</groupId>
    <artifactId>openapi-java-sdk</artifactId>
    <version>1.0.8</version>
  </dependency>

Github code address：

Java SDK Call Example

Take the order number interface as an example:

/**
* tigerId：Can be found on the developer information page
* privateKey: RSA private key corresponding to the uploaded public key
**/
TigerHttpClient client = new TigerHttpClient(serverUrl, tigerId, privateKey);
TigerHttpRequest request = new TigerHttpRequest(ApiServiceType.ORDER_NO);

String bizContent = TradeParamBuilder.instance()
    .account("DU575569")  //account can be found on the developer information page
    .buildJson();

request.setBizContent(bizContent);
TigerHttpResponse response = client.execute(request);

Response return sample:

{
    "code":0,
    "message": "success",
    "timestamp": 1530173419060,
    "data": {
        "orderId":105432
    }
}

RSA Key Generation

The generation of public and private keys depends on openssl, which can be installed via brew.

brew install openssl

linux：

sudo apt-get install openssl

The installation for windows is difficult. Please refer to the openssl official website or use the online generation tool as reference. For specific tools, please search for the keyword "RSA certificate online generation".

After installing openssl, please refer to the code below to generate the public and private keys. The private key user is stored locally and is used to sign the content when requesting the server.The public key needs to be uploaded on the open platform to authenticate the user's request. Note The number of generated key bits is 1024

//  Generate private key
openssl genrsa -out rsa_private_key.pem 1024 

// Java Developers need to convert the private key to PKCS8 format, which is not required for the Python SDK.
openssl pkcs8 -topk8 -inform PEM -in rsa_private_key.pem -outform PEM -nocrypt 

// Generating a public key
openssl rsa -in rsa_private_key.pem -pubout -out rsa_public_key.pem

Note, Java and the Python SDK use a different private key format. When using the SDK, you should check the correct format of the private key.

The private key used by Java is in PKCS#8 format. JAVA developers need to handle the private key as follows

Remove the front and end, line breaks, and spaces from the private key that pkcs8 outputs in the console as the developer private key.
After the above steps, the developer retains the private key (the private key printed on the console) and submits the public key (stored in the rsa_public_key.pem file) to the open platform for information encryption and decryption.

The private key before processing is as follows

The private key used by the Python SDK is the PKCS#1 RSA format, as shown in the following

Provide feedback

Saved searches

Use saved searches to filter your results more quickly