Sorqen

List supported league ids, market types and periods. No API key required. Use before a fair-value query when you do not already know the allowed ids; do not use it for live prices.

{
  "type": "object",
  "properties": {}
}

Describe the versioned fair-value method and refusal philosophy. No API key required. Use it to interpret Sorqen numbers; use list_fair_values for current data.

{
  "type": "object",
  "properties": {}
}

Describe public plan limits and entitlements. No API key required. Free is authenticated real access, not anonymous data access.

{
  "type": "object",
  "properties": {}
}

Explain the discovery/data boundary and how to attach a Sorqen API key. No API key required.

{
  "type": "object",
  "properties": {}
}

Return current no-vig sportsbook-consensus probabilities for supported upcoming markets. Requires a Sorqen key. Free keys receive real values within Free limits; evidence is available on paid plans. Use for scanning/filtering; use get_fair_value for one known outcome.

{
  "type": "object",
  "properties": {
    "league": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "nfl",
          "nba",
          "mlb",
          "nhl"
        ]
      }
    },
    "market_type": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "moneyline",
          "spread",
          "total"
        ]
      }
    },
    "min_confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5000
    },
    "cursor": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return one current fair value by canonical outcome id. Requires a Sorqen key. Use when the outcome id is already known; use list_fair_values for discovery.

{
  "type": "object",
  "properties": {
    "outcome_id": {
      "type": "string"
    }
  },
  "required": [
    "outcome_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return fair-value history for one outcome, bounded by the caller plan. Requires a Sorqen key. Free has no history; Builder and above unlock history windows.

{
  "type": "object",
  "properties": {
    "outcome_id": {
      "type": "string"
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 3650
    }
  },
  "required": [
    "outcome_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Grade a pregame price or probability against Sorqen's fair value at that timestamp, Sorqen Close when available, and the settled result when available. Requires a Sorqen key. Sorqen uses only information that existed at or before observed_at, so the answer carries no look-ahead. Before kickoff the close and result come back as pending and their metrics are null, never zero. `venue` is a label for your own records; Sorqen never fetches it.

{
  "type": "object",
  "properties": {
    "outcome_id": {
      "type": "string"
    },
    "observed_at": {
      "type": "string",
      "description": "ISO 8601 timestamp of when you saw the price. Must be before the scheduled start."
    },
    "price": {
      "type": "object",
      "properties": {
        "format": {
          "type": "string",
          "enum": [
            "american",
            "decimal",
            "probability"
          ]
        },
        "value": {
          "type": "number"
        }
      },
      "required": [
        "format",
        "value"
      ],
      "description": "The format is declared, never inferred: 1.91 is decimal odds to one caller and nonsense to another."
    },
    "venue": {
      "description": "Optional label for where your price came from. Metadata only.",
      "type": "string"
    }
  },
  "required": [
    "outcome_id",
    "observed_at",
    "price"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return Sorqen settlement-context rules and tie prior used by the local client comparison path. Requires a Sorqen key. This is context, not a venue market feed.

{
  "type": "object",
  "properties": {}
}

Return the caller plan, limits and entitlements. Requires a Sorqen key. Use when a field is locked or a limit is reached.

{
  "type": "object",
  "properties": {}
}