api.marketintelligenceapi.com

{
  "properties": {
    "algoVersion": {
      "type": "string"
    },
    "asOf": {
      "format": "date-time",
      "type": "string"
    },
    "disclaimer": {
      "type": "string"
    },
    "filteredOut": {
      "additionalProperties": {
        "type": "integer"
      },
      "description": "Why symbols were excluded, with counts",
      "type": "object"
    },
    "marketContext": {
      "description": "regime, usMarketSession, stablecoinNetIssuance24hUsd, macroEventsNext2h",
      "type": "object"
    },
    "matches": {
      "type": "integer"
    },
    "method": {
      "type": "string"
    },
    "noMatchReason": {
      "type": "string"
    },
    "notCovered": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "objective": {
      "type": "string"
    },
    "objectiveDefinition": {
      "type": "string"
    },
    "request": {
      "description": "The request with defaults applied",
      "type": "object"
    },
    "results": {
      "items": {
        "properties": {
          "assetClass": {
            "enum": [
              "crypto",
              "us_equity",
              "perp_only"
            ],
            "type": "string"
          },
          "calibratedHitRatePercent": {
            "description": "Live hit rate behind this result (the signal 1h record in the result direction, or crowding events 4h for crowded_positioning); null below 30 evaluated samples",
            "type": [
              "number",
              "null"
            ]
          },
          "confirmingSources": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "conflictingEvidence": {
            "items": {
              "properties": {
                "detail": {
                  "type": "string"
                },
                "direction": {
                  "enum": [
                    "BULLISH",
                    "BEARISH",
                    "NEUTRAL",
                    "ACTIVITY"
                  ],
                  "type": "string"
                },
                "observedValue": {},
                "source": {
                  "enum": [
                    "spot_dex_flow",
                    "perp_positioning",
                    "smart_money"
                  ],
                  "type": "string"
                },
                "type": {
                  "description": "buy_pressure, momentum, volume_anomaly, market_event, large_trades, long_short_open_interest, top_wallet_net_flow",
                  "type": "string"
                },
                "unit": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "dataQuality": {
            "description": "sourcesAvailable, sourcesMissing, signalAgeSeconds, confidenceScore, tradeCount, baselineReady, organicSharePercent, freshPools, oracleDeviationBps",
            "type": "object"
          },
          "direction": {
            "enum": [
              "BULLISH",
              "BEARISH"
            ],
            "type": "string"
          },
          "eventType": {
            "type": "string"
          },
          "independentSourcesConfirming": {
            "type": "integer"
          },
          "metrics": {
            "description": "buyPressure, momentumScore, priceChangePercent, volumeUsd, volumeMultiple, anomalyScore, activityScore, tradeCount, largeTradeCount, confidenceScore, asOf",
            "type": "object"
          },
          "nextCalls": {
            "description": "Follow-up routes: preTradeCheck, positioning, smartMoney, trackRecord",
            "type": "object"
          },
          "positioningTrackRecord4h": {
            "description": "crowded_positioning only: 4h record of crowding events on this side",
            "type": "object"
          },
          "price": {
            "type": "number"
          },
          "rank": {
            "type": "integer"
          },
          "riskFactors": {
            "items": {
              "properties": {
                "detail": {
                  "type": "string"
                },
                "severity": {
                  "enum": [
                    "LOW",
                    "MEDIUM",
                    "HIGH"
                  ],
                  "type": "string"
                },
                "type": {
                  "description": "thin_liquidity, low_confidence, bot_dominated_flow, baseline_not_ready, crowded_positioning, price_dislocation, us_market_closed, corporate_action, macro_event, conflicting_evidence, weak_signal_track_record",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "score": {
            "description": "40 for meeting the objective + up to 20 for strength + 15 per extra confirming source +/- up to 15 for calibration (live hit rate minus 50 on >= 30 samples), - 10 per conflicting item, - 5 per HIGH risk",
            "maximum": 100,
            "minimum": 0,
            "type": "integer"
          },
          "signal": {
            "type": "string"
          },
          "signalTrackRecord1h": {
            "description": "Live 1h hit rate of this signal label over 30 days (all symbols); hitRatePercent is null below 30 evaluated signals; appliesToThisDirection says whether the signal points the same way as the result (only then it counts in the score)",
            "type": "object"
          },
          "supportingEvidence": {
            "items": {
              "properties": {
                "detail": {
                  "type": "string"
                },
                "direction": {
                  "enum": [
                    "BULLISH",
                    "BEARISH",
                    "NEUTRAL",
                    "ACTIVITY"
                  ],
                  "type": "string"
                },
                "observedValue": {},
                "source": {
                  "enum": [
                    "spot_dex_flow",
                    "perp_positioning",
                    "smart_money"
                  ],
                  "type": "string"
                },
                "type": {
                  "description": "buy_pressure, momentum, volume_anomaly, market_event, large_trades, long_short_open_interest, top_wallet_net_flow",
                  "type": "string"
                },
                "unit": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "symbol": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "symbolsScanned": {
      "type": "integer"
    },
    "window": {
      "type": "string"
    }
  },
  "type": "object"
}