Token

Token Form requires basic details such as issuer name, issuer email, website, including token addess(required for Blocksscan API) and data api field.

Data API field

The Data API on Token Form is required as investment capacity of the token is expected, while rewards consists of object of rate and reward token, in case reward is not available then pass empty object.

GET https://api.myapi.com/get-rewards-details-by-token-address/:token-address

Gets investment capacity and rewards from the token address

Request Body

Name	Type	Description
rewards*	Object	Object containing rate and reward token
investment_capacity*	float/int	Investment Capacity for the token
rate	Float	APY rate of reward token
reward_token	String	Reward token name

200: OK Token successfully created

Example

{
    "investment_capacity": 100000,
    "reward": [
        {
            "reward_rate": 0.2,
            "reward_token": "stable fiat/WSP"
        }
    ]
}

Blocksscan Api's rendered from token address provided in the Token Form.

Please check that API are rendering data properly, else validation error is thrown.

To fetch the token symbol, price and total supply

GET https://xdc.blocksscan.io/api/tokens/token_address

You can check your api data from blockscsan https://xdc.blocksscan.io/docs/#/Tokens/get_api_tokens__hash_

Request Body

Name	Type	Description
symbol*	float	The token symbol
totalSupplyNumber*	String	The total supply of the token
priceUSD*	float	The price of token in USD

200: OK Token successfully created

400: Bad Request Token Validations Failed. Recheck the API fields' types

{
    // Response
}

CoinGeko ID feild

Provide the string id of the token available on coinGecko. This API is to fetch the price history of the token from the range of token launched till upto date. The API is called on platform, hence user is only expected to provide valid CoinGecko ID. Please check below if the API are rendering data properly.

GET https://api.coingecko.com/api/v3/coins/${coingecko_id}/market_chart/range?vs_currency=usd&from=${startDate}&to=${today}

https://www.coingecko.com/en/api/documentation

Headers

Name	Type	Description
id*	String	token id aailable on Coingecko
from*	String	From date in UNIX timestamp
to*	String	to date in UNIX timestamp
vs_currency*	String	The target currency of the market data. In Tradefinex it is always set to USD

Price API field

When Token Form is submitted, blocksscan api is called using the provided token address and stored in database. Incase, price is not fetched from Blocksscan, user is required to submit a separate API, as shown below in Price API field in request Token form.

GET https://api.myapi.com/get-token-details-by-token-address/:token-address

Gets price from the token address

All parameters are required, send 0 incase if it is Not Applicable

Request Body

Name	Type	Description
priceUSD*	float/int	The token price in USD

200 Token successfully created

{
    "priceUSD":150000
}

404: Not Found Token Validations Failed. Recheck the API fields' types