Quick Start

Good to know: A quick start guide can be good to help folks get up and running with your API in a few steps. Some people prefer diving in with the basics rather than meticulously reading every page of documentation!

Get your API keys

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.

You can generate an API key from your Dashboard at any time.

General Api Information

The following base endpoint:

Derivative

https://fapi.api.fixt.io

Spot

https://sapi.fixt.io
https://sapi.finextree.com

• All endpoints return either a JSON object or array.

• All time and timestamp related fields are in milliseconds.

HTTP Return Codes

• HTTP 4XX return codes are used for malformed requests; the issue is on the sender's side.

• HTTP 403 return code is used when the WAF Limit (Web Application Firewall) has been violated.

• HTTP 5XX return codes are used for internal errors; the issue is on FIXT's side. It is important to NOT treat this as a failure operation; the execution status is UNKNOWN and could have been a success.

Error Codes and Message

• If there is an error, the API will return an error with a message of the reason.

• Specific error codes and messages defined in Error Codes.

General Information on Endpoints

• For GET endpoints, parameters must be sent as a query string.

• For POST, PUT, and DELETE endpoints, the parameters may be sent as a query string or in the request body with content type application/x-www-form-urlencoded. You may mix parameters between both the query string and request body if you wish to do so.

• Parameters may be sent in any order.

• If a parameter sent in both the query string and request body, the query string parameter will be used.

Make your first request

To make your first request, please request the contract endpoint below.

Contracts

GET https://fapi.api.finextree.com/api/v0/market/contracts

Returns all Contracts information.

Response Body

Name	Type	Description
ticker_id	string	Identifier of a ticker with delimiter to separate base/quote, eg. BTC-USDT
base_currency	string	Symbol/currency code of base pair, eg. BTC
quote_currency	string	Symbol/currency code of quote pair, eg. ETH
last_price	decimal	Last transacted price of base currency based on given quote currency
base_volume	decimal	24 hour trading volume in BASE currency
usd_volume	decimal	24 hour trading volume in USD
quote_volume	decimal	24 hour trading volume in QUOTE currency
bid	decimal	Current highest bid price
ask	decimal	Current lowest ask price
high	decimal	Rolling 24-hour highest transaction price
low	decimal	Rolling 24-hour lowest transaction price
product_type	string	Futures, Perpetual, Options
open_interest	decimal	The number of outstanding derivatives contracts that have not been settled
open_interest_usd	decimal	The sum of the Open Positions (long or short) in USD Value of the contract
index_price	decimal	Last calculated index price for underlying of contract
funding_rate	decimal	Current funding rate

200

{
    "status":"true",
    "msg":"success",
    "result": [
        {
            "ticker_id": "BTC_USDT",
            "base_currency": "BTC",
            "quote_currency": "USDT",
            "last_price": 70000,
            "base_volume": 1,
            "quote_volume": 70000,
            "usd_volume": 70000,
            "bid": 70000,
            "ask": 70000,
            "high": 71000,
            "low": 69000,
            "product_type": "Perpetual",
            "open_interest": 70000,
            "open_interest_usd": 70000,
            "index_price": 70000,
            "funding_rate": 0.000024,
            "newxt_funding_timestap": 1713398400000,
            "maker_fee": 0.0008,
            "taker_fee": 0.001,
        }, ... , ...
    ]
}