View as Markdown
Codex icon

Codex ACTION

Get Wallet Balances

Returns all token holdings and USD values for a wallet address on a specific blockchain network. Use this to inspect what tokens a wallet holds. Use Get Networks to resolve the numeric networkId if needed (e.g., 1 = Ethereum, 137 = Polygon). 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 Wallet Balances 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-wallet-balances",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    codex: { authProvisionId: "apn_xxxxxxx" },
    walletAddress: "Wallet 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 Wallet Balances inputs
Property Type Description
walletAddress Wallet Address string
On-chain wallet address (e.g., 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045).
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

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-wallet-balances
Version
0.0.2
App
Codex
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes