Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions typescript/agentkit/src/action-providers/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ export * from "./pyth";
export * from "./moonwell";
export * from "./morpho";
export * from "./opensea";
export * from "./pond";
export * from "./spl";
export * from "./twitter";
export * from "./wallet";
Expand Down
113 changes: 113 additions & 0 deletions typescript/agentkit/src/action-providers/pond/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,113 @@
# Pond Action Provider

This directory contains the Pond action provider implementation, which provides actions to interact with the Pond API for wallet risk assessment, token analysis, and chain-specific data analysis.

## Getting Started

To use the Pond Action Provider, you need to obtain the following API keys:

1. Pond API Key:
- Default key is limited to 10,000 requests
Copy link
Contributor

@phdargen phdargen Aug 11, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is the default key or how to obtain it?

- For higher request limits, contact us through secure channels
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unclear, could this be more specific? Contact how?


2. Base Dify API Key:
Copy link
Contributor

@phdargen phdargen Aug 11, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add direct links where to get these API keys

- Required for Base chain data analyst queries
- Used for natural language queries about Base chain data

3. Ethereum Dify API Key:
- Required for Ethereum chain data analyst queries
- Used for natural language queries about Ethereum chain data

### Environment Variables

```
POND_API_KEY
BASE_DIFY_API_KEY
ETH_DIFY_API_KEY
```

Alternatively, you can configure the provider directly during initialization:

```typescript
import { pondActionProvider } from "@coinbase/agentkit";

const provider = pondActionProvider({
apiKey: "your_pond_api_key",
baseDifyApiKey: "your_base_dify_api_key",
ethDifyApiKey: "your_eth_dify_api_key"
});
```

## Directory Structure

```
pond/
├── constants.ts # API endpoints and other constants
├── pondActionProvider.test.ts # Tests for the provider
├── pondActionProvider.ts # Main provider with Pond API functionality
├── index.ts # Main exports
├── README.md # Documentation
├── schemas.ts # Pond action schemas
└── types.ts # Type definitions
```

## Actions

- `getWalletRiskScore`: Get risk assessment for a wallet
- Supports multiple risk assessment models
- Provides risk score, level, and feature completeness
- Models: OlehRCL (default), 22je0569, Wellspring Praise

- `getWalletSummary`: Get comprehensive wallet analysis
- DEX trading activity
- Transaction metrics
- Portfolio diversity
- Gas usage analysis

- `getSybilPrediction`: Detect potential Sybil attacks
- Analyzes wallet behavior patterns
- Identifies multi-account farming activities

- `getTokenPricePrediction`: Predict token price movements
- Multiple timeframe predictions (1-24 hours)
- Price movement forecasts
- Risk level assessment

- `getTokenRiskScores`: Get token risk assessment
- Multiple risk assessment models
- Comprehensive token analysis
- Market performance metrics

- `getTopSolanaMemeCoins`: Analyze Solana meme coins
- Top 10 meme coins analysis
- Price change predictions
- Trading activity metrics

- `getBaseDataAnalysis`: Query Base chain data
- Natural language queries
- Token analysis
- NFT analysis
- Market analysis

- `getEthDataAnalysis`: Query Ethereum chain data
- Natural language queries
- Token analysis
- NFT analysis
- Market analysis

## Rate Limiting

The default Pond API key is limited to 10,000 requests. For higher request limits, please contact us through secure channels (email or official platform) to obtain an API key with extended capabilities.

## Error Handling

The provider includes comprehensive error handling for:
- Missing API keys
- Invalid wallet addresses
- API connection issues
- Response parsing errors
- Server-side errors
- Rate limiting
- Authentication failures

Errors are returned as formatted strings with relevant details.
2 changes: 2 additions & 0 deletions typescript/agentkit/src/action-providers/pond/index.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
export * from "./pondActionProvider";
export * from "./schemas";

Check failure on line 2 in typescript/agentkit/src/action-providers/pond/index.ts

View workflow job for this annotation

GitHub Actions / lint-typescript

Replace `·` with `⏎`
Loading
Loading