> For the complete documentation index, see [llms.txt](https://guide.ssi.com.vn/ssi-products/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.ssi.com.vn/ssi-products/general-information.md).

# General Information

## Service Registration

To start using FastConnect API, you need to register with us. 

Follow the registration steps [here](#service-registration).

## API connection key 

To access APIs and streaming hub, you will need a set of connection keys provided by SSI, including: 

* ConsumerID
* ConsumerSecrect
* PrivateKey

Refer to [this page](#service-registration) regarding to connection key creation. 

**Note:** Connection key is confidential information, shown only to you once when you create a new key on our SSI iBoard. Please store it carefully and never share it to ANYONE. 

{% hint style="info" %}
If the API keys were accidentally shared, please delete them immediately and create a new key. 
{% endhint %}

## Sample Client

{% hint style="info" %}
We support sample clients written in **Python** and **Node.js** to help you quickly get to know the APIs. Sample clients can be downloaded at the following links.  
{% endhint %}

### Python

**FC Data**

<https://github.com/SSI-Securities-Corporation/python-fcdata/releases/latest/download/fc-data.py.zip>

**FC Trading**

<https://github.com/SSI-Securities-Corporation/python-fctrading/releases/latest/download/fc-trading.py.zip>

### Node.js

#### FC Data

<https://github.com/SSI-Securities-Corporation/node-fcdata/releases/latest/download/fc-data.zip>

#### FC Trading

[https://github.com/SSI-Securities-Corporation/node-fctrading/releases/latest/download/fc-trading.zip](https://github.com/SSI-Securities-Corporation/node-fcdata/releases/latest/download/fc-data.zip)

## **Java**

**FC Data**

<https://gitlab.ssi.com.vn/developer-2-public/java-fcdata>

**FCTrading**

<https://gitlab.ssi.com.vn/developer-2-public/java-fctrading>

Refer to [FC data sample client guide](/ssi-products/fastconnect-data/sample-client-guide.md) and [FC trading sample client guide](/ssi-products/fastconnect-trading/sample-client-guide.md) for more details.&#x20;

## .Net

**FC Data**

[**https://github.com/SSI-Securities-Corporation/dotnet-fcdata.git**](https://github.com/SSI-Securities-Corporation/dotnet-fcdata.git)

**FC Trading**

[**https://github.com/SSI-Securities-Corporation/dotnet-fctrading.git**](https://github.com/SSI-Securities-Corporation/dotnet-fctrading.git)

## Limits

There is a limit on the number of requests sent to system per interval (rate limit). The rate limit is applied to each API. If you send more than this limit, an error message will be sent back.&#x20;

* For FC Trading, the limit is counted on each account.&#x20;
* For FC Data, the limit is counted on each connection key.&#x20;

Sample error message for rate limit violation:

* Regarding API: <mark style="color:orange;">"API calls quota exceeded! maximum admitted x per y s"</mark>
* Regarding streaming: <mark style="color:orange;">"Connection has been blocked, quota x exceeded by y"</mark>

If you request to increase the rate limit value, please contact to your account executive.&#x20;

{% hint style="info" %}
To receive real-time update, you should use streaming connection rather than using API for polling to avoid rate limit violation. &#x20;
{% endhint %}

## Term

When you first register, the service will be effective till 1 year after. After this expiration date, the key cannot be used to connect to the system. Error message is: { message: 'The connection is invalid', status: 400, data: null }

You need to renew to continue using the service. Refer to this page regarding to service renewal.&#x20;

{% hint style="info" %}
SSI sends a email to notify you 7 days before the expiration date. If you don't find the email, please check the junk box.&#x20;
{% endhint %}

## Digital Signature

Digial Signature is a string generated by a given algorithm, used to check the correctness of data on transmission lines between two systems. Some of the algorithms in use are MD5, SHA1, SHA256 and [Hmac](https://en.wikipedia.org/wiki/HMAC).\
Refer to [Wikipedia](https://en.wikipedia.org/wiki/HMAC) for more details.&#x20;

SSI uses RSA + SHA256 to create Signature. Input data includes Secret Key and data, of which, data is a json body with placing/amend/cancel order.&#x20;