mocop
Browse · Docs · Guide · Analyze

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
About · Contact · Privacy