View as Markdown
Codex icon

Codex ACTION

Get Token Chart

Returns OHLCV (open, high, low, close, volume) candlestick bars for a token over a time range. Use this for price charts, trend analysis, or historical data. Use Get Networks to resolve networkId if needed. from and to are Unix timestamps in seconds (e.g., current time = Math.floor(Date.now() / 1000)). Valid resolutions: 1 (1 min), 5, 15, 30, 60 (1 hr), 240 (4 hr), 720 (12 hr), 1D, 7D. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Codex account once, then configure and run Get Token Chart from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "codex-get-token-chart",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    codex: { authProvisionId: "apn_xxxxxxx" },
    address: "Token Address",
    networkId: 10,
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Get Token Chart inputs
Property Type Description
address Token Address string
On-chain contract address of the token (e.g., 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 for WETH).
Required
networkId Network ID integer
Numeric blockchain network ID. Use Get Networks to list all supported networks and their IDs (e.g., 1 = Ethereum, 137 = Polygon).
Required
resolution Resolution string
Candle interval. Use 60 for hourly, 1D for daily, 7D for weekly.
Required
from From (Unix timestamp) integer
Start of the time range as a Unix timestamp in seconds.
Required
to To (Unix timestamp) integer
End of the time range as a Unix timestamp in seconds. Defaults to now if not provided.
Optional
statsType Stats Type string
The type of statistics returned. Can be FILTERED or UNFILTERED. Default is UNFILTERED.
Optional
countback Countback integer
Guarantees number of bars returned is at most this number. Use countback: 1500 with from: 0 for maximum results.
Optional
currencyCode Currency Code string
The currency to use for the response. Can be USD or TOKEN. Default is USD. Use currencyCode: TOKEN for native token pricing.
Optional
removeLeadingNullValues Remove Leading Null Values boolean
Whether to remove leading null values from the response. Default is false. To fetch a token’s entire history, set resolution to 1D, from value to 0 and removeLeadingNullValues to true.
Optional
removeEmptyBars Remove Empty Bars boolean
Whether to remove empty bars from the response. This is useful for eliminating gaps in low-activity tokens. Default is false.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
codex-get-token-chart
Version
0.0.2
App
Codex
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes