Endpoint Capabilities
Selun Capabilities
Selun exposes nine capabilities as payment-gated endpoints. Two are asynchronous allocation engines. Seven are synchronous tool endpoints that return immediately. The three SCE endpoints are preflight safety checks powered by the Sagitta Continuity Engine. Each can be called independently via x402 or through the guided allocation wizard.
$19.00 USDC · Async
Allocation
Endpoint
/agent/x402/allocateWhat it doesGenerates a target portfolio allocation based on your risk tolerance, investment timeframe, and current market conditions. The engine runs market regime classification, policy scoping, and asset scoring internally before producing the final weights.
When to use itUse this when you need a fresh target allocation and do not need a documented record of the decision. It is the primary allocation endpoint for automated workflows.
OutputA structured allocation with target weights per asset, within policy constraints. Returned asynchronously — poll the status path for the result.
Best forCrypto investors, treasury operators, agent-based workflows needing target weights.
$34.00 USDC · Async
Allocation with Report
Endpoint
/agent/x402/allocate-with-reportWhat it doesSame as Allocation, but also produces a certified decision report — a structured PDF record capturing the regime snapshot, policy constraints, asset scores, and decision rationale at the time of the call.
When to use itUse this when the allocation will be presented to stakeholders, used in a governance vote, stored for audit purposes, or when the decision-maker needs a verifiable, time-stamped record.
OutputAllocation result plus a signed, downloadable decision report. Returned asynchronously.
Best forDAOs, treasury committees, institutional operators, any context requiring documented allocation decisions.
$0.25 USDC · Sync
Market Regime
Endpoint
/agent/x402/market-regimeWhat it doesClassifies the current crypto market environment across volatility, liquidity, and sentiment dimensions. Returns regime-level signals that inform downstream allocation and rebalancing decisions.
When to use itUse this before an allocation or rebalancing call when you want explicit regime context, or as a standalone signal for your own decision logic. Also useful for monitoring: call it on a schedule to track how market conditions are shifting.
OutputRegime classification with volatility level, liquidity score, sentiment signal, and authorization inputs for allocation.
Best forQuant workflows, monitoring systems, any agent that needs market-state awareness before making a portfolio decision.
$0.25 USDC · Sync
Policy Envelope
Endpoint
/agent/x402/policy-envelopeWhat it doesComputes the risk policy envelope for a given risk tolerance and timeframe. Returns the maximum exposure caps by asset class, the minimum stablecoin floor, and the risk budget — the hard constraints any compliant allocation must satisfy.
When to use itUse this when you want to know what an allocation for a given risk profile is allowed to look like before running a full allocation. Also useful for governance workflows that need to confirm policy parameters independently.
OutputExposure caps per asset class, stablecoin floor percentage, risk budget, and constraint summary.
Best forDevelopers building allocation logic, DAOs that want to validate policy constraints, risk-aware treasury operators.
$0.50 USDC · Sync
Asset Scorecard
Endpoint
/agent/x402/asset-scorecardWhat it doesEvaluates a list of candidate assets across liquidity, structural stability, role classification (store of value, yield, speculative), and a composite quality score. Lower-quality assets receive lower scores and are less likely to receive meaningful allocation weights.
When to use itUse this before an allocation to understand asset quality, or as a standalone screening tool when selecting which assets to include in a portfolio strategy.
OutputPer-asset scores for liquidity, structural stability, role classification, and a composite quality score.
Best forInvestors building a custom asset list, developers selecting inputs for allocation, anyone who needs objective scoring before committing to an asset set.
$1.00 USDC · Sync
Rebalance
Endpoint
/agent/x402/rebalanceWhat it doesTakes your current holdings and a risk profile, then computes the drift between your current portfolio and the optimal target allocation. Returns the adjustments — buy, sell, or hold — needed to bring the portfolio back within policy.
When to use itUse this on a monitoring schedule (daily, weekly) after an initial allocation to detect drift and produce actionable rebalancing instructions. Also use it after market conditions shift significantly.
OutputDrift analysis per asset and a set of rebalancing trade instructions ordered by priority.
Best forInvestors with existing holdings who want to maintain policy alignment, automated rebalancing bots, treasury operators running regular portfolio reviews.
$0.01 USDC · Sync
SCE Continuity Mode
Endpoint
/agent/x402/sce/continuity-modeWhat it doesQueries the Sagitta Continuity Engine for the current on-chain threat posture. Returns mode (NORMAL / INCIDENT / DEGRADED), recommended_posture, reason_codes, and per-domain risk_domains across authority, governance, oracle, bridge, dependency, and more.
When to use itUse this as the default pre-execution check before any protocol interaction, routing decision, rebalance, or capital movement. If mode is not NORMAL, escalate to SCE Risk Evaluate before proceeding.
Outputmode, recommended_posture, reason_codes, risk_domains, confidence, and recommended_next — including which Selun endpoint to call next and its estimated price.
Best forAny autonomous agent that moves capital on-chain. Designed to be called on every execution cycle as a lightweight safety gate.
$0.25 USDC · Sync
SCE Risk Evaluate
Endpoint
/agent/x402/sce/risk-evaluateWhat it doesScores and classifies protocol risk for a specific protocol or address set. Returns doctrine_action (BLOCK / ALLOW / ESCALATE), risk_level, risk_score, risk_domains, and reason_codes from the Sagitta Continuity Engine's composite evaluation.
When to use itUse this when SCE Continuity Mode returns mode !== NORMAL or recommended_posture is require_review or pause. If doctrine_action is BLOCK, halt the action and surface reason_codes and recommended_next to the user. Recheck after valid_until.
Outputdoctrine_action, risk_level, risk_score, risk_domains, reason_codes, continuity_mode summary, and recommended_next.
Best forAgents executing protocol interactions, swaps, deposits, or capital movements that require a doctrine-gated go/no-go decision.
$0.05 USDC · Sync
SCE Case Relevance
Endpoint
/agent/x402/sce/case-relevanceWhat it doesClassifies whether a specific protocol, asset type, or threat family is relevant to the active SCE intelligence context. Returns relevance_score, relevance_level, matched_threat_families, matched_doctrine_tags, and reason_codes.
When to use itUse this only when you already have threat context to evaluate — specific threat families, doctrine tags, asset categories, or a protocol name. Not a default preflight check; best used when screening case-library candidates or filtering execution paths with known risk context.
Outputrelevance_score, relevance_level (NONE / LOW / MEDIUM / HIGH), matched_threat_families, matched_doctrine_tags, and reason_codes.
Best forAgents with prior threat context that need to determine whether a specific protocol or asset class is implicated in active SCE cases.
Machine-facing catalog
This page explains each capability in human terms. If you are building an agent or need the full technical spec — input schemas, pricing, discovery root, and payment transport details — see the x402 endpoint catalog.