REST API

A JSON HTTP API for your funds.
Base URL: https://api.fundautic.com.

Auth & roles

Authenticate with your API key as a bearer token. GET (read) endpoints work for any operator in a Pro org. Writes (anything that creates or approves orders) require the owner or admin role and are marked OWNER/ADMIN below. Every request is scoped to your organization; another org's fund returns 403.

curl https://api.fundautic.com/api/funds/diamond-ai/nav \
  -H "Authorization: Bearer fpk_your_key_here"

Status codes

401 invalid/revoked key
402 org isn't on Pro
403 role not allowed, or fund not in your org
404 unknown resource

Funds & roster

GET/api/funds

List every fund your key can access (slug, names, sleeves, accent).

GET/api/funds/{slug}

One fund's configuration and strategy doc (sleeves, outgrowth threshold, market-cap ceiling, strategy markdown).

GET/api/funds/{slug}/constituents

Active roster: ticker, company, sleeve, band, sub-category, target weight, thesis summary.

GET/api/funds/{slug}/constituents/{ticker}

Full detail for one constituent — target / current / drift, holding shares + cost basis, price, market cap, next earnings.

Positions & performance

GET/api/funds/{slug}/positions

Current positions joined with today's move, market value, weight and drift.

GET/api/funds/{slug}/holdings

Raw holdings — shares and cost basis per ticker.

GET/api/funds/{slug}/nav

NAV summary: market value, cost basis, unrealized P/L, today's flow-adjusted move.

GET/api/funds/{slug}/period-returns

7d / 30d / 90d / YTD / inception flow-adjusted returns, paired against SPY.

GET/api/funds/{slug}/sleeves

Per-sleeve breakdown — market value, cost basis, unrealized P/L, %.

GET/api/funds/{slug}/bands

Band / weight-drift status per constituent.

GET/api/funds/{slug}/intraday

Intraday value series for the current session.

GET/api/funds/{slug}/snapshots

Daily NAV snapshots (history).

GET/api/aggregate/nav

Combined NAV across all your funds.

GET/api/aggregate/period-returns

Combined period returns across all your funds.

Research & signals

GET/api/funds/{slug}/alerts

Currently-active strategy alerts (band breach, drift, market-cap outgrowth, stop-loss).

GET/api/funds/{slug}/transactions

Transaction log (buys, sells, rebalances, dividends). Newest first; ?limit= up to 500.

GET/api/funds/{slug}/reviews

AI Review run summaries; /reviews/{id} for full per-constituent verdicts.

GET/api/funds/{slug}/discoveries

AI Discovery runs (new-name candidates); /discoveries/{id} for full detail.

GET/api/funds/{slug}/rebalance

Current rebalance recommendation toward target weights.

GET/api/funds/{slug}/research

Per-constituent deep research reports.

Trading

Orders flow through batches: propose a batch, review it, then approve to execute against the broker. Approving places real orders — these endpoints require owner/admin.

GET/api/funds/{slug}/order-batches

List order batches and their status.

POST/api/funds/{slug}/order-batchesOWNER/ADMIN

Create a proposed batch of orders (nothing is sent to the broker yet).

GET/api/funds/{slug}/order-batches/{id}

One batch with its orders and current fills.

POST/api/funds/{slug}/order-batches/{id}/approveOWNER/ADMIN

Approve and execute the batch — places live trades.

POST/api/funds/{slug}/order-batches/{id}/refreshOWNER/ADMIN

Re-poll the broker and record fills for an executing batch.

POST/api/funds/{slug}/order-batches/{id}/discardOWNER/ADMIN

Discard a proposed/approved batch.

GET/api/orgs/{org_id}/account

Brokerage account status (buying power, cash, equity).

API keys

GET/api/keys

List your own keys (masked — secrets are never returned).

POST/api/keysOWNER/ADMIN

Create a key; the plaintext secret is returned once.

DELETE/api/keys/{id}

Revoke one of your keys.

Full schema

For every endpoint's exact request/response shape and to try calls interactively, see the always-current OpenAPI / Swagger UI (openapi.json).