Dantes Exchange

WHEN: Use when the user named a setup in trader language and you need to know which Dantes skill matches. NOT for: Do not use to run a scan or to invent a skill we do not list. Returns: Matching capability ids, each with its price, what it takes to run it, and its own when / not_for / returns — plus `not_encoded`, the setups this endpoint does not have.

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

WHEN: Use when you concluded, after search_capabilities and get_capability, that Dantes cannot do part of what your user asked — name the missing data column, indicator, history or composition in buildable terms, and what Dantes CAN do of the ask. NOT for: Do not use for a capability that exists and refused your input shape (read its schema and retry), and do not tell your user the gap will be built or when — it is recorded for the operators, never promised. Returns: { ok, recorded } — the missing pieces as written to the operators’ gaps board, free, or { ok: false } with the reason.

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "minLength": 8,
      "maxLength": 400
    },
    "missing": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 3,
        "maxLength": 200
      },
      "minItems": 1,
      "maxItems": 6
    },
    "could_do": {
      "type": "string",
      "maxLength": 400
    },
    "capabilities_tried": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "maxItems": 10
    }
  },
  "required": [
    "question",
    "missing"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

WHEN: Use when you already have a capability id and need schema, price, and when-to-use before paying. NOT for: Do not use to execute the scan. Returns: The full manifest — input and output schema, support envelope, limitations — plus the price and access class on THIS endpoint, and the routing block.

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

WHEN: Use when you need the dated forward-return pack for a listed skill (n, window, as-of). NOT for: Do not use as a live scan and do not treat evidence as today’s hits. Returns: Semantic evidence (does it do what it says) kept strictly separate from historical economic evidence (what was measured about the population it describes) — never combined into a score. Universe-relative and vs-benchmark figures appear only where they were actually measured; a capability with no economic measurement returns NOT_MEASURED rather than a borrowed figure.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Capability id"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

WHEN: Use when you need what universes / as-of books a skill can run on. NOT for: Do not use to fetch prices or news. Returns: The published datasets with their as-of dates and the universes they enumerate; with a `universe` argument, the member ticker list itself. Raw dataset files are never returned.

{
  "type": "object",
  "properties": {
    "universe": {
      "type": "string",
      "enum": [
        "LIQUID_VOLATILE",
        "SECULAR_TREND"
      ],
      "description": "Enumerate the members of one universe. Omit to list datasets and see which universes are available."
    },
    "dataset": {
      "type": "string",
      "description": "Dataset name, when the endpoint publishes more than one."
    },
    "format": {
      "type": "string",
      "enum": [
        "full",
        "symbols"
      ],
      "description": "\"full\" (default) returns member records with metadata, paged. \"symbols\" returns the complete ticker list in one cheap response."
    },
    "limit": {
      "type": "number",
      "description": "Members per page for format \"full\" (default 250, max 1000)."
    },
    "offset": {
      "type": "number",
      "description": "Page offset for format \"full\"."
    },
    "theme": {
      "type": "string",
      "description": "SECULAR_TREND only — restrict to one secular theme id."
    },
    "eligible_only": {
      "type": "boolean",
      "description": "SECULAR_TREND only — restrict to members that also pass the LIQUID_VOLATILE mechanical gates."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

WHEN: Use when you have chosen a listed skill, the user wants names that match it now, and you are ready to pay. NOT for: Do not use for quotes, news, or a chart pattern nowhere on this endpoint (head-and-shoulders — say we don’t have that). Do not refuse a NAMED indicator before get_capability ta-primitives has been read, and do not rebuild a held recipe from memory: the composing rules in the routing guide apply to every call here. Returns: { ok, result } or { ok: false, error }. A priced capability answers an unpaid call with an x402 PaymentRequired naming the exact amount, asset, network and recipient; nothing executes and nothing is charged until a payment verifies. A scan that ran and returned zero names is a completed billable run, not an error.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Capability id"
    },
    "input": {
      "type": "object",
      "additionalProperties": {},
      "description": "Input conforming to the capability's input_schema"
    }
  },
  "required": [
    "id",
    "input"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}