# Drip

## Docs

- [Overview](https://docs.dripstack.com/index.md): Pay-per-use API for agents researching financial newsletters and blogs.
- [Quickstart: x402 / MPP](https://docs.dripstack.com/quickstart.md): Give your agent a wallet to pay for robust financial newsletter summaries with x402 on Base or Solana, or MPP on Tempo.
- [Quickstart: API Keys](https://docs.dripstack.com/quickstart-api-keys.md): Use bearer API keys and pre-purchased credits to retrieve robust article summaries.
- [Core Concepts](https://docs.dripstack.com/concepts/core-concepts.md): Key ideas in the Drip API: publications, posts, search, and paid article summaries.
- [Payment Flow](https://docs.dripstack.com/concepts/payment-flow.md): Wallet payment challenges, API-key credits, headers, and pricing semantics.
- [Errors & Retries](https://docs.dripstack.com/concepts/errors-retries.md): Handle Drip API errors without losing research context or creating unintended charges.
- [Curated Endpoints](https://docs.dripstack.com/curated-endpoints.md): Curated endpoints built on top of Drip's indexed financial publications.
- [Search premium financial newsletter and podcast posts by topic.](https://docs.dripstack.com/api-reference/search/search-premium-financial-newsletter-and-podcast-posts-by-topic.md)
- [List curated newsletters, podcasts, and publications.](https://docs.dripstack.com/api-reference/publications/list-curated-newsletters-podcasts-and-publications.md)
- [Search curated publications, newsletters, podcasts, and authors.](https://docs.dripstack.com/api-reference/publications/search-curated-publications-newsletters-podcasts-and-authors.md)
- [Get one publication with recent posts.](https://docs.dripstack.com/api-reference/publications/get-one-publication-with-recent-posts.md)
- [Get synthesized article or podcast post summary (paid).](https://docs.dripstack.com/api-reference/posts/get-synthesized-article-or-podcast-post-summary-paid.md): Returns post metadata and synthesized summary after payment.
- [Access post with credits (paid, same as GET).](https://docs.dripstack.com/api-reference/posts/access-post-with-credits-paid-same-as-get.md): Same unified payment flow as GET. Unauthenticated requests receive a 402 x402/MPP challenge. Authenticated requests (JWT or API key) pay via your credit balance.
- [Quote the stock-picks bundle price for one day (free).](https://docs.dripstack.com/api-reference/stock-picks/quote-the-stock-picks-bundle-price-for-one-day-free.md): Free preflight for the paid stock-picks route. Returns the exact bundle `amountUsd` and per-attributed-post breakdown for the same `date`/`limit` the paid route would charge. Does not return pick rows, tickers, or evidence. Use this before confirming spend, then call `GET /api/v1/stock-picks` (or MC…
- [List stock-picker calls for one day (paid).](https://docs.dripstack.com/api-reference/stock-picks/list-stock-picker-calls-for-one-day-paid.md): Returns structured stock-picker calls for AI-agent consumption. Covers one UTC effective calendar day, not a range. Defaults to the latest day with picks when `date` is omitted. Use `date=YYYY-MM-DD` for a specific day. Rows without `publishedAt` may use extraction time internally. Call the free quo…
- [Auth introspection for the current API key or OAuth token.](https://docs.dripstack.com/api-reference/account/auth-introspection-for-the-current-api-key-or-oauth-token.md): Returns auth method, API key name/suffix (when using `pk_drip_…`), or OAuth scopes (when using `mcp_at_…`). Requires bearer API key or OAuth access token with `mcp:unlock`. Session JWTs are rejected. Never returns raw keys or user ids.
- [Purchased credit balance and top-up URLs.](https://docs.dripstack.com/api-reference/account/purchased-credit-balance-and-top-up-urls.md): Returns purchased balance plus lifetime purchased/spent totals and `topUpUrl` / `dashboardUrl`. Requires bearer API key or OAuth access token with `mcp:unlock`. Session JWTs are rejected. There is no top-up API — send users to `topUpUrl`.
- [Cursor-paginated credit ledger activity.](https://docs.dripstack.com/api-reference/account/cursor-paginated-credit-ledger-activity.md): Returns credit ledger rows for the authenticated account (newest first). Same item fields as the dashboard history. Requires bearer API key or OAuth access token with `mcp:unlock`. Session JWTs are rejected.

## OpenAPI Specs

- [openapi](https://dripstack.com/openapi.json)