Heisenbergdocs

Authentication

All API requests require a Bearer token in the Authorization header.

Get an API Token

  1. 1Sign up at prediction.heisenberg.so and create an account.
  2. 2Navigate to Dashboard → API Keys and generate a new key.
  3. 3Copy the token — it will only be shown once.

Using the Token

Include your token in the Authorization header as a Bearer token:

HTTP Header
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

Full Example

cURL
curl -X POST \
  https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{"agent_id": 574, "params": {"min_volume": "1000"}}'

Security

Never expose your API token in client-side code or public repositories. Use environment variables and server-side requests to keep your token secure.