Add options market research to your platform. Every response includes structured data, confidence scores, and required disclaimers.
Three steps to your first response.
Email api@giottoo.com or apply via the API Access page. Keys are issued for approved use cases within 1–3 business days.
Pass your key in the X-GiottoO-Key header. All requests use HTTPS.
curl https://giottoo.com/api/v1/ai/symbol/SPY/summary \ -H "X-GiottoO-Key: your-api-key"
Every response includes a disclaimer field. You must surface this to end users per the API Terms of Service.
{
"data": { "summary": "...", "confidence": 0.72 },
"disclaimer": "For informational purposes only...",
"isMockData": false,
"timestamp": "2026-07-04T14:00:00Z",
"dataLabel": "delayed-15min"
}All API requests require the X-GiottoO-Key header. Keys are scoped to your account tier and cannot be shared across applications.
GET /api/v1/ai/symbol/SPY/summary HTTP/1.1 Host: giottoo.com X-GiottoO-Key: gto_sk_live_xxxxxxxxxxxxxxxx
Every response envelope includes these required fields:
dataThe endpoint-specific payload
disclaimerRequired disclosure string — must be surfaced to users
isMockDatatrue when returning demo/sandbox data
timestampISO 8601 UTC response timestamp
dataLabelFreshness and license status label
{
"data": { "summary": "...", "confidence": 0.72 },
"disclaimer": "For informational purposes only. Not financial advice.",
"isMockData": false,
"timestamp": "2026-07-04T14:00:00Z",
"dataLabel": "delayed-15min"
}Base URL: https://giottoo.com
/api/v1/ai/symbol/{ticker}/summaryAI research summary for a symbol
→ { summary, confidence, bias, isMockData, disclaimer }/api/v1/ai/symbol/{ticker}/no-tradeNo-trade analysis across 8 risk categories
→ { decision, reasons[], checks[], disclaimer }/api/v1/data/yield-curveCurrent yield curve shape and spread data
→ { curve, inversion, spread10y2y, timestamp }/api/v1/data/market-sentimentComposite market sentiment score
→ { score, label, components[], timestamp }/api/v1/data/watchlist-rankingIV rank and liquidity ranked watchlist
→ { symbols[], ranked[], noTradeCount, timestamp }/api/v1/alertsRegister a webhook for IV or no-trade alerts
→ { webhookId, status, events[] }/api/v1/outputsSubmit symbol + params for structured research output
→ { output{}, riskFlags[], disclaimer }/api/v1/healthAPI health check and version info
→ { status, version, uptime }| Tier | Calls / Day | Calls / Min | Max Payload | Webhooks |
|---|---|---|---|---|
| Free Sandbox | 100 | 5 | 10 KB | No |
| API Starter | 10,000 | 60 | 100 KB | No |
| API Pro | 100,000 | 300 | 1 MB | Yes |
| API Business | 1,000,000 | 1,000 | 10 MB | Yes |
npm install @giottoo/sdkComing Q3 2026Coming Q4 2026API responses are for informational purposes only. Data redistribution restrictions apply — you may not re-sell or redistribute raw GiottoO API output. See /api-access for full terms. Questions: developers@giottoo.com