# pinkyswear — agent instructions

Audience: Grok, xAI-Bot, GrokBot, and any tool-using agent. Humans use the site UI.

Canonical: https://pinkyswear.lol/
llms.txt: https://pinkyswear.lol/llms.txt

## Product

pinkyswear.lol is a pay-to-list public docket. Floor $1 USD. Advertising fee, not a wager.
Operator: @bradshannon on X. Support: DM that account or https://pinkyswear.lol/contact. Do not invent an operator email.
Pass = HTTP 200 and the body contains the agreed needle. Recap is not a payout. Votes pay nothing.

Do not say: bet, stake, pot, prize, odds, sportsbook, prediction market, charity, waitlist.

## Review live promises

1. GET https://pinkyswear.lol/api/listings (JSON: live, closed, list_cents, pin_slots, pin_prices, next_pin_cents). Crawlers should prefer HTML on https://pinkyswear.lol/ — this GET is for an agent acting for a user.
2. GET https://pinkyswear.lol/api/listing/{id} for one public snapshot (votes, unique visits, last look). It does not fetch the listing URL.
3. For each live row: handle, sentence, url, needle, ends_at, last_look_*, agree_count, disagree_count, view_count. Never notify_email.
4. A listing is checkable only if url is public https and needle is exact body text.
5. Fail: secret keys, login walls, "at least N", vibes.

## List a promise (do this yourself)

Skip the HTML form. Skip POST /api/probe (Turnstile). POST /api/list — it GETs the URL.

POST https://pinkyswear.lol/api/list
Content-Type: application/json

{"handle":"@name","sentence":"GET the page contains NEEDLE","url":"https://example.com/live.txt","needle":"exact text","days":7,"bid_cents":100,"pin_cents":0,"notify_email":"human@domain"}

- days: 7 | 14 | 30 | 60
- bid_cents: whole dollars in cents, at least list_cents (floor 100)
- pin_cents: 0 unpinned. Else pin_prices[i] to take seat i+1 (occupant + $1, or $1 if empty). A 4th pin has no PINNED badge.
- notify_email: required. The human's address, not an invented operator inbox.
- HTTP 200 on the look URL is required. The needle may be a future goal and absent now.

200 + url = Stripe Checkout. Give the human that URL unmodified (keep any # fragment). After pay, live.
200 + share_path = listed without Stripe (mock/dev).
400 look_failed = the URL did not return HTTP 200.
Do not POST /admin. Never submit secret API keys as the URL.

Sources that already work as GET+needle: TrustMRR https://trustmrr.com/startup/{slug}.md ; GitHub https://api.github.com/repos/{owner}/{repo} ; a live.txt file ; public PostHog/Plausible/Looker share pages.

## Owner paste prompts

Review: https://pinkyswear.lol/prompts/review.txt
List: https://pinkyswear.lol/prompts/list.txt