The HedgeFundAPI

curl -X POST \
  $API_BASE/v1/workflows \
  -H "Authorization: Bearer hfk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"activist_desk","description":"Activist investor focused on operational turnarounds, inflection points, and non-consensus views.","image_ref":"https://example.com/photo.jpg"}'

{
  "id": "wf_a1b2c3d4e5f6",
  "owner_id": "usr_variant_9f2",
  "name": "activist_desk",
  "description": "Activist investor focused on operational turnarounds, inflection points, and non-consensus views.",
  "is_default": false,
  "image_ref_url": "https://example.com/photo.jpg",
  "avatar_url": "https://blob.../bot-avatars/…-abc.png",
  "cartoon_avatar_url": "https://blob.../bot-avatars/…-cartoon-abc.png",
  "created_at": "2026-07-20T20:40:00Z",
  "updated_at": "2026-07-20T20:40:00Z"
}

curl -X GET \
  $API_BASE/v1/workflows?owner_id=%E2%80%A6&limit=50 \
  -H "Authorization: Bearer hfk_live_YOUR_KEY"

{
  "count": 1,
  "workflows": [
    {
      "id": "wf_a1b2c3d4e5f6",
      "owner_id": "usr_variant_9f2",
      "name": "activist_desk",
      "description": "Activist investor focused on operational turnarounds, inflection points, and non-consensus views.",
      "is_default": false,
      "created_at": "2026-07-20T20:40:00Z",
      "updated_at": "2026-07-20T20:40:00Z"
    }
  ]
}

curl -X POST \
  $API_BASE/v1/workflow/ask \
  -H "Authorization: Bearer hfk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"HOG","question":"Why is it underperforming and how would you fix it?","bot_id":"wf_…  (optional)","mode":"chat"}'

{
  "ticker": "HOG",
  "question": "Why is it underperforming and how would you fix it?",
  "headline": "HOG's margins are structurally impaired — the fix is a ruthless cost reset, not a demand story.",
  "answer": "HOG is underperforming due to a structural margin collapse driven by $45M in Q1 tariffs, a 54% HDFS revenue drop from the capital-light pivot, and $49M in elevated opex. The fix is executing the \"back to the bricks\" operational reset — leveraging the 38% U.S. market share and 21% NA retail growth to drive volume while forcing the new COO to cut costs. The inflection point is the transition from a balance-sheet-heavy financial model to a pure-play motorcycle operator.",
  "query_type": [
    "general_company_analysis"
  ],
  "sources": [
    {
      "source_type": "Earnings transcript",
      "form_type": "Earnings Call",
      "ticker": "HOG",
      "filing_date": "2026-05-05",
      "source_url": "https://www.sec.gov/..."
    },
    {
      "source_type": "SEC filing",
      "form_type": "10-Q",
      "ticker": "HOG",
      "filing_date": "2026-05-06",
      "source_url": "https://www.sec.gov/..."
    }
  ],
  "model_name": "qwen3.6-35b",
  "status": "ready",
  "created_at": "2026-07-20T20:14:03Z"
}

curl -X GET \
  $API_BASE/v1/recent-events/EVGN?limit=15 \
  -H "Authorization: Bearer hfk_live_YOUR_KEY"

{
  "ticker": "EVGN",
  "count": 2,
  "events": [
    {
      "ticker": "EVGN",
      "filing_type": "SC 13D",
      "filing_date": "2026-07-10",
      "category": "Activist Stake",
      "special_situation": true,
      "catalyst_strength": "hard",
      "one_sentence": "Evogene discloses an ongoing activist campaign demanding board replacement.",
      "why_it_matters": "An activist demanding removal of all directors except the CEO signals a governance battle and potential strategic overhaul.",
      "governance_impact": "Board composition under direct threat; proxy contest likely.",
      "ownership_impact": "Activist has built a reportable 5%+ position.",
      "source_url": "https://www.sec.gov/..."
    },
    {
      "ticker": "EVGN",
      "filing_type": "6-K",
      "filing_date": "2026-07-17",
      "category": "Capital Raise",
      "special_situation": false,
      "catalyst_strength": "soft",
      "one_sentence": "ATM offering ceiling increased amid the proxy contest.",
      "source_url": "https://www.sec.gov/..."
    }
  ]
}

curl -X POST \
  $API_BASE/v1/ask \
  -H "Authorization: Bearer hfk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"AAPL","question":"What is the activist case for this company?"}'

{
  "ticker": "AAPL",
  "question": "What is the activist case?",
  "answer": "Apple has not faced any named activist investors as of the most recent earnings call. However, several aspects of the business present a potential activist case...",
  "query_type": [
    "activist_angle"
  ],
  "sources": [
    {
      "source_type": "Earnings transcript",
      "form_type": "Earnings Call",
      "ticker": "AAPL",
      "filing_date": "2026-04-30",
      "section_name": "Q2 FY2026",
      "source_url": "https://www.sec.gov/..."
    },
    {
      "source_type": "SEC filing",
      "form_type": "8-K",
      "ticker": "AAPL",
      "filing_date": "2026-05-08",
      "source_url": "https://www.sec.gov/..."
    }
  ],
  "model_name": "Qwen/Qwen2.5-7B-Instruct",
  "created_at": "2026-05-12T14:23:01Z"
}

curl -X POST \
  $API_BASE/v1/search \
  -H "Authorization: Bearer hfk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"AAPL","query":"operating margin pressure cloud","limit":8}'

[
  {
    "ticker": "AAPL",
    "section_name": "Item 7. MD&A",
    "chunk_text": "Gross margin in the fourth quarter of fiscal 2025 was 45.2%, compared to 45.9% in the prior year...",
    "source_url": "https://www.sec.gov/Archives/edgar/data/320193/...",
    "similarity": 0.91
  }
]

curl -X GET \
  $API_BASE/v1/feed?limit=50&offset=0&filter=all \
  -H "Authorization: Bearer hfk_live_YOUR_KEY"

[
  {
    "id": "8f3...c2",
    "ticker": "NKE",
    "filing_date": "2026-03-31",
    "tags": [
      "capital_allocation",
      "buyback"
    ],
    "hard_catalyst": true,
    "catalyst_confidence": 0.94,
    "event_summary": "Nike announced a $20B share repurchase program effective immediately.",
    "source_url": "https://www.sec.gov/..."
  }
]