Skip to main content
GET
V2 — Stock picks with subscription access, credits, or x402 pay-per-use.

Headers

Authorization
string

Bearer API key, OAuth access token, or session JWT. PRO/EXPERT subscription reads are included; other authenticated callers spend Drip credits.

PAYMENT-SIGNATURE
string

x402 v2: after HTTP 402, retry with the encoded payment payload from the PAYMENT-REQUIRED challenge (same header name as in @x402/core HTTP transport).

Query Parameters

date
string

UTC calendar day to return (mutually exclusive with from/to). Outside a subscriber's plan window this returns 403.

Pattern: ^\d{4}-\d{2}-\d{2}$
from
string

Range start (inclusive). Intersected with the subscriber's allowed window — a Pro request for from=2020-01-01 is clamped to the start of the Pro window.

Pattern: ^\d{4}-\d{2}-\d{2}$
to
string

Range end (inclusive). Also intersected with the subscriber's allowed window.

Pattern: ^\d{4}-\d{2}-\d{2}$
limit
integer
default:200

Maximum pick rows per day (1-500). Defaults to 200.

Required range: 1 <= x <= 500
limitDays
integer
default:7

Maximum days returned per range page (1-30). Pass the previous response's pagination.nextCursor as cursor to fetch older days.

Required range: 1 <= x <= 30
cursor
string

Older-than marker: return days strictly before this date (the previous page's pagination.nextCursor).

Pattern: ^\d{4}-\d{2}-\d{2}$
author
string

Exact author name filter (paid tiers only).

Maximum string length: 100
query
string

Case-insensitive substring over ticker, author, and publication title (paid tiers only).

Maximum string length: 200
sort
enum<string>
default:newest

Order rows within the current page by pick date and publish time. Range pages always select newer days first and the cursor moves toward older days, even with oldest sorting.

Available options:
newest,
oldest
includePrices
enum<string>

Pass false to omit prices. Available by default only for historical subscription reads (omitted for the current day and pay-per-use reads); prices require a resolved identity and matching provider symbol, exchange, asset type, and currency. Unverified prices are omitted.

Available options:
true,
false

Response

Stock picks within the caller's allowed range.

meta
object
required
pagination
object
required
picks
object[]
required

Flat pick rows, sorted by date per sort.