{"openapi":"3.1.0","info":{"title":"Heightss Public API","summary":"Programmatic access to Heightss — AI investing for Indian markets.","description":"Public GET endpoints require no credential. User-scoped Heightss APIs (journal, watchlist, communities, Heightss AI) accept a WorkOS session cookie or a Bearer JWT and the named OAuth scopes in components.securitySchemes.oauth2. Heightss is not a broker and does not place orders.","version":"1.0.0","contact":{"name":"Heightss","email":"heightss@heightss.com","url":"https://heightss.com/developers"},"license":{"name":"Proprietary","url":"https://heightss.com/terms"}},"servers":[{"url":"https://heightss.com","description":"Heightss production"}],"tags":[{"name":"Public","description":"Anonymous, cacheable Heightss reads"},{"name":"Discovery","description":"Agent and developer discovery files"}],"paths":{"/api/public":{"get":{"operationId":"getPublicCatalog","summary":"Heightss public API catalog (product name, endpoints, scopes, OpenAPI URL)","tags":["Public"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/health":{"get":{"operationId":"getHealth","summary":"Service health for Heightss (database, redis, AI keys)","tags":["Public"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/news":{"get":{"operationId":"getNews","summary":"Public Indian-market news headlines","tags":["Public"],"security":[],"parameters":[{"name":"category","in":"query","schema":{"type":"string","enum":["all","crypto","india","global","economy","stock"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/stocks/search":{"get":{"operationId":"searchStocks","summary":"Search the Heightss NSE/BSE stock catalog","tags":["Public"],"security":[],"parameters":[{"name":"term","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer"}},{"name":"offset","in":"query","schema":{"type":"integer"}},{"name":"exchange","in":"query","schema":{"type":"string","enum":["NSE","BSE"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/stocks/count":{"get":{"operationId":"countStocks","summary":"Count symbols in the Heightss stock catalog","tags":["Public"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/stock/price/{ticker}":{"get":{"operationId":"getStockPrice","summary":"Latest price for a ticker","tags":["Public"],"security":[],"parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","example":"RELIANCE"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/stock/candles/{ticker}":{"get":{"operationId":"getStockCandles","summary":"Daily OHLCV candles for a ticker","tags":["Public"],"security":[],"parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/landing/quote":{"get":{"operationId":"getLandingQuote","summary":"Delayed demo quote for a small allowlisted symbol set (marketing)","tags":["Public"],"security":[],"parameters":[{"name":"symbol","in":"query","schema":{"type":"string","example":"RELIANCE"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/market-report":{"get":{"operationId":"getMarketReport","summary":"Latest published Heightss market report","tags":["Public"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/openapi.json":{"get":{"operationId":"getOpenApi","summary":"This OpenAPI document","tags":["Public"],"security":[],"responses":{"200":{"description":"OpenAPI 3.1 document","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/llms.txt":{"get":{"operationId":"getLlmsTxt","summary":"Heightss llms.txt (when to use Heightss + developer index)","tags":["Discovery"],"security":[],"responses":{"200":{"description":"text/markdown","content":{"text/markdown":{"schema":{"type":"string"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Heightss mobile callback JWT or WorkOS session presented as Authorization: Bearer. Request only the scopes you need."},"oauth2":{"type":"oauth2","description":"First-party Heightss sign-in via WorkOS AuthKit. Named scopes describe least-privilege access to user data. Third-party OAuth apps are not offered; agents should use public GETs or a user-authorized Bearer token.","flows":{"authorizationCode":{"authorizationUrl":"https://heightss.com/api/login","tokenUrl":"https://heightss.com/api/session","scopes":{"read:public":"Read public Heightss resources: health, market news, stock catalog, delayed demo quotes, and developer discovery files.","read:profile":"Read the signed-in user profile, preferences, and account metadata. Never granted to anonymous callers.","read:journal":"Read the signed-in user trading journal, lots, and performance summaries.","write:journal":"Create, edit, close, or delete journal entries and lot adjustments for the signed-in user.","read:communities":"Read communities the user may access (membership-gated posts, trades, messages).","write:communities":"Post, comment, react, or moderate inside communities the user belongs to.","read:watchlist":"Read the signed-in user watchlist, tracked symbols, and event feed.","write:watchlist":"Add, remove, or dismiss watchlist symbols and events for the signed-in user.","read:ai":"Read Heightss AI sessions and prior answers for the signed-in user.","write:ai":"Start or continue Heightss AI conversations (fast, deep, and research modes) as the signed-in user."}}}}}}}