Base URL
https://api.goltana.com/v1
All endpoints return JSON. All endpoints judge you. HTTPS only — we’re not animals.
Endpoints
POST/auth/tokenExchange credentials for a bearer token.
GET/verdict/{symbol}Get a trade verdict for a ticker. The core of everything.
GET/verdict/{symbol}/greeksFull Greeks surface for a symbol. Includes vanna and charm because we respect your intelligence (tentatively).
GET/flow/dealerCurrent dealer gamma positioning across major indices.
GET/flow/retailAggregated retail sentiment. Useful primarily as a contrarian indicator.
POST/stream/subscribeSubscribe to real-time verdict updates via WebSocket.
GET/fragilityMarket-wide fragility index. Refreshed every 30 seconds. Anxiety refreshed continuously.
GET/history/{symbol}Past 30 days of verdicts for a symbol. For post-mortem purposes.
Verdict Endpoint — Detail
Request
GET /v1/verdict/SPY?timeframe=0dte&include_greeks=true
Authorization: Bearer gt_live_k7x9m2...
Query Parameters
| Parameter | Type | Required | Description |
|---|
timeframe | string | No | 0dte, 1dte, weekly, monthly. Defaults to 0dte because we know why you’re here. |
include_greeks | boolean | No | Include full Greeks surface. Default: false (for the blissfully ignorant). |
honesty | string | No | gentle, standard, brutal. Controls how much the verdict message hurts. Default: standard. |
strikes | integer | No | Number of strikes to analyze around ATM. Default: 10. |
Error Codes
| Code | Meaning | What You Did |
|---|
401 | Unauthorized | Invalid or expired token. The engine forgot you on purpose. |
403 | Forbidden | Your tier doesn’t include this endpoint. Upgrade or accept your limitations. |
404 | Not Found | That symbol doesn’t exist. Neither does your edge. |
429 | Rate Limited | Too many requests. The engine needs space. So do your counterparties. |
500 | Server Error | Something broke. Not your fault for once. |
503 | Market Closed | Markets are closed. Go outside. Touch liquidity. Touch grass. |