Feature request: an action for consuming x402 paywalled APIs
Maintainers usually reply within 1 day
@baianomarceloeduardo-jpg is already working on this.
Since Sep 30, 2026.
- #1525 by @baianomarceloeduardo-jpg — open
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 48/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- typescript
Research direction
Start by reviewing AgentKit's action model and the described x402 request flow: POST to an endpoint, handle the 402 Payment-Required challenge, sign the Base USDC payment, and retry with Payment-Signature. Done means an action or helper can consume an x402-protected endpoint and return its paid result.
Written by the indexing model from the issue text.
Description
Is your feature request related to a problem?
Agents built with AgentKit often need to call third-party APIs that charge per request. There's no built-in way for an AgentKit action to consume a paywalled API and pay automatically.
Describe the solution you'd like
An action (or helper) that consumes an x402-protected endpoint: make the request, receive the 402 Payment-Required challenge, sign the Base USDC payment, and retry. x402 is the Coinbase HTTP payment protocol, so it would slot naturally into AgentKit's action model.
Describe alternatives you've considered
- Pre-paid API keys (not pay-per-call).
- A generic "fetch + pay" utility rather than a typed action.
Example flow
POST to an x402 endpoint → 402 with a Payment-Required header → sign with the agent's wallet → retry with Payment-Signature → paid result.
- Dominant language
- TypeScript
- Stars
- 1.3k
- Forks
- 857
- PR merge metrics
- No merged PRs in 30d
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from coinbase/agentkit
-
ERC20 transfer reports "Transferred" when the transaction reverts (receipt status ignored)Possibly taken @AgenticFinanceGraph claimed this 5 days ago. Open
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
coinbase/agentkit#1558 · 1 comment ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Maintainers usually reply within 1 day
-
coinbase-agentkit 0.7.x fails on fresh install: imports solana.rpc.api, which solana>=0.37 removedPossibly taken @JulienKervarrec claimed this 24 days ago. Open
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
Maintainers usually reply within 1 day
-
Difficulty 5/5 Over a week Newbie friendliness 15/100
Maintainers usually reply within 1 day
-
Difficulty 4/5 3-5 days Newbie friendliness 15/100
Maintainers usually reply within 1 day
All issues in coinbase/agentkit
Similar issues
-
community first-timers-only good first issue hacktoberfest help wanted low hanging fruit up-for-grabs
Difficulty 1/5 Under an hour Newbie friendliness 90/100
lingdojo/kana-dojo#32663 · 1 comment · 5 reactions ·
Maintainers usually reply within 1 day
-
Admin: Title Separator field can't be cleared (input falls back to "|")Possibly taken @emdashbot claimed this today. Openbot:bug bot:in-review
Difficulty 2/5 1-3 hours Newbie friendliness 80/100
emdash-cms/emdash#4236 · 3 comments ·
Maintainers usually reply within 1 day
-
PHP workflow streaming requests buffer the full SSE responsePossibly taken @Winoren claimed this today. Openreview: medium
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
langgenius/dify#44270 · 1 comment · 1 reaction ·
Maintainers usually reply within 1 day
-
area:holodeck review-finding
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
hyperdrive-technology/holodeck#142 ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 90/100
code-yeongyu/senpi#3573 ·
Maintainers usually reply within 1 day