Compliance
Review queue optimizer
Optimize a compliance review queue using current OFAC exact matches, future exposure forecast probabilities, exposure value, relationship tier, recency, and optional current queue position metadata.
Browser note: GET on this URL serves human-readable docs. Paid execution still requires POST with x402 settlement.
Pins current OFAC matches first, then returns an optimized queue, baseline comparison, lift metrics, and reviewer-facing rationale.
Example request body
Use this payload shape for the paid POST call.
{
"review_items": [
{
"address": "0x098B716B8Aaf21512996dC57EB0615e2383E2f96",
"exposure_usd": 5000,
"relationship_tier": "standard",
"current_queue_position": 2
},
{
"address": "0x2222222222222222222222222222222222222222",
"exposure_usd": 250000,
"relationship_tier": "critical",
"current_queue_position": 1,
"last_activity_days": 5,
"transaction_count_30d": 20,
"policy_priority": 8
}
],
"review_budget": 1,
"objective": "minimize_residual_risk",
"horizon_days": 60,
"iterations": 8000,
"priors": {
"list_add_rate_override_per_day": 0.25
}
}Request schema
The canonical body contract as exposed through discovery and OpenAPI.
{
"type": "object",
"properties": {
"review_items": {
"type": "array",
"description": "Wallet review items with per-address metadata required for queue optimization.",
"items": {
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "Wallet address to screen and rank."
},
"exposure_usd": {
"type": "number",
"description": "Dollar exposure associated with this wallet."
},
"relationship_tier": {
"type": "string",
"description": "Relationship risk tier for this wallet.",
"enum": [
"low",
"standard",
"high",
"critical"
]
},
"current_queue_position": {
"type": "integer",
"description": "Optional current queue rank, where 1 is first."
},
"last_activity_days": {
"type": "number",
"description": "Days since the wallet was last active."
},
"transaction_count_30d": {
"type": "number",
"description": "Transaction count over the trailing 30 days."
},
"policy_priority": {
"type": "number",
"description": "Optional internal policy priority from 0 to 10."
},
"label": {
"type": "string",
"description": "Optional display label for the review item."
}
},
"required": [
"address",
"exposure_usd",
"relationship_tier"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 500
},
"review_budget": {
"type": "integer",
"description": "Number of items a reviewer can handle in the next review window."
},
"objective": {
"type": "string",
"description": "Optimization objective.",
"enum": [
"minimize_residual_risk",
"maximize_expected_recall",
"maximize_caught_hits"
]
},
"asset": {
"type": "string",
"description": "Optional asset or network ticker filter, such as ETH, USDC, XBT, TRX, ARB, or BSC."
},
"horizon_days": {
"type": "integer",
"description": "Forecast horizon in days. Values are bounded to 7 through 365."
},
"iterations": {
"type": "integer",
"description": "Forecast trial count. Values are bounded to 1000 through 100000."
},
"tier_weights": {
"type": "object",
"description": "Optional overrides for low, standard, high, and critical relationship tier weights.",
"additionalProperties": {
"type": "number"
}
},
"priors": {
"type": "object",
"description": "Explicit prior assumptions used only when the caller wants to override the OFAC history cadence.",
"properties": {
"list_add_rate_override_per_day": {
"type": "number",
"description": "Caller-supplied expected OFAC digital-currency address additions per day."
}
},
"additionalProperties": false
},
"title": {
"type": "string",
"description": "Optional report title."
},
"summary_focus": {
"type": "string",
"description": "Optional summary focus for the report."
}
},
"required": [
"review_items",
"review_budget"
],
"additionalProperties": false
}Example response
A representative output payload for the route.
{
"success": true,
"data": {
"summary": {
"expected_caught_hits_under_optimized_order": 1,
"expected_caught_hits_under_naive_order": 0.35,
"lift_percent": 185.71,
"metadata_coverage_percent": 100
}
},
"report": {
"report_meta": {
"report_type": "compliance-review-queue-optimizer"
},
"headline_metrics": [],
"tables": {
"review_queue": {
"columns": [
"rank",
"address",
"screening_status",
"rationale"
],
"rows": []
}
}
},
"source": "OFAC SDN Advanced XML"
}cURL
Use this as the starting point for HTTP execution after the initial 402 challenge.
curl -X POST "https://api.aurelianflo.com/api/workflows/compliance/queue-optimize" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
# include x402 settlement headers after the initial 402 challenge \
-d '{
"review_items": [
{
"address": "0x098B716B8Aaf21512996dC57EB0615e2383E2f96",
"exposure_usd": 5000,
"relationship_tier": "standard",
"current_queue_position": 2
},
{
"address": "0x2222222222222222222222222222222222222222",
"exposure_usd": 250000,
"relationship_tier": "critical",
"current_queue_position": 1,
"last_activity_days": 5,
"transaction_count_30d": 20,
"policy_priority": 8
}
],
"review_budget": 1,
"objective": "minimize_residual_risk",
"horizon_days": 60,
"iterations": 8000,
"priors": {
"list_add_rate_override_per_day": 0.25
}
}'Related routes
Use these when you want the lower-level primitive, the buyer-facing memo workflow, or the agent install surface around this endpoint.