# Drip

- [Overview](https://docs.dripstack.com/index.md): Pay-once article summaries 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.
- [Topic Search](https://docs.dripstack.com/search.md): Search indexed newsletters and podcasts by topic. Free, ranked by relevance.
- [Search Articles by Ticker](https://docs.dripstack.com/entity-search/ticker.md): Find newsletter and podcast articles that mention a specific stock ticker.
- [Search Articles by Company](https://docs.dripstack.com/entity-search/company.md): Find newsletter and podcast articles that mention a specific company.
- [Search Articles by Person](https://docs.dripstack.com/entity-search/person.md): Find newsletter and podcast articles that mention a person.
- [Search Articles by Organization](https://docs.dripstack.com/entity-search/organization.md): Find newsletter and podcast articles that mention an organization.
- [Search Articles by Subject](https://docs.dripstack.com/entity-search/subject.md): Find newsletter and podcast articles tagged with a theme or subject.
- [Company Lookup](https://docs.dripstack.com/companies.md): Look up a company identity card by ticker, domain, qid, CIK, or name.
- [Publications](https://docs.dripstack.com/publications.md): Browse or search the curated catalog, then list recent posts for one source.
- [Top-selling](https://docs.dripstack.com/top-selling.md): Most purchased posts and highest-earning publications. Free post cards, not summaries.
- [Stock Picks](https://docs.dripstack.com/stock-picks.md): Ticker-level analyst calls with two API versions: V2 (subscription or x402 pay-per-use) and legacy V1 (single-day paid).
- [Curated Endpoints](https://docs.dripstack.com/curated-endpoints.md): Curated endpoints built on top of Drip's indexed financial publications.
- [Account](https://docs.dripstack.com/account.md): Who this API key or MCP OAuth token is, plus links to credits and unlocks.
- [Credits](https://docs.dripstack.com/credits.md): Purchased credit balance, top-up URL, and cursor-paginated ledger activity.
- [Unlocks](https://docs.dripstack.com/unlocks.md): Posts this account already paid to unlock. Metadata only — re-read the summary on the paid post route.
- [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)
- [Find articles that mention an entity or are linked to a stock pick.](https://docs.dripstack.com/api-reference/search/find-articles-that-mention-an-entity-or-are-linked-to-a-stock-pick.md): Free article discovery sorted by publication date (latest first by default) — use this to answer "what did analysts say about X this week?" rather than /api/v1/search's topic-relevance ranking. Set stockPicksOnly=true to restrict results to source posts linked to stock-pick rows. With stockPicksOnly…
- [Look up a company profile by ticker, domain, qid, CIK, or name.](https://docs.dripstack.com/api-reference/companies/look-up-a-company-profile-by-ticker-domain-qid-cik-or-name.md): Identity lookup for a company (who is NVDA / nvidia.com?), not article search. Use /api/v1/entities/search after you have a ticker to find articles that mention it. At least one of ticker, domain, qid, cik, or name is required. When more than one is given, lookup uses qid, then ticker, then domain,…
- [Get one company profile by id.](https://docs.dripstack.com/api-reference/companies/get-one-company-profile-by-id.md): Returns the same profile object as an item from GET /api/v1/companies. Unknown ids and ids that are not companies return 404.
- [List curated newsletters, podcasts, and publications.](https://docs.dripstack.com/api-reference/publications/list-curated-newsletters-podcasts-and-publications.md)
- [List the highest-earning publications.](https://docs.dripstack.com/api-reference/publications/list-the-highest-earning-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)
- [List curated podcasts.](https://docs.dripstack.com/api-reference/podcasts/list-curated-podcasts.md)
- [Get one podcast with recent episodes.](https://docs.dripstack.com/api-reference/podcasts/get-one-podcast-with-recent-episodes.md)
- [List the most purchased posts.](https://docs.dripstack.com/api-reference/posts/list-the-most-purchased-posts.md)
- [Get article, podcast, or book chapter content (paid).](https://docs.dripstack.com/api-reference/posts/get-article-podcast-or-book-chapter-content-paid.md): Returns post metadata and synthesized summary after payment. Podcast episodes may include a transcript; book chapters include raw Markdown in `content`. The first successful pay unlocks that post forever for the paying subject (Drip user for credits/API key/JWT/MCP OAuth; wallet or MPP credential ot…
- [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 — first pay unlocks forever for that subject; later fetches are free. Unauthenticated requests receive a 402 x402/MPP challenge. Authenticated requests (JWT or API key) pay via your credit balance on first unlock.
- [V1 — Quote the stock-picks bundle price for one day (free, legacy).](https://docs.dripstack.com/api-reference/stock-picks/v1-—-quote-the-stock-picks-bundle-price-for-one-day-free-legacy.md): V1 (legacy — still available; prefer V2). 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,…
- [V1 — List stock-picker calls for one day (paid, legacy).](https://docs.dripstack.com/api-reference/stock-picks/v1-—-list-stock-picker-calls-for-one-day-paid-legacy.md): V1 (legacy — still available; prefer V2 `/api/v2/stock-picks` for new integrations). 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…
- [V2 — Stock picks with subscription access or x402 pay-per-use.](https://docs.dripstack.com/api-reference/stock-picks/v2-—-stock-picks-with-subscription-access-or-x402-pay-per-use.md): V2 (recommended over V1). Tier-aware stock-picks API. Bearer API key / JWT / OAuth resolves the subscription first: EXPERT sees full history, PRO is clamped to the live 7-day window, and neither is ever charged for requests their plan covers. Anonymous callers and FREE subscribers get no free API ac…
- [V2 — Quote the stock-picks bundle price for one day (free).](https://docs.dripstack.com/api-reference/stock-picks/v2-—-quote-the-stock-picks-bundle-price-for-one-day-free.md): V2 (recommended over V1). Free preflight identical to V1: same price logic and response shape for the same `date`/`limit`. Returns the exact bundle `amountUsd` the paid flow would charge. No auth required.
- [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.
- [Cursor-paginated posts unlocked for lifetime access.](https://docs.dripstack.com/api-reference/account/cursor-paginated-posts-unlocked-for-lifetime-access.md): Returns posts this account already paid to unlock (newest first). Metadata only — `synthesizedSummary` stays on the paid publication-post route / `unlock_post`. Requires bearer API key or OAuth access token with `mcp:unlock`. Session JWTs are rejected.

## OpenAPI Specs

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