View as Markdown
Codex icon

Codex ACTION

Get Token Holders

Returns the list of token holders with their balances and the top-10 holder concentration percentage. Use this to analyze token distribution and whale concentration. Use Get Networks to resolve the numeric networkId if needed. Supports cursor-based pagination — pass cursor from the previous response to fetch the next page. 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 Holders 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-holders",
  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 Holders 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
limit Limit integer
Maximum number of results to return.
Optional
cursor Cursor string
Pagination cursor from a previous response's cursor field. Omit for the first page.
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-holders
Version
0.0.2
App
Codex
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes