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)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "codex-get-token-chart",
"configured_props": {
"codex": { "authProvisionId": "apn_xxxxxxx" },
"address": "Token Address",
"networkId": 10
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "codex",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "codex-get-token-chart",
arguments: {
address: "Token Address",
networkId: 10,
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| 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
- Source
- View on GitHub ↗