Tokens

Methods to receive data by tokens

Get the list of tokens

Method returns the list of supported tokens.

GET https://api.web3watcher.fi/v1/tokens/list

List of names for tokens that you can use inside of the others requests.

Request Body

Name	Type	Description
offset	int	the number of tokens per page
page	int	num of page

200 Pet successfully created

{
    "status":"200",
    "message":"Success",
    "result":[
        {
        "token_symbol": "eth",
        "token_symbol": "steth",
        "token_symbol": "ldo",
        "token_symbol": "matic",
        "token_symbol": "crv",
        },
    ],
    "offset": 5,
    "page": 1,
}

401 Permission denied

{
    "status":"401",
    "message":"Permission denied",
    "result":[],
    "offset": 5,
    "page": 1,
}

Get the token overview

Method returns the overview and current metrics for token.

GET https://api.web3watcher.fi/v1/tokens/list/{token_symbol}

The data is represented for the current time.

Request Body

Name	Type	Description
token_symbol*	string	symbol of token from token list

200 Pet successfully created

{
    "status":"200",
    "message":"Success",
    "result":[
        {
        "token_symbol": "eth",
        "freshness_date": "2023-10-18 01:00:00:0000",
        "token_price": 1565.38,
        "token_supply": 120261074.81,
        "token_type": "erc-20",
        "defi_in":[
                {
                "defi_name":"lido",
                "defi_contract":"0xae7ab96520de3a18e5e111b5eaab095312d7fe84",
                },
                {
                "defi_name":"curve",
                "defi_contract":"0xD533a949740bb3306d119CC777fa900bA034cd52",
                },
                ...
        ],
        },
    ]
}

401 Permission denied

{
    "status":"401",
    "message":"Permission denied",
    "result":[],
}

Get the token liquidity

Method returns the list of liquidity positions in deFi/CEXes.

GET https://api.web3watcher.fi/v1/tokens/liquidity/{token_symbol}

The data is represented for the current time.

Request Body

Name	Type	Description
token_symbol*	string	symbol of token from token list
liquidity_category	string	dex / cex / lending-borrowing / bridges
offset	int	number of positions of liquidity per page
pagination	int	num of page

200 Pet successfully created

{
    "status":"200",
    "message":"Success",
    "result":[
        {
        "token_symbol": "eth",
        "freshness_date": "2023-10-25 17:25:35:0000",
        "liquidity_category": "dex",
        "positions": [
            {
                "position_id": "0xdc24316b9ae028f1497c275eb9192a3ea0f67022",
                "position_name": "eth-steth",
                "position_current_daily_apy": 0.0193,
                "defi_name": "curve",
                "liquidity" : [
                    {
                        "token_symbol": "eth",
                        "token_amount": 59980.91841,
                        "token_price": 1792.89,
                    },
                    {
                        "token_symbol": "steth",
                        "token_amount": 60736.6184,
                        "token_price": 1788.11,
                    },
                ],
            },
        ],
        },
    ],
    "offset": 1,
    "pagination": 1,
}

401 Permission denied

{
    "status":"401",
    "message":"Permission denied",
    "result":[],
    "offset": 1,
    "pagination": 1,
}

Get the liquidity history

Method returns the history of liquidity for the particular position.

GET https://api.web3watcher.fi/v1/tokens/positions/{position_id}

Historical data for positions which you may receive by previous method.

Request Body

Name	Type	Description
position_id*	string	The address of the pool / bridge / cex
offset	int	the number of rows for history data
pagination	int	num of page

200 Pet successfully created

{
    "status":"200",
    "message":"Success",
    "result":[
        {
        "token_symbol": "eth",
        "freshness_date": "2023-10-25 17:25:35:0000",
        "liquidity_category": "dex",
        "position_id": "0xdc24316b9ae028f1497c275eb9192a3ea0f67022",
        "position_name": "eth-steth",
        "defi_name": "curve",
        "position_daily_apy": 0.0193,
        "liquidity_history":[
            {
            "token_symbol": "eth",
            "token_amount": 59980.91841,
            "token_price": 1792.89,
            },
            {
            "token_symbol": "steth",
            "token_amount": 60736.6184,
            "token_price": 1788.11,
            },
                ],
        },
        {
        "token_symbol": "eth",
        "freshness_date": "2023-10-25 17:20:00:0000",
        "liquidity_category": "dex",
        "position_id": "0xdc24316b9ae028f1497c275eb9192a3ea0f67022",
        "position_name": "eth-steth",
        "defi_name": "curve",
        "position_daily_apy": 0.0192,
        "liquidity_history":[
            {
            "token_symbol": "eth",
            "token_amount": 59979.293,
            "token_price": 1791.36,
            },
            {
            "token_symbol": "steth",
            "token_amount": 60678.537,
            "token_price": 1787.98,
            },
            ],
         },
    ],
    "offset": 2,
    "pagination": 1,
}

401 Permission denied

{
    "status":"401",
    "message":"Permission denied",
    "result":[],
    "offset": 2,
    "pagination": 1,
}