research / wire operation
Score a universe
totalfinance.research.score
Score a point-in-time universe as a weighted composite of standardized components (z-score or percentile rank, higher- or lower-is-better) with an explicit missing-value policy. The result is scoreUniverse(...) verbatim.
| Pack / profiles | research / full, research |
|---|---|
| Default discovery | Opt-in |
| Required capabilities | None |
| Effects / authorization | none / none |
| Cost / cancellation | medium / Do not assume inline interruption |
| Handle-eligible inputs | None |
| Idempotency | not-applicable |
Input schema
{
"type": "object",
"properties": {
"universeId": {
"type": "string",
"minLength": 1
},
"asOf": {
"type": "number",
"description": "Epoch ms; the latest observation at or before it is used per instrument"
},
"observations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"instrumentId": {
"type": "string",
"minLength": 1
},
"availableTimestampMs": {
"type": "number"
},
"fields": {
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"description": "Declared fields only; null is a stated missing value"
}
},
"additionalProperties": false,
"required": [
"instrumentId",
"availableTimestampMs",
"fields"
]
}
},
"fieldDefinitions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fieldName": {
"type": "string",
"minLength": 1
},
"kind": {
"type": "string",
"enum": [
"numeric",
"category",
"text",
"boolean"
]
},
"unit": {
"type": "string"
},
"description": {
"type": "string"
}
},
"additionalProperties": false,
"required": [
"fieldName",
"kind"
]
},
"minItems": 1
},
"components": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"weight": {
"type": "number",
"exclusiveMinimum": 0
},
"direction": {
"type": "string",
"enum": [
"higher-is-better",
"lower-is-better"
]
},
"standardization": {
"type": "string",
"enum": [
"z-score",
"percentile-rank"
]
}
},
"additionalProperties": false,
"required": [
"field",
"weight",
"direction",
"standardization"
]
},
"minItems": 1
},
"missingValuePolicy": {
"type": "string",
"enum": [
"exclude",
"renormalize-weights"
]
}
},
"additionalProperties": false,
"required": [
"universeId",
"asOf",
"observations",
"fieldDefinitions",
"components",
"missingValuePolicy"
]
}Output schema
{
"type": "object",
"properties": {
"assumptions": {
"type": "object",
"description": "Applied conventions"
},
"diagnostics": {
"type": "object",
"description": "Engine, method, warnings"
},
"rows": {
"type": "array",
"items": {
"type": "object"
},
"description": "{ instrumentId, score, componentsUsed }"
}
},
"required": [
"assumptions",
"diagnostics",
"rows"
]
}