Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added a new DexpaprikaActionProvider to interact with the Dexpaprika … #593

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

lstokenomiapro
Copy link

…API for cryptocurrency market data

Description

Added a new DexpaprikaActionProvider to interact with the Dexpaprika API for cryptocurrency market data. The provider includes methods for fetching DEX pools, network DEXes, liquidity pools, pool details, token details, top pools, and search functionality across different blockchain networks.

Tests

Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Prompt: get top dex pools on uniswap_v4 on base

Here are the top liquidity pools on Uniswap V4 on the Base network:

1. **Pool ID:** 0x96d4b53a38337a5733179751781178a2613306063c511b78cd02684739288c0a
   - **DEX Name:** Uniswap V4
   - **Volume (USD):** $2,827,072.83
   - **Price (USD):** $2,038.92
   - **Tokens:**
     - ETH (Ether)
     - USDC (USD Coin)

2. **Pool ID:** 0x9c5edc768b5db73bf71856dc7d79bcc8368d7a4d3ded2091a20010f089cb0e74
   - **DEX Name:** Uniswap V4
   - **Volume (USD):** $921,394.13
   - **Price (USD):** $2,038.92
   - **Tokens:**
     - ETH (Ether)
     - KTA (Keeta)

3. **Pool ID:** 0x438c7f6a3b32fdcf043ad3285dbc128486df894a1f3d448b1da38b2f2a1a43cb
   - **DEX Name:** Uniswap V4
   - **Volume (USD):** $723,521.20
   - **Price (USD):** $1.02
   - **Tokens:**
     - USDC (USD Coin)
     - KTA (Keeta)

4. **Pool ID:** 0x12d76c5c8ec8edffd3c143995b0aa43fe44a6d71eb9113796272909e54b8e078
   - **DEX Name:** Uniswap V4
   - **Volume (USD):** $594,294.83
   - **Price (USD):** $0.9993
   - **Tokens:**
     - USDC (USD Coin)
     - cbBTC (Coinbase Wrapped BTC)

5. **Pool ID:** 0x179492f1f9c7b2e2518a01eda215baab8adf0b02dd3a90fe68059c0cac5686f5
   - **DEX Name:** Uniswap V4
   - **Volume (USD):** $575,552.11
   - **Price (USD):** $1.00
   - **Tokens:**
     - USDC (USD Coin)
     - cbBTC (Coinbase Wrapped BTC)

If you need more detailed information about any specific pool or further queries, feel free to ask!
Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Prompt: get a list of available dexes on base

Here is a list of available decentralized exchanges (DEXes) on the Base network:

1. **Aerodrome V3**
   - **Protocol:** Aerodrome V3

2. **BaseSwap V2**
   - **Protocol:** Uniswap V2

3. **Aerodrome**
   - **Protocol:** Aerodrome

4. **Curve**
   - **Protocol:** Curve

5. **SwapBased**
   - **Protocol:** Uniswap V2

6. **Uniswap V3**
   - **Protocol:** Uniswap V3

7. **SwapBased V3**
   - **Protocol:** SwapBased V3

8. **Uniswap V2**
   - **Protocol:** Uniswap V2

9. **BaseSwap V3**
   - **Protocol:** Uniswap V3

10. **SushiSwap**
    - **Protocol:** Uniswap V2

11. **SushiSwap V3**
    - **Protocol:** Uniswap V3

12. **Alien Base V3**
    - **Protocol:** Uniswap V3

13. **Uniswap V4**
    - **Protocol:** Uniswap V4

If you have any further inquiries or need more details about a specific DEX, feel free to ask!

Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Prompt: get a list of top liquidity pools on base

Here are some of the top liquidity pools on the Base network:

1. **Pool ID:** 0xb2cc224c1c9fee385f8ad6a55b4d94e92359dc59
   - **DEX Name:** Aerodrome V3
   - **Volume (USD):** $206,150,288.05
   - **Price (USD):** $2,039.43
   - **Tokens:**
     - WETH (Wrapped Ether)
     - USDC (USD Coin)

2. **Pool ID:** 0x4e962bb3889bf030368f56810a9c96b83cb3e778
   - **DEX Name:** Aerodrome V3
   - **Volume (USD):** $103,941,690.33
   - **Price (USD):** $0.9995
   - **Tokens:**
     - USDC (USD Coin)
     - cbBTC (Coinbase Wrapped BTC)

3. **Pool ID:** 0x70acdf2ad0bf2402c957154f944c19ef4e1cbae1
   - **DEX Name:** Aerodrome V3
   - **Volume (USD):** $80,675,614.38
   - **Price (USD):** $2,036.44
   - **Tokens:**
     - WETH (Wrapped Ether)
     - cbBTC (Coinbase Wrapped BTC)

4. **Pool ID:** 0xd0b53d9277642d899df5c87a3966a349a798f224
   - **DEX Name:** Uniswap V3
   - **Volume (USD):** $59,787,638.01
   - **Price (USD):** $2,039.41
   - **Tokens:**
     - WETH (Wrapped Ether)
     - USDC (USD Coin)

5. **Pool ID:** 0xd9edc75a3a797ec92ca370f19051babebfb2edee
   - **DEX Name:** Aerodrome
   - **Volume (USD):** $20,211,724.74
   - **Price (USD):** $2,039.41
   - **Tokens:**
     - WETH (Wrapped Ether)
     - KTA (Keeta)

If you need more details about any specific pool or further information, feel free to ask!
Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Prompt: get details about the pool 0xd9edc75a3a797ec92ca370f19051babebfb2edee on base

Here are the details for the pool with ID **0xd9edc75a3a797ec92ca370f19051babebfb2edee** on the Base network:

- **DEX Name:** Aerodrome
- **Chain:** Base
- **Created At:** March 5, 2025
- **Factory ID:** 0x420dd381b31aef6683db6b902084cb0ffece40da
- **Last Price (USD):** $2,040.09
- **Last Price (Local):** 12,135.74
- **Tokens:**
  - **WETH (Wrapped Ether)**
    - Reserve: 22.87 WETH
    - Reserve Value (USD): $46,656.87
  - **KTA (Keeta)**
    - Reserve: 1,000,000,000,000,000,000,000,000 KTA
    - Reserve Value (USD): $2,040,090,476,357.67

### 24-hour Performance:
- **Volume (USD):** $40,599,354.39
- **Buys (Transaction Count):** 3,342
- **Sells (Transaction Count):** 4,894
- **Last Price Change (USD):** $6.73

### 6-hour Performance:
- **Volume (USD):** $9,380,721.58
- **Buys (Transaction Count):** 682
- **Sells (Transaction Count):** 1,081
- **Last Price Change (USD):** -$0.26

### 1-hour Performance:
- **Volume (USD):** $2,414,373.39
- **Buys (Transaction Count):** 123
- **Sells (Transaction Count):** 196
- **Last Price Change (USD):** $0.01

### 30-minute Performance:
- **Volume (USD):** $1,598,759.43
- **Buys (Transaction Count):** 84
- **Sells (Transaction Count):** 115
- **Last Price Change (USD):** -$0.17

### 15-minute Performance:
- **Volume (USD):** $554,163.26
- **Buys (Transaction Count):** 37
- **Sells (Transaction Count):** 37
- **Last Price Change (USD):** -$0.03

### 5-minute Performance:
- **Volume (USD):** $422,425.27
- **Buys (Transaction Count):** 27
- **Sells (Transaction Count):** 8
- **Last Price Change (USD):** $0.00

If you need more specific information or further details, feel free to ask!

Checklist

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

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

@cb-heimdall
Copy link

🟡 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
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 Mar 19, 2025
@donbagger
Copy link

DexPaprika Integration for AgentKit

Hey! I've been working on MCP server for this DexPaprika integration and wanted to share why I think it's a game-changer for AgentKit. After spending countless hours with the API, I'm honestly amazed by what it allows you to do.

What Makes This Integration Special

This integration gives AI agents unrestricted access to DeFi data across chains. No more API keys, no more rate limits - just pure, real-time data access. Let me break down what this makes possible:

1. Real-time Market Analysis

  • Access to a massive 1.8M+ tokens just on Base (seriously, it's huge!)
  • Granular price tracking (1m to 24h - whatever you need)
  • Spot market trends through volume/price patterns
  • Catch unusual trading activity instantly
  • Compare tokens across different chains

2. Historical Pattern Recognition

  • Full OHLCV data at your fingertips
  • Track those crucial 52-week highs/lows
  • Find support/resistance levels automatically
  • Spot market cycles and patterns
  • Generate any technical indicator you need

3. Cross-DEX Intelligence

  • Spot price differences between DEXes instantly
  • Watch liquidity moving between protocols
  • Find arbitrage opprtunities in real-time

4. Token Discovery & Validation

  • Catch new tokens the moment they launch with public pools
  • Track how initial liquidity develops
  • Monitor trading patterns from day one
  • Spot potential red flags early

5. Portfolio Analytics

  • Agents can track multiple tokens at once
  • Get detailed performance metrics
  • Agents can propose smart rebalancing suggestions

6. Natural Language Interactions

  • Ask complex questions about any token
  • Get detailed market reports
  • Understand why prices moved
  • Compare different tokens easily
  • Get market sentiment analysis

Why it's different from other solutions

  1. Zero Setup Hassle
  • No API keys, no limits, no headaches. Literally.
  1. All The Data You Need
  • Over 1.8M tokens tracked on Base
  • Historical & Real Time market depth
  1. One API to rule them all
  • 20+ other blockchain networks supported
  • Unified schema across chains
  • Works everywhere, consistently
  1. Blazing Fast
  • Responses < 100ms
  • Smart pagination, high throughput

Developer benefits

  1. Super easy to implement
  • One integration for everything
  • Consistent patterns across endpoints
  • Clear docs and examples (docs.dexpaprika.com)
  1. Handles lots of load
  • Processes tons of requests
  • Multiple connections? No problem
  1. Rock-solid reliability
  • Always up and running
  • Automatic fallbacks
  • Data you can trust

Why this matters

I've been in the DeFi space for years, and this is exactly what agents need. The ability to give AI agents unrestricted access to comprehensive market data is a game-changer. It lets developers build the kind of sophisticated tools that were previously only available to institutions.

Would love to see this merged soon - it's going to open up so many possibilities for what people can build with AgentKit. The combo of unlimited data access and AI is pretty mind-blowing when you think about it.

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