📖 Documentation Menu

API

Market Data API

Live token market data from on-chain sources and aggregators. Returns price, market cap, volume, liquidity, and price changes.

Endpoint

GET https://api.drip.surf/market

Parameters

ParameterTypeRequiredDescription
tokenstringYesToken ticker or mint address (e.g. SOL, DRIP)
chainstringNoBlockchain to query. Defaults to solana.

Response

200 OK
{
  "status": "success",
  "data": {
    "token": "DRIP",
    "chain": "solana",
    "priceUsd": 0.00234,
    "marketCap": 234000,
    "volume24h": 45200,
    "priceChange24h": 12.5,
    "priceChange1h": 2.1,
    "priceChange7d": -3.4,
    "liquidity": {
      "usd": 89000,
      "base": 38000000,
      "quote": 89000
    },
    "pairAddress": "...",
    "dexUrl": "https://dexscreener.com/solana/..."
  },
  "meta": {
    "sources": ["dexscreener", "jupiter"],
    "confidence": 0.97,
    "costUsd": 0.02,
    "durationMs": 890
  }
}

Examples

curl

Token market data
curl "https://api.drip.surf/market?token=DRIP" \
  -H "X-Payment-Proof: <tx-signature>"
With explicit chain
curl "https://api.drip.surf/market?token=SOL&chain=solana" \
  -H "X-Payment-Proof: <tx-signature>"

SDK

TypeScript
import { Drip } from "@drip/sdk";

const drip = new Drip({ wallet: "<your-wallet>" });

const market = await drip.market("DRIP");
console.log(market.priceUsd);        // 0.00234
console.log(market.volume24h);       // 45200
console.log(market.priceChange24h);  // 12.5
💡Market data is sourced primarily from DexScreener and Jupiter. Price updates are near real-time, typically within 30 seconds of on-chain activity.