market-data

📁 ben-alph-ai/crypto-trading-api 📅 Today
2
总安装量
1
周安装量
#67688
全站排名
安装命令
npx skills add https://github.com/ben-alph-ai/crypto-trading-api --skill market-data

Agent 安装分布

amp 1
cline 1
trae 1
opencode 1
cursor 1
kimi-cli 1

Skill 文档

Market Data Query (Solana)

Query real-time Solana token market data including prices, holder analytics, whale tracking, and smart wallet intelligence.

Overview

This skill helps you:

  • Get current token prices (SOL-denominated)
  • Fetch 24h trading statistics (volume, buys/sells, price change)
  • Query multi-timeframe ticker data
  • Analyze token holders and whale activity
  • Track smart money wallets and their trades
  • Discover hot tokens by banker activity

API Base URL

https://b.alph.ai

Important Notes

  • Solana Only: This platform is Solana-chain focused. Chain parameter is always sol.
  • No Auth Required: All market data endpoints are public, no JWT needed.
  • Price Denomination: Prices are returned in SOL, not USD. To get USD price, multiply by current SOL/USD rate.

Quick Reference

Price & Ticker Endpoints

Endpoint Method Auth Status
/smart-web-gateway/ticker/currentPrice/{token}/sol GET No ✅ Working
/smart-web-gateway/ticker/24h/{token}/sol GET No ✅ Working
/smart-web-gateway/ticker/{token}/sol GET No ✅ Working
/smart-web-gateway/kline-scales GET No ✅ Working
/smart-web-gateway/common/platform/sol GET No ✅ Working

Token Analytics Endpoints

Endpoint Method Auth Status
/smart-web-gateway/coin/detail/traders?token={token}&chain=sol GET No ✅ Working
/smart-web-gateway/coin/detail/bankers?token={token}&chain=sol GET No ✅ Working
/smart-web-gateway/coin/detail/bankers/total?token={token}&chain=sol GET No ✅ Working
/smart-web-gateway/coin/detail/holders?token={token}&chain=sol GET No ✅ Working
/smart-web-gateway/coin/detail/holders/stats?token={token}&chain=sol GET No ✅ Working

Smart Wallet Endpoints

Endpoint Method Auth Status
/smart-web-gateway/smart/tags?chain=sol GET No ✅ Working
/smart-web-gateway/smart/smart-wallet?chain=sol GET No ✅ Working
/smart-web-gateway/smart/wallet?wallet={addr}&chain=sol GET No ✅ Working
/smart-web-gateway/smart/holding-tokens?wallet={addr}&chain=sol GET No ✅ Working
/smart-web-gateway/smart/wallet-activity?wallet={addr}&chain=sol GET No ✅ Working
/smart-web-gateway/smart/wallet-profit-loss?wallet={addr}&chain=sol GET No ✅ Working

Hot Token Discovery

Endpoint Method Auth Status
POST /smart-web-gateway/sherlock/popular_token/getTopTokenByBanker POST No ✅ Working
POST /smart-web-gateway/sherlock/popular_token/getNewTokenProgress POST No ✅ Working

Known Non-Working Endpoints

Endpoint Error Note
/kline/new/history/{token}/sol/{type} 500 K-line history currently unavailable
All Ethereum/BSC chain endpoints 501 Not supported – Solana only
/chain/list, /smart/price 500 Service unavailable
/smart/hot-tokens 500 Service unavailable

Common Solana Token Addresses

Token Address
BONK DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
WIF (dogwifhat) EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm
JUP JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN
USDC EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
Wrapped SOL So11111111111111111111111111111111111111112

Usage Workflows

Workflow 1: Get Token Price

curl -s "https://b.alph.ai/smart-web-gateway/ticker/currentPrice/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/sol"

Response:

{
  "code": "200",
  "data": {
    "p": "0.00000007466851836622579444836694",
    "ts": 1771919495625
  }
}
  • p: Current price in SOL
  • ts: Timestamp (milliseconds)

Workflow 2: Get 24H Statistics

curl -s "https://b.alph.ai/smart-web-gateway/ticker/24h/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/sol"

Response:

{
  "code": "200",
  "data": {
    "ticker": {
      "s": 86400,
      "bc": 4666,
      "ba": "4021.03",
      "sc": 8649,
      "sa": "7405.90",
      "a": "11426.94",
      "v": "152228037642.53",
      "r": "-0.0071",
      "c": "0.00000007465702",
      "h": "0.00000007648662",
      "o": "0.00000007519613",
      "l": "0.00000003749341"
    },
    "ts": 1771919500555
  }
}

Fields:

  • o/h/l/c: Open/High/Low/Close prices (in SOL)
  • v: Volume (token amount)
  • a: Trading amount (in SOL)
  • r: Price change rate (e.g., -0.0071 = -0.71%)
  • bc/ba: Buy count / Buy amount (SOL)
  • sc/sa: Sell count / Sell amount (SOL)

Workflow 3: Multi-Timeframe Ticker

curl -s "https://b.alph.ai/smart-web-gateway/ticker/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/sol"

Returns data keyed by seconds: 60, 300, 3600, 21600, 43200, 86400 (1min to 24h).

Workflow 4: Token Holder Analysis

# Get holder statistics
curl -s "https://b.alph.ai/smart-web-gateway/coin/detail/holders/stats?token=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&chain=sol"

Response:

{
  "code": "200",
  "msg": "suc",
  "data": {
    "totalHolders": "571148",
    "top10Percent": 0.381,
    "top100Percent": 0.6918,
    "developerPercent": 0.0,
    "sniperPercent": 0,
    "insiderTradingPercent": 0,
    "bundleWalletPercent": 0,
    "phishingPercent": 0
  }
}

Workflow 5: Whale / Banker Tracking

# Get whale groups for a token
curl -s "https://b.alph.ai/smart-web-gateway/coin/detail/bankers?token=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&chain=sol"

Returns wallet addresses with: holdingsRate, totalBuyAmount, totalSellAmount, totalPnl, realizedPnl, unrealizedPnl.

Workflow 6: Smart Wallet Intelligence

# List top smart wallets
curl -s "https://b.alph.ai/smart-web-gateway/smart/smart-wallet?chain=sol&language=en_US"

# Get wallet details
curl -s "https://b.alph.ai/smart-web-gateway/smart/wallet?wallet=2jJfuPMN3R3Se5c8y7BdeiQDJMKv9wms1z1wG14xJH4H&chain=sol&language=en_US&type=DAY_7"

# Get wallet holdings
curl -s "https://b.alph.ai/smart-web-gateway/smart/holding-tokens?wallet=2jJfuPMN3R3Se5c8y7BdeiQDJMKv9wms1z1wG14xJH4H&chain=sol&language=en_US&pageNum=1&pageSize=20"

# Get wallet trade history
curl -s "https://b.alph.ai/smart-web-gateway/smart/wallet-activity?wallet=2jJfuPMN3R3Se5c8y7BdeiQDJMKv9wms1z1wG14xJH4H&chain=sol&language=en_US&pageSize=20"

# Get wallet PnL by token
curl -s "https://b.alph.ai/smart-web-gateway/smart/wallet-profit-loss?wallet=2jJfuPMN3R3Se5c8y7BdeiQDJMKv9wms1z1wG14xJH4H&chain=sol&language=en_US&pageNum=1&pageSize=20"

Workflow 7: Discover Hot Tokens

# Top tokens by banker net inflow (24h)
curl -s -X POST "https://b.alph.ai/smart-web-gateway/sherlock/popular_token/getTopTokenByBanker" \
  -H "Content-Type: application/json" \
  -d '{"chain":"sol"}'

Response includes: token, tokenCode, bankerNumb, bankerRate, marketCap, bankerNetInflow, platformName.

Workflow 8: Get Available DEX Platforms

curl -s "https://b.alph.ai/smart-web-gateway/common/platform/sol"

Returns: Pump, Moonit, Raydium, Boop, Believe, Dynamic BC, Jupiter Studio, Moonshot, Bags, Bankr, Bonk, etc.

Output Formatting

When displaying market data to users:

## BONK/SOL Price

**Current Price**: 0.00000007467 SOL (~$0.0000114)
**24h Change**: -0.71% ↘
**24h High**: 0.00000007649 SOL
**24h Low**: 0.00000003749 SOL
**24h Volume**: 152.2B BONK (~11,427 SOL)

**Trading Activity (24h)**:
- Buys: 4,666 trades (4,021 SOL)
- Sells: 8,649 trades (7,406 SOL)
- Net Flow: -3,385 SOL (sell pressure)

**Holder Stats**:
- Total Holders: 571,148
- Top 10 Hold: 38.1%
- Top 100 Hold: 69.2%

_Last updated: {timestamp}_

Tips

  1. Prices in SOL: All prices are SOL-denominated. Convert to USD by multiplying by SOL/USD rate.
  2. Param name is wallet: When querying wallet endpoints, use wallet= not address=.
  3. Language param: Add language=en_US for English responses on smart wallet endpoints.
  4. Pagination: Use pageNum and pageSize for paginated endpoints.
  5. Sort: Some endpoints support sort (field name) and asc (asc/desc) params.

Error Handling

Code Message Solution
200 Success Normal response
400 Bad request Check parameter names (e.g., use wallet not address)
500 sys error Endpoint may be unavailable or needs different params
501 not support Wrong chain – use sol only

Related Skills

  • trading-execution: Execute trades based on market data
  • auth-helper: Setup authentication for trading operations