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

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
direction
enum<string>

Direction filter (paid tiers only).

Available options:
LONG,
SHORT
query
string

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

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

Order by pick date (and publish time within a day).

Available options:
newest,
oldest
includePrices
enum<string>

Pass false to omit per-ticker performance (entry → latest close, direction-adjusted). On by default.

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.