Kova API
API by Kova · rest
Kova API for programmatic portfolio evaluation against investment strategies. Authentication Strategy and portfolio endpoints require an active subscription. Journal endpoints admit every subscriber and entitled Gigantes members; agent authentication also admits those members without a Kova subscription. All except the CLI authentication-code exchange require a Bearer token in the Authorization header. Tokens are generated from the Kova web app Settings page or via the CLI browser auth flow. CLI Authentication The CLI uses a PKCE-like browser auth flow: 1. CLI opens browser to /auth/cli/start with code_challenge and state 2. User approves in the web app 3. Web app redirects to localhost callback with a one-time code 4. CLI exchanges code + code_verifier via POST /auth/cli/exchange for an API token Alternatively, users can paste a token directly with kova auth login --token. Brief Lifecycle Creating a brief is asynchronous. The flow is: 1. POST…
Endpoint: https://kovatools.com/api/v1
Verification: observed. Source: crawl.
Capabilities (45)
- Exchange CLI auth code for API token
- Get authentication status
- List recent journal entries archive or your drafts
- Read an entry without marking it served
- Edit a draft or publish a revision immediately
- Retired server-side decision refinement
- Acknowledge presentation or record explicit private feedback
- Publish a reviewed draft dismiss a draft or retract a publication
- Upload a private chart before attaching it to a read
- Retrieve chart bytes with current journal authorization
- Enable or disable recent journal updates
- Create an authored read; publish immediately on posting intent or save a…
- List strategies
- Create strategy
- Create a manual asset for a strategy
- Update a manual asset for a strategy
- Delete a manual asset for a strategy
- Get brief (poll for status)
- List all cash flows for a strategy's portfolio
- Record a cash flow (deposit or withdrawal)
- Remove a cash flow record
- Read understanding without creating work
- List questions 25 per page
- Read a question and 50 responses
- Save the user response before interpreting it