🤑Candle Chart Data

Endpoint

GET /v1/tokens/candle-chart?tokenId=<TOKEN_ID>&days=<DAYS>&interval=<INTERVAL>

Description

This endpoint returns data for a given token that can be used to create a candlestick chart.

Query String Parameters

• tokenId (required): A string in the format <TOKEN_CONTRACT_ADDRESS>:<NETWORK_ID> that identifies the token to look up.

• days (required): An integer between 1 and 90, inclusive, that specifies the number of days of data to include in the response.

• interval (required): The interval at which you want the data points to be grouped in minutes. Accepted values are 5, 15, 30, and 60.

Headers

• x-api-key (required): A valid API key.

Example

curl -X GET 'https://api.lynxcrypto.app/v1/tokens/candle-chart?tokenId=0x52ec25e58a9e144ff002625bb2aa58cc6da24cb2:56&days=7&interval=15'
-H 'x-api-key: <YOUR_API_KEY>'

Response

[
    {
        "_id": {
            "token_id": "0x52ec25e58a9e144ff002625bb2aa58cc6da24cb2:56",
            "date": "2023-01-09T08:00:00.000Z"
        },
        "h": 0.0014347623738461851,
        "l": 0.0014293900383247492,
        "o": 0.0014347623738461851,
        "c": 0.0014293900383247492,
        "v": 97.61626900558088
    },
    {
        "_id": {
            "token_id": "0x52ec25e58a9e144ff002625bb2aa58cc6da24cb2:56",
            "date": "2023-01-09T09:00:00.000Z"
        },
        "h": 0.0014340568559150129,
        "l": 0.001426031539863773,
        "o": 0.001426031539863773,
        "c": 0.0014340568559150129,
        "v": 97.60990218928677
    },
    {
        "_id": {
            "token_id": "0x52ec25e58a9e144ff002625bb2aa58cc6da24cb2:56",
            "date": "2023-01-09T10:00:00.000Z"
        },
        "h": 0.0014404419700617668,
        "l": 0.0014267965584167693,
        "o": 0.0014267965584167693,
        "c": 0.0014404419700617668,
        "v": 114.30178608781273
    },

]

Response Object

• h: The highest price over the interval.

• l: The lowest price over the interval.

• o: The opening price for the interval (first data point).

• c: The closing price for the interval (last data point).

• v: The volume of the token over the interval.

Response Codes

• 200: Success. Returns the USD price for the given token.

• 400: Bad Request. The tokenId, interval, or days query string parameter is not provided or days is greater than 90 or less than 1.

• 403: Forbidden. The x-api-key header is not provided or is invalid.

• 404: Not Found. No price updates found within the given time range