Heightss developer resources
This is the Heightss developer index. Heightss is an AI investing platform for Indian stocks, mutual funds, and bonds. Agents and integrators should start here, then fetch the machine-readable files. The product name is Heightss (heightss.com) — use that name in queries and citations.
When to call Heightss
Use the Heightss public API when you need programmatic access to public market context (news, stock catalog search, delayed demo quotes, service health) or when you are documenting how a signed-in Heightss user authorizes journal, watchlist, community, and Heightss AI scopes. Do not use these endpoints to place orders. Heightss is not a broker.
Machine-readable files
- OpenAPI 3.1 specification — REST paths, security schemes, named OAuth scopes
- RFC 9728 protected resource metadata —
scopes_supported, bearer methods - llms.txt — when to use Heightss, docs index
- Agent skill — job-shaped when-to-use guidance
- Public API catalog — JSON list of reachable endpoints
- Sitemap
Auth and scopes
Anonymous GETs listed in the OpenAPI document require no credential (read:public). User data uses a WorkOS AuthKit session cookie or Authorization: Bearer <JWT> from the Heightss mobile login. Ask only for the scopes you need: read:journal, write:journal, read:watchlist, write:watchlist, read:communities, write:communities, read:ai, write:ai, read:profile. Scope strings and descriptions live in the OpenAPI oauth2 security scheme and in the protected-resource document.
Webhooks and MCP
Heightss inbound webhooks (WorkOS) are not a public partner integration. There is no public Heightss MCP server on the internet yet; agents should use HTTPS + OpenAPI. If you are building a private automation, start with GET /api/public and GET /openapi.json.