Skip to content

feat(dexscreener): add DexScreener action provider for real-time DEX pair data#1128

Open
bennytimz wants to merge 1 commit intocoinbase:mainfrom
bennytimz:feat/dexscreener-action-provider
Open

feat(dexscreener): add DexScreener action provider for real-time DEX pair data#1128
bennytimz wants to merge 1 commit intocoinbase:mainfrom
bennytimz:feat/dexscreener-action-provider

Conversation

@bennytimz
Copy link
Copy Markdown

Summary

Adds a new action provider for DexScreener, the most widely used DEX aggregator covering 80+ blockchains and 1000+ DEXes. No API key or authentication required.

DexScreener is listed in WISHLIST.md under Trading & Data.

Actions Added

Action Description
search_dexscreener_pairs Search for trading pairs by token name, symbol, or contract address
get_dexscreener_pairs_by_token Get all pairs for a token on a specific chain, sorted by 24h volume
get_dexscreener_pair Get detailed data for a specific pair by contract address

Example prompts

Search DexScreener for USDC pairs
Find all trading pairs for WETH on Base
Get the current price and 24h volume of cbBTC on Base
What is the most liquid DEX pair for ETH on Arbitrum?

Implementation Notes

  • Pure HTTP reads against the public DexScreener API — no wallet required, no API key
  • Follows the exact same pattern as the existing defillama action provider
  • Responses pruned to top N pairs by 24h volume to keep output concise for agents
  • supportsNetwork returns true for all networks (DexScreener covers 80+ chains)
  • All actions return structured JSON strings consistent with existing provider patterns

Tests

17/17 tests passing. Coverage includes:

  • Happy path for all 3 actions
  • Empty/null response handling
  • HTTP error handling (404, 429, 500)
  • Network failure handling
  • Result limiting (max 10 for search, configurable for token pairs)
  • Volume-based sorting for get_dexscreener_pairs_by_token
  • Fallback from pair field to pairs[0] in get_dexscreener_pair

Checklist

  • Tests added and passing (pnpm test -- --testPathPattern=dexscreener)
  • Lint passing (pnpm run lint)
  • Format passing (pnpm run format)
  • Changeset created
  • Export added to action-providers/index.ts
  • README included
  • Listed in WISHLIST.md

@bennytimz bennytimz requested a review from murrlincoln as a code owner April 19, 2026 14:30
@cb-heimdall
Copy link
Copy Markdown

cb-heimdall commented Apr 19, 2026

🟡 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

@github-actions github-actions Bot added documentation Improvements or additions to documentation action provider New action provider typescript labels Apr 19, 2026
@cb-heimdall
Copy link
Copy Markdown

Review Error for MVPuknowme @ 2026-04-19 23:05:08 UTC
User failed mfa authentication, either user does not exist or public email is not set on your github profile. \ see go/mfa-help

@cb-heimdall
Copy link
Copy Markdown

Review Error for MVPuknowme @ 2026-04-19 23:05:59 UTC
User failed mfa authentication, either user does not exist or public email is not set on your github profile. \ see go/mfa-help

@bennytimz bennytimz force-pushed the feat/dexscreener-action-provider branch from 21ea15d to e6150ce Compare April 19, 2026 23:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action provider New action provider documentation Improvements or additions to documentation typescript

Development

Successfully merging this pull request may close these issues.

3 participants