API documentation

Getting started

Create a key on the API Keys page. Test keys (gio_test_…) are free and return demo data. Live keys (gio_live_…) require a Pro or Enterprise subscription and return live intelligence.

Authentication

Send your key on every request, either as a bearer token or the x-api-key header:

curl -H "Authorization: Bearer gio_test_your_api_key" \
  "https://giottoo.com/api/v1/ticker/AAPL/summary"

Rate limits

Exceeding the per-minute burst returns 429 rate_limit_exceeded; exceeding the monthly quota returns 403 plan_limit_exceeded.

Error codes

Errors return { "error": { "code", "message" } }. Endpoints still pending a data-licensing review return 403 endpoint_pending_licensing.

Example response

{
  "data": {
    "symbol": "AAPL",
    "price": 187.42,
    "giottoo_score": 82,
    "sentiment": "bullish",
    "risk_level": "medium",
    "summary": "Elevated bullish options activity with supporting volume."
  },
  "meta": {
    "endpoint": "/api/v1/ticker/AAPL/summary",
    "plan": "pro",
    "environment": "live",
    "data_freshness": "live",
    "is_mock": false,
    "generated_at": "2026-07-08T00:00:00.000Z",
    "request_id": "…"
  },
  "disclaimer": "Educational market analysis only. Not financial advice.",
  "not_financial_advice": true
}

Code examples

JavaScript

const res = await fetch(
  "https://giottoo.com/api/v1/signal-score/AAPL",
  { headers: { "x-api-key": "gio_live_your_api_key" } }
);
const { data } = await res.json();
console.log(data.giottoo_score, data.sentiment);

Python

import requests

r = requests.get(
    "https://giottoo.com/api/v1/options-flow",
    headers={"Authorization": "Bearer gio_live_your_api_key"},
    params={"symbol": "NVDA", "min_premium": 1_000_000},
)
print(r.json()["data"]["events"])

Data limitations & compliance

• The API sells GiottoO's own derived analytics. Raw restricted third-party data is never redistributed.
• Some endpoints are disabled pending data-licensing review and return endpoint_pending_licensing.
• Every response includes data_freshness and is_mock — never treat demo/sample data as a live quote.
• Educational market analysis only. Not financial advice. Options involve substantial risk.

Webhooks and a self-serve developer billing portal are on the roadmap. For enterprise limits or custom data licensing, contact us.