Overview - Drip

Drip gives AI agents pay-once access to robust summaries of premium financial newsletter and blog articles. Discover relevant posts for free, then pay when your agent requests an article summary for its research. Each first successful paid fetch of a post summary unlocks that post forever for the paying subject. Later fetches of the same post return the live summary with no charge.

How it works

Search or target a publication — search across all supported financial newsletters and blogs for relevant posts, or query specific publications. Discovery routes are free.
Inspect the price — article prices appear as priceCents when you list a publication. Wallet clients can also inspect the authoritative price in the runtime 402 response before paying.
Pay & retrieve the summary — request a robust article summary using x402 on Base or Solana, or MPP on Tempo, or authenticate with an API key backed by pre-purchased credits. The first successful pay unlocks that post forever for that Drip user (API key / JWT / MCP OAuth share the same account) or wallet/MPP credential. x402 and MPP clients should store X-Drip-Unlock / unlockToken for free re-reads.

More discovery routes

Topic search is the default. These routes cover the other free questions:

Question	Route	Guide
Articles about a topic	`GET /api/v1/search`	Topic Search
Named newsletter, author, or catalog browse	`GET /api/v1/publications/search` or `/publications`	Publications
Who is NVDA / nvidia.com?	`GET /api/v1/companies`	Company Lookup
Articles that mention a ticker, company, person, org, or theme	`GET /api/v1/entities/search`	Entity Search
Popular posts or publications	`GET /api/v1/posts/top-selling` or `/publications/top-selling`	Top-selling
Stock picks (ticker-level analyst calls)	`GET /api/v2/stock-picks` (V2, preferred) or V1 `/stock-picks`	Stock Picks

Company lookup is an identity card, not article search. After you have a ticker, use entity search for mentioning articles.

Account, credits, and past purchases

API keys and MCP OAuth share one Drip user. Session JWTs are rejected.

Need	Route	Guide
Who is this credential?	`GET /api/v1/me`	Account
Credit balance and top-up URL	`GET /api/v1/me/credits`	Credits
Credit ledger	`GET /api/v1/me/credits/activity`	Credits
Posts this account already unlocked	`GET /api/v1/me/unlocks`	Unlocks

There is no top-up API — send users to topUpUrl. Unlocks are metadata only; the summary still comes from the paid post route. Hosted MCP at https://dripstack.com/api/mcp mirrors the same HTTP routes (search_posts, search_entities, search_companies, unlock_post, …). Discovery tools need no auth; account and paid tools need OAuth or Bearer pk_drip_….

Quickstart: x402 / MPP

Search, inspect the price, and retrieve an article summary with a payment-aware client.

Quickstart: API Keys

Use a bearer API key and pre-purchased credits to retrieve paid article summaries.

Core Concepts

Publications, posts, search, and paid article summaries.

Topic Search

Relevance-ranked posts for a topic across supported newsletters and podcasts.

Publications

Find a named source, browse the catalog, or list recent posts.

Top-selling

Most purchased posts and highest-earning publications.

Stock Picks

Ticker-level analyst calls and long/short ideas — V2 subscription or x402, legacy V1.

Curated Endpoints

Structured research feeds such as top-selling.

Payment Options

Wallet payment challenges, API-key credits, and status codes.

Errors & Retries

Handle failures safely across discovery, credits, x402, and MPP.

Discovery

The OpenAPI 3.1 document, including paid-route payment metadata.

Company Lookup

Identity card for a ticker, domain, qid, CIK, or name — not article search.

Entity Search

Recency-ranked articles that mention a ticker, company, person, organization, or subject.

Account

Auth introspection, credits, ledger, and lifetime unlocks for an API key or MCP token.

​How it works

​More discovery routes

​Account, credits, and past purchases