> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dripstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Pay-once article summaries for agents researching financial newsletters and blogs.

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

1. **Search or target a publication** — search across all supported financial
   newsletters and blogs for relevant posts, or query specific publications.
   Discovery routes are free.
2. **Inspect the price** — article prices appear as `priceCents` when you list a
   publication or search for posts. Clients can also inspect the authoritative price in the
   runtime `402` response before paying.
3. **Pay & retrieve the summary** — request a robust article summary using
   [x402 on Base or Solana, or MPP on Tempo or Stripe](/concepts/payment-flow), or authenticate with
   an [API key backed by account credits](/quickstart-api-keys). 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](/search) |
| Named newsletter, author, or catalog browse | `GET /api/v1/publications/search` or `GET /api/v1/publications` | [Publications](/publications) |
| Who is **NVDA** / nvidia.com? | `GET /api/v1/companies` | [Company Lookup](/companies) |
| Articles that **mention** a ticker, company, person, org, or theme | `GET /api/v1/entities/search` | [Entity Search](/entity-search/ticker) |
| Popular posts or publications | `GET /api/v1/posts/top-selling` or `GET /api/v1/publications/top-selling` | [Top-selling](/top-selling) |

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

For ticker-level analyst calls, use `GET /api/v2/stock-picks` (preferred) or
`GET /api/v1/stock-picks`. These return [Stock Picks](/stock-picks) through
subscription access (V2) or per-request payment. A paid bundle does not grant
lifetime unlocks for its source posts.

## Account, credits, and past purchases

API keys and MCP OAuth tokens for the same account share one Drip user.
The account routes below reject session JWTs.

| Need | Route | Guide |
| - | - | - |
| Who is this credential? | `GET /api/v1/me` | [Account](/account) |
| Credit balance and top-up URL | `GET /api/v1/me/credits` | [Credits](/credits) |
| Credit ledger | `GET /api/v1/me/credits/activity` | [Credits](/credits#ledger) |
| Posts this account already unlocked | `GET /api/v1/me/unlocks` | [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_…`.

<CardGroup cols={2}>
  <Card title="Quickstart: x402 / MPP" href="/quickstart" icon="rocket">
    Search, inspect the price, and retrieve an article summary with a payment-aware client.
  </Card>

  <Card title="Quickstart: API Keys" href="/quickstart-api-keys" icon="key">
    Use a bearer API key and account credits to retrieve paid article summaries.
  </Card>

  <Card title="Core Concepts" href="/concepts/core-concepts" icon="book-open">
    Publications, posts, search, and paid article summaries.
  </Card>

  <Card title="Topic Search" href="/search" icon="magnifying-glass">
    Relevance-ranked posts for a topic across supported newsletters and podcasts.
  </Card>

  <Card title="Publications" href="/publications" icon="newspaper">
    Find a named source, browse the catalog, or list recent posts.
  </Card>

  <Card title="Top-selling" href="/top-selling" icon="fire">
    Most purchased posts and highest-earning publications.
  </Card>

  <Card title="Stock Picks" href="/stock-picks" icon="chart-line">
    Ticker-level analyst calls and long/short ideas — V2 subscription or x402, legacy V1.
  </Card>

  <Card title="Curated Endpoints" href="/curated-endpoints" icon="box">
    Structured research feeds such as top-selling.
  </Card>

  <Card title="Payment Options" href="/concepts/payment-flow" icon="credit-card">
    Wallet payment challenges, API-key credits, and status codes.
  </Card>

  <Card title="Errors & Retries" href="/concepts/errors-retries" icon="arrows-rotate">
    Handle failures safely across discovery, credits, x402, and MPP.
  </Card>

  <Card title="Discovery" href="https://dripstack.com/openapi.json" icon="compass">
    The OpenAPI 3.1 document, including paid-route payment metadata.
  </Card>

  <Card title="Company Lookup" href="/companies" icon="building">
    Identity card for a ticker, domain, qid, CIK, or name — not article search.
  </Card>

  <Card title="Entity Search" href="/entity-search/ticker" icon="search">
    Recency-ranked articles that mention a ticker, company, person, organization, or subject.
  </Card>

  <Card title="Account" href="/account" icon="user">
    Auth introspection, credits, ledger, and lifetime unlocks for an API key or MCP token.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.