Tick Prices

GET https://api.syve.ai/v1/price/historical/tick

Use this endpoint to return tick prices of a token.

Method: GET

Endpoint: https://api.syve.ai/v1/price/historical/tick

📘

What are tick prices?

• Each tick corresponds to the token price observed in an individual trade.
• Tick prices are the most granular level which price can be observed.
• Unlike OHLC data tick prices are not aggregated over an interval.

Request Parameters

Name	Type(s)	Description
token_address	string	This is the address of the token for which the Open-High-Low-Close (OHLC) prices will be fetched. The address should be a valid Ethereum token address. Multiple addresses can be provided as a comma-separated string. This is a required parameter.
pool_address	integer	This is the address of the liquidity pool from which the OHLC prices will be fetched. Multiple addresses can be provided as a comma-separated string. This is a required parameter.
chain	string	The chain of token_address. The default is eth. Valid options are: eth, matic.
price_type	string	This parameter determines what price to use to create OHLC with. The default is price_token_usd_robust_tick_1. Possible options: price_token_usd_tick_1.
from_timestamp	integer	Return results whose timestamp are greater than or equal to the provided value. The default value is 10 periods before until_timestamp, where the period depends on the interval chosen.
until_timestamp	integer	Return results whose timestamp are less than or equal to the provided value. The default value is the current timestamp (at the time the request is made).
size	integer	The number of records to return. The default is 100 and the maximum is 100,000.

Response Fields

Name	Type	Description
block_number	integer	The block number (i.e. height) of the event log.
timestamp	integer	UNIX timestamp in seconds. The zero value corresponds to the 1st of January 1970 at UTC, called the Unix Epoch.
transaction_hash	string	The transaction has of the transaction that the DEX trade happened in.
price_usd	double	The price of the token denominated in dollars.
amount_token	double	The amount of the token that was traded.

Example: Latest tick prices for $UNIBOT

📘

Try it out

In the Live Example section you can try out the request with different arguments.

Query

cURL

curl --location 'https://api.syve.ai/v1/price/historical/tick'\
'?token_address=0xf819d9cb1c2a819fd991781a822de3ca8607c3c9'\
'&size=5'

Here 0xf819d9cb1c2a819fd991781a822de3ca8607c3c9 is the address of $UNIBOT token.

Try in Postman: https://www.postman.com/dark-equinox-191074/workspace/syve-examples/request/11895150-b22b1e0f-ff3e-4e02-a933-1dc25b14e1ee?ctx=documentation

Response

JSON

{
    "token_address": "0xf819d9cb1c2a819fd991781a822de3ca8607c3c9",
    "token_symbol": "UNIBOT",
    "token_name": "Unibot",
    "data": [
        {
            "block_number": 17820650,
            "timestamp": 1690898891,
            "transaction_hash": "0xf8b2c6ab983bcae3377eee1af8943363308d67d71d1e1678a57b5e9e0b217517",
            "price_usd": 110.38152066430426,
            "price_eth": 0.06022638664738673,
            "amount_token": 50.28756828502846
        },
        {
            "block_number": 17820646,
            "timestamp": 1690898843,
            "transaction_hash": "0x94deeead3c16a23fcf09c725e96adc01532c6e6c0ae7d5dc23f236d3d841351e",
            "price_usd": 111.00904231533418,
            "price_eth": 0.06056931234955116,
            "amount_token": 84.19545124407968
        },
        {
            "block_number": 17820643,
            "timestamp": 1690898807,
            "transaction_hash": "0x4bc03d683db845898dff29685473c45bfdd4a6669b17979d94bd706aa66e7dc8",
            "price_usd": 111.85412044474869,
            "price_eth": 0.06103057958241919,
            "amount_token": 95.0
        },
        {
            "block_number": 17820612,
            "timestamp": 1690898435,
            "transaction_hash": "0xe3cc2717b7c4f80f9905520f668b5e7531e6888149093a70cb3c2aecfac1fcd8",
            "price_usd": 112.9592549979527,
            "price_eth": 0.06163523808013077,
            "amount_token": 4.056121267431139
        },
        {
            "block_number": 17820606,
            "timestamp": 1690898363,
            "transaction_hash": "0xe29e05ddf9057d43b7d9fd43e68039231706970e009d291c9646fe8e581c2224",
            "price_usd": 112.29245036503706,
            "price_eth": 0.061271652905043175,
            "amount_token": 6.231102633764247
        }
    ]
}

Live Example

Press Try It to make a request and see what the response looks like. Feel free to try different query parameters.