Skip to main content

​
1. Get an API key

Open app.askalchemist.com/settings/api-keys, click Create key, give it a name, and copy the raw key. It starts with alch_ and is shown only once — save it now.
The raw key is never stored. If you lose it, revoke it and create a new one.
curl -X POST https://api.askalchemist.com/api/insights/search \
  -H "X-API-Key: alch_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Fed dot plot rate path 2026"}'

​
Example response

{
  "insights": [
    {
      "insight_id": "ins_01jwx...",
      "title": "Fed median dot unchanged at 3.875% for end-2026",
      "insight": "The March 2026 Summary of Economic Projections showed the median federal funds rate projection for year-end 2026 held at 3.875%, unchanged from the December 2025 SEP.",
      "excerpts": [
        "The median projection for the federal funds rate at the end of 2026 remained at 3.875 percent."
      ],
      "doc_id": "doc_01jww...",
      "doc_title": "FOMC Summary of Economic Projections — March 2026",
      "source_url": "https://federalreserve.gov/monetarypolicy/files/fomcprojtabl20260320.pdf",
      "source_name": "Federal Reserve",
      "published_date": "2026-03-20",
      "score": 0.92
    }
  ]
}

​
3. Add source filters (optional)

Use GET /api/documents/filters to see available sources, then narrow your search: 
curl -X POST https://api.askalchemist.com/api/insights/search \
  -H "X-API-Key: alch_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "corn ending stocks revision",
    "source_name": "USDA",
    "since": "2026-01-01",
    "limit": 10
  }'

​
Next steps

Add to your agent

Connect via MCP for zero-boilerplate tool calling in Claude, Cursor, Cline, and more.

API reference

Full endpoint docs — request shapes, response schemas, and error codes.