Comparison
Allocation Only vs Allocation with Report
Both endpoints run the same allocation engine. The difference is what comes with the result. Allocation only returns the target weights. Allocation with Report also produces a certified PDF record of the decision.
Allocation
Async · POST /agent/x402/allocate
Runs the full allocation engine — regime, policy, asset scoring — and returns a structured allocation result you can act on immediately.
- Target weights per asset
- Decision ID for tracking
- Policy constraints applied
- Asynchronous — poll statusPath
Allocation with Report
Async · POST /agent/x402/allocate-with-report
Everything in the standard allocation, plus a certified PDF decision record capturing the full analysis context at the moment of the decision.
- Target weights per asset
- Decision ID for tracking
- Policy constraints applied
- Market regime snapshot at decision time
- Asset quality scores with rationale
- Decision narrative and timestamp
- Downloadable certified PDF
What the $15 difference buys
The premium covers the generation and delivery of a certified PDF decision record. The document captures the state of the analysis at the moment the allocation was made — not just the output, but the context that produced it.
That means: the regime Selun observed, the policy envelope it computed, the asset scores it assigned, and the rationale for the final weights — all timestamped and tied to the decision ID. It is a record you can share, store, and reference later.
When to choose Allocation only
Use standard Allocation when you need a target portfolio and do not need to document or share the decision. This is appropriate for personal, one-time allocation decisions, automated agent workflows where the result feeds directly into the next step without a governance checkpoint, and test or development runs where you are exploring output behavior.
$19 USDC per call
When to choose Allocation with Report
Choose the report when the allocation will be reviewed by stakeholders who were not present when it was made, used in a DAO governance vote or proposal, stored as part of an audit trail for treasury management, or presented to co-signers who need to understand and approve the decision before execution.
$34 USDC per call
The same engine, twice
It is worth being explicit: both endpoints call the same underlying allocation engine. The resulting weights will be identical for the same inputs at the same time. The report endpoint does not produce a different or better allocation — it produces the same allocation plus a documented record of it. The choice is about documentation, not about quality.