Skip to main content
GET
/
api
/
v1
/
stock-picks
List stock-picker calls for one day (paid).
curl --request GET \
  --url https://dripstack.xyz/api/v1/stock-picks
{
  "dateUsed": "2026-06-14",
  "startDate": "2026-06-14",
  "endDate": "2026-06-14",
  "asOf": "2026-06-15T10:30:00Z",
  "count": 2,
  "items": [
    {
      "id": "sp_abc123",
      "callId": "call_def456",
      "author": "Luke Gromen",
      "articleTitle": "The Dollar Endgame",
      "articleUrl": "https://thefr.substack.com/p/dollar-endgame",
      "publishedAt": "2026-06-14T09:00:00Z",
      "ticker": "GLD",
      "tickerExchange": "NYSE",
      "instrumentType": "ETF",
      "action": "NEW_POSITION",
      "direction": "LONG",
      "authorConviction": 4,
      "convictionLabel": "High",
      "activePick": true,
      "evidenceQuote": "Gold remains the only asset that balances sovereign balance sheet risk.",
      "rationaleSnippet": "Rising fiscal deficits and de-dollarization trends support gold allocation.",
      "publicationSlug": "the-fr",
      "postSlug": "dollar-endgame"
    }
  ]
}

Headers

​
Authorization
string

MPP (Payment HTTP Authentication Scheme): after HTTP 402, retry with Authorization: Payment <credential>.

​
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 effective calendar day to return. Mutually exclusive with period. When omitted, the server resolves the latest day with picks.

Pattern: ^\d{4}-\d{2}-\d{2}$
​
period
enum<string>

When latest, same as omitting date (latest effective day with picks). Mutually exclusive with date.

Available options:
latest
​
limit
integer
default:200

Maximum number of stock-pick calls returned (1-500). Defaults to 200.

Required range: 1 <= x <= 500

Response

Stock-picker calls after successful payment.

​
dateUsed
string
required

Single UTC effective calendar day returned (publishedAt, or extraction time internally when publication time is missing).

​
startDate
string
required

Same as dateUsed for single-day responses.

​
endDate
string
required

Same as dateUsed for single-day responses.

​
asOf
string
required

Server timestamp when the response was generated.

​
count
integer
required

Number of stock-pick items returned.

Required range: x >= 0
​
items
object[]
required

Stock-picker calls for the resolved single day.