feat(TS): Integrate Zerion API for agentkit #696

pcminh0505 · 2025-05-01T12:23:47Z

Description

Integrate 2 Zerion API endpoints for portfolio fetching
- get_portfolio_overview: Get aggregated USD balance of a wallet address
- get_fungible_positions: Get aggregated token positions (wallet and DeFi) of a wallet address

Requirement: Zerion API key

Example

get_portfolio_overview

Wallet Portfolio Overview:
- Total Value: $3267.53
- 24h Change: -0.63%
- Position Types: wallet: $497.17, deposited: $2138.66, staked: $631.65
- Top Chains: unichain: $2179.59, base: $815.98, ethereum: $270.11, polygon: $0.85, abstract: $0.58

get_fungible_positions

Total Value: $3762.01

Token Positions (>$1):
- ETH (Ethereum) on unichain — $1134.21 [deposit via Uniswap V4]
- USD₮0 (USD₮0) on unichain — $1004.22 [deposit via Uniswap V4]
- WELL (WELL) on base — $630.55 [staked via Moonwell]
- MORPHO (Morpho Token) on base — $497.49 [deposit via Moonwell]
- ETH (Ethereum) on ethereum — $268.30 [wallet]
- ETH (Ethereum) on base — $182.84 [wallet]
- ETH (Ethereum) on unichain — $40.94 [wallet]
- UNI (Uniswap) on ethereum — $1.92 [wallet]
- ALCH (Alchemist Accelerate) on base — $1.54 [wallet]

Tests

 PASS  src/action-providers/zerion/zerionActionProvider.test.ts (8.381 s)
  ZerionActionProvider
    ✓ should throw if no API key is provided (10 ms)
    ✓ should use provided API key from config
    ✓ should support the protocol family
    ✓ should not support other protocol families
    ✓ should handle invalid network objects
    getPortfolioOverview
      ✓ returns error for invalid address
      ✓ returns formatted data for valid address (1 ms)
      ✓ returns error on fetch failure
    getFungiblePositions
      ✓ returns error for invalid address (1 ms)
      ✓ returns formatted data for valid address
      ✓ returns error on fetch failure

Checklist

A couple of things to include in your PR for completeness:

Added documentation to all relevant README.md files
Added a changelog entry

* 0.1.0 initial scaffolding (#175) * chore: fix lint (#177) * chore: migrate basename action (#176) * chore: CDP, Farcaster, ERC721 action providers (#181) * CDP, Farcaster, ERC721 ActionProvider * README erc721 * chore: migrate erc20 action (#182) * 0.1.0(ts): morpho actions (#184) * chore: migrate erc20 getBalance (#186) * chore: fix npm scripts, linting and bump lint packages (#179) * chore: migrate erc721 getBalance (#188) * chore: migrate wrap eth action (#189) * chore: langchain helper to convert actions to tools (#190) * 0.1.0(ts): wow actions (#191) * chore: migrate get wallet details (#192) * 0.1.0(ts): twitter actions (#193) * chore: eslint import order (#194) * chore: map chainId to networkId (#196) * chore: fix typo (#197) * chore: migrate deploy token (#198) * 0.1.0(ts): deploy contract (#201) * first pass adding deploy contract cdp action * linting * the lost file * tests * 0.1.0(ts): adding eth balance to wallet details (#199) * feat: Client side metrics (#195) * 0.1.0(ts): deploy nft (#200) * chore: rename typescript files and folders (#203) * chore: split out cdp wallet and cdp api actions (#204) * chore: migrate trade action (#208) * twitter chatbot example (#205) * 0.1.0(ts): farcaster example (#206) * chore: cdpApiActionProvider usage (#211) * chore: prefix action name (#210) * chore: set default action provider to wallet action provider (#212) * 0.1.0(ts): wallet native token transfer (#213) Co-authored-by: John Peterson <98187317+John-peterson-coinbase@users.noreply.github.com> * fix: use prefix notation that plays nicely with langchain (#217) * feat: support custom action provider (#214) * 0.1.0(ts): cdp wallet provider (#218) Co-authored-by: John Peterson <98187317+John-peterson-coinbase@users.noreply.github.com> * feat: CdpWalletProvider sendTransaction * fix cdp provider config fields * docs + dir structure refactor * add language level readmes * release ready! * fix agentkit-langchain unit tests * fix python unit test GHA poetry relative paths * update poetry lock files --------- Co-authored-by: Ryan Gilbert <ryangilbert7926@gmail.com> Co-authored-by: Chris Gerber <csgerber@gmail.com>

disambuguates -> disambiguates

@murrlincoln

…d protocols (#256) @murrlincoln Co-authored-by: Lincoln Murr <lincoln.murr@coinbase.com>

…supporte…" (#263)

)

* add moonwell action providers Signed-off-by: Elliot <elliotfriedman3@gmail.com> * update: lint, update nomenclature, fix tests, add new constants Signed-off-by: Elliot <elliotfriedman3@gmail.com> --------- Signed-off-by: Elliot <elliotfriedman3@gmail.com>

* Update README.md * Update README.md * Add files via upload * Update README.md * Update README.md

Co-authored-by: Christopher Gerber <christopher.gerber@coinbase.com> Co-authored-by: Ryan Gilbert <ryangilbert7926@gmail.com>

cb-heimdall · 2025-05-01T12:23:54Z

🟡 Heimdall Review Status

Requirement Status More Info

Reviews

🟡 0/1

Denominator calculation

Show calculation

1 if user is bot 0

1 if user is external 0

2 if repo is sensitive 0

From .codeflow.yml 1

Additional review requirements

Show calculation

Max	0

0

From CODEOWNERS 0

Global minimum 0

Max 1

1

1 if commit is unverified 1

Sum 2

chungquantin · 2025-05-20T15:58:14Z

Looks good, hope this is merged!

phdargen · 2025-07-25T08:52:03Z

Hi @pcminh0505, thanks for the contribution! Looks pretty good, please rebase against main, then I will do some testing.

A few initial comments:

please add entry in agentkit/README (https://github.com/coinbase/agentkit/blob/main/typescript/agentkit/README.md), should follow alphabetic order
we require all commits to be verified, unfortunately the first two commits are not signed. When you rebase against main, please resign all commits

phdargen · 2025-07-25T08:53:50Z

typescript/agentkit/src/action-providers/zerion/zerionActionProvider.ts

+  })
+  async getPortfolioOverview(args: z.infer<typeof GetWalletPortfolioSchema>): Promise<string> {
+    try {
+      const address = args.walletAddress || "";


this should fall back to walletProvider.address as states in schema. same for other action

Hi @phdargen , imo it should be wallet-free tool (llke OpenSea). I already have an error check for Invalid wallet address below. My initial intention for Zerion API is portfolio check (with DeFi/fungible positions) for any wallet

phdargen · 2025-07-25T08:56:54Z

typescript/agentkit/src/action-providers/zerion/zerionActionProvider.ts

@@ -0,0 +1,182 @@
+/**


remove l1-9 to fit existing code style

phdargen · 2025-07-25T08:59:05Z

typescript/agentkit/src/action-providers/zerion/zerionActionProvider.ts

+   * Replace or modify this with your actual action.
+   *
+   * @description
+   * This is a template action that demonstrates the basic structure.


replace template description with actual action description

phdargen · 2025-08-05T08:02:15Z

Hi @pcminh0505, thanks for the update! Unfortunately the rebasing didnt work out as intended, it shows 71 commits now and hundreds of changed files. Could you please try to clean-up the commit history? Also your first 2 commits are still unsigned

pcminh0505 · 2025-08-05T15:14:15Z

Hi @phdargen , my bad in rebasing the branch :( moved my changes to #816

John-peterson-coinbase and others added 30 commits February 1, 2025 05:50

chore: fix link in readme (#224)

961a264

chore: Fix README.md Table of Contents (#231)

9e8c708

chore: Use published packages in 0.1.0 examples (#234)

960eeab

Update README.md (#233)

df372b5

Fix python example link with signed commit (#230)

0a99f85

feat: Release AgentKit.js 0.1.1 with Network re-exported (#244)

6644c91

docs: update CONTRIBUTING-PYTHON.md (#247)

7dcd637

disambuguates -> disambiguates

chore(ts): readme update for action external providers (#250)

9e343b4

add alchemy prices api to typescript action providers (#252)

af12f3b

fix: include account in call to estimateGas (#253)

db5b827

chore: add format check to typescript packages (#254)

9361f35

chore(ts): update readme with action providers, actions, and supporte…

8c44055

…d protocols (#256) @murrlincoln Co-authored-by: Lincoln Murr <lincoln.murr@coinbase.com>

Revert "chore(ts): update readme with action providers, actions, and …

7a0be88

…supporte…" (#263)

chore: add unit test for python action provider (#268)

9fb4b72

chore: update example readmes (#267)

7f04f42

chore: Add explicit template type args for ActionProvider<...> ext (#270

84e2796

)

chore: Updated the repository field in the package.json (#278)

7b56979

Update README.md (#275)

6282ad8

fix: use cdp wallet address at estimateGas (#283)

e267321

PayloadSignature.wait for Server-Signers (#285)

d8d094a

fix: turn into string, don't just set type (#294)

0fbf81b

chore: Prepare 0.1.2 AgentKit.js Release (#295)

1a8731b

chore: Release 0.1.2 AgentKit.js (#296)

054e8cc

Updated READMEs (#298)

75f17e1

* Update README.md * Update README.md * Add files via upload * Update README.md * Update README.md

Add CODEOWNERS (#334)

8500055

feat: pr template (#257)

6e6d5fc

Co-authored-by: Christopher Gerber <christopher.gerber@coinbase.com> Co-authored-by: Ryan Gilbert <ryangilbert7926@gmail.com>

updates (#342)

b1cd770

fix: update cdp-langchain path in CONTRIBUTING-PYTHON.md (#327)

afbc3b7

CarsonRoscoe and others added 4 commits April 25, 2025 18:06

chore: version typescript packages (#690)

27c8766

Update utils.ts (#683)

189487d

Update CONTRIBUTING-TYPESCRIPT.md (#682)

3c2d919

ci: bump actions/checkout to v4 (#685)

8d10531

pcminh0505 requested a review from murrlincoln as a code owner May 1, 2025 12:23

github-actions bot added documentation Improvements or additions to documentation action provider New action provider typescript labels May 1, 2025

phdargen reviewed Jul 25, 2025

View reviewed changes

github-actions bot added wallet provider New wallet provider example New example agent framework extension New framework extension python labels Aug 5, 2025

pcminh0505 requested a review from phdargen August 5, 2025 05:06

pcminh0505 closed this Aug 5, 2025

github-actions bot removed documentation Improvements or additions to documentation action provider New action provider wallet provider New wallet provider example New example agent framework extension New framework extension python typescript labels Aug 5, 2025

phdargen mentioned this pull request Aug 6, 2025

feat(TS): Integrate Zerion API for agentkit #816

Merged

2 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(TS): Integrate Zerion API for agentkit #696

feat(TS): Integrate Zerion API for agentkit #696

Uh oh!

pcminh0505 commented May 1, 2025

Uh oh!

cb-heimdall commented May 1, 2025 •

edited

Loading

Uh oh!

chungquantin commented May 20, 2025

Uh oh!

phdargen commented Jul 25, 2025

Uh oh!

phdargen Jul 25, 2025 •

edited

Loading

Uh oh!

pcminh0505 Aug 5, 2025

Uh oh!

phdargen Jul 25, 2025 •

edited

Loading

Uh oh!

phdargen Jul 25, 2025

Uh oh!

phdargen commented Aug 5, 2025

Uh oh!

pcminh0505 commented Aug 5, 2025

Uh oh!

Reviewers

Assignees

Labels

Milestone

Development

Uh oh!

20 participants

feat(TS): Integrate Zerion API for agentkit #696

feat(TS): Integrate Zerion API for agentkit #696

Uh oh!

Conversation

pcminh0505 commented May 1, 2025

Description

Example

Tests

Checklist

Uh oh!

cb-heimdall commented May 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🟡 Heimdall Review Status

Uh oh!

chungquantin commented May 20, 2025

Uh oh!

phdargen commented Jul 25, 2025

Uh oh!

phdargen Jul 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

pcminh0505 Aug 5, 2025

Choose a reason for hiding this comment

Uh oh!

phdargen Jul 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

phdargen Jul 25, 2025

Choose a reason for hiding this comment

Uh oh!

phdargen commented Aug 5, 2025

Uh oh!

pcminh0505 commented Aug 5, 2025

Uh oh!

Reviewers

Assignees

Labels

Milestone

Development

Uh oh!

20 participants

cb-heimdall commented May 1, 2025 •

edited

Loading

phdargen Jul 25, 2025 •

edited

Loading

phdargen Jul 25, 2025 •

edited

Loading