get_token_candle_data
Retrieve historical candle data for tokens to analyze price trends or market cap. Specify time intervals and ranges for precise data extraction, enabling informed blockchain trading and strategy decisions.
Instructions
Get candle data about any token for analysis.
Expects a CandleStickRequest, returns a list of candle sticks.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| candle_stick_requests | Yes |
Input Schema (JSON Schema)
{
"$defs": {
"CandleStickRequest": {
"properties": {
"market_cap": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": false,
"description": "Whether to return the marketcap of the token instead of the price",
"title": "Market Cap"
},
"time_from": {
"description": "The time from which to start the candle data in ISO 8601 format. Attempt to change this to keep number of candles returned under 64.",
"title": "Time From",
"type": "string"
},
"time_interval": {
"default": "1h",
"description": "Time frame to get the candle sticks. Use larger candle time frames over larger time windows to keep returned candles minimal",
"enum": [
"1s",
"5s",
"15s",
"1m",
"3m",
"5m",
"15m",
"30m",
"1h",
"2h",
"4h",
"6h",
"8h",
"12h",
"1d",
"3d",
"1w",
"1mn"
],
"title": "Time Interval",
"type": "string"
},
"time_to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The time to end the candle data in ISO 8601 format. Use only for historic analysis.",
"title": "Time To"
},
"token_address": {
"description": "Public mint address of the token. To get the address from a token symbol use `get_token_details`",
"title": "Token Address",
"type": "string"
}
},
"required": [
"token_address",
"time_from"
],
"title": "CandleStickRequest",
"type": "object"
}
},
"properties": {
"candle_stick_requests": {
"$ref": "#/$defs/CandleStickRequest"
}
},
"required": [
"candle_stick_requests"
],
"title": "get_token_candle_dataArguments",
"type": "object"
}