API

API Reference

The DRIP API provides programmatic access to all research capabilities. No API keys — authentication and payment happen via the x402 protocol on Solana.

Base URL

https://api.drip.surf

Authentication

DRIP uses the x402 payment protocol instead of API keys. Every request follows this flow:

Send a standard HTTP request to any endpoint.
Receive a 402 Payment Required response with payment details (amount, recipient, token).
Submit the payment on Solana using USDC.
Retry the request with the X-Payment-Proof header containing the transaction signature.
Receive the data.

Example — curl

Step 1: Initial request

curl -i https://api.drip.surf/research?domain=anthropic.com

# HTTP/1.1 402 Payment Required
# X-Payment-Amount: 0.05
# X-Payment-Token: USDC
# X-Payment-Recipient: <drip-wallet-address>

Step 2: Retry with payment proof

curl https://api.drip.surf/research?domain=anthropic.com \
  -H "X-Payment-Proof: <solana-tx-signature>"

✅The SDK and CLI handle this flow automatically. You only need to manage payment proofs manually when using raw HTTP requests.

Endpoints

GET/research~$0.05

Full company research — industry, funding, tech stack, key people, and more.

GET/enrich~$0.05

Person enrichment — resolve an email or LinkedIn URL into a complete profile.

GET/social~$0.05

Social intelligence — sentiment, trends, and engagement data for any topic.

GET/sentiment~$0.03

Sentiment analysis — positive/negative/neutral scoring for tokens or topics.

GET/market~$0.02

Live market data — price, volume, liquidity, and price changes for any token.

GET/brain~$0.05

AI brain — free-form query processed by the AI reasoning engine with tool selection.

Response Format

All endpoints return JSON with a consistent envelope:

Response envelope

{
  "status": "success",
  "data": { ... },
  "meta": {
    "sources": ["source1", "source2"],
    "confidence": 0.92,
    "costUsd": 0.05,
    "durationMs": 2340
  }
}

← Capabilities Company Research →