{"title":"Review queue optimizer","routeKey":"POST /api/workflows/compliance/queue-optimize","method":"POST","path":"/api/workflows/compliance/queue-optimize","description":"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.","proof":"Pins current OFAC matches first, then returns an optimized queue, baseline comparison, lift metrics, and reviewer-facing rationale.","discipline":"Compliance","category":"workflows/compliance","price":"$0.15 USDC","outputKind":"json","docsOnlyGet":true,"requestExample":{"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}},"requestSchema":{"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},"outputExample":{"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"},"relatedLinks":[{"label":"Exposure forecast","href":"/api/workflows/compliance/exposure-forecast","description":"Review the forecast model driving the queue score."},{"label":"Batch screening","href":"/api/workflows/compliance/batch-wallet-screen","description":"Run the lower-level OFAC exact-match screen across the queue."}],"curlExample":"curl -X POST \"https://api.aurelianflo.com/api/workflows/compliance/queue-optimize\" \\\n  -H \"Accept: application/json\" \\\n  -H \"Content-Type: application/json\" \\\n  # include x402 settlement headers after the initial 402 challenge \\\n  -d '{\n  \"review_items\": [\n    {\n      \"address\": \"0x098B716B8Aaf21512996dC57EB0615e2383E2f96\",\n      \"exposure_usd\": 5000,\n      \"relationship_tier\": \"standard\",\n      \"current_queue_position\": 2\n    },\n    {\n      \"address\": \"0x2222222222222222222222222222222222222222\",\n      \"exposure_usd\": 250000,\n      \"relationship_tier\": \"critical\",\n      \"current_queue_position\": 1,\n      \"last_activity_days\": 5,\n      \"transaction_count_30d\": 20,\n      \"policy_priority\": 8\n    }\n  ],\n  \"review_budget\": 1,\n  \"objective\": \"minimize_residual_risk\",\n  \"horizon_days\": 60,\n  \"iterations\": 8000,\n  \"priors\": {\n    \"list_add_rate_override_per_day\": 0.25\n  }\n}'","links":{"apiCatalog":"https://api.aurelianflo.com/api","openApi":"https://api.aurelianflo.com/openapi.json","mcpDocs":"https://api.aurelianflo.com/mcp/docs"}}