EL7 MCP · 1.1.0

81 product tools · 21 admin tools · Output contract 1.1

Generated from the registered SDK catalogue. Output examples are synthetic illustrations; they do not represent live market records.

Find a tool

el7_whoami

Shows how this connection is signed in to EL7 (service key, API key or EL7 sign-in), the EL7 MCP plan that applies, and how many tool calls remain. Calling it never uses up an allowance call.

account · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {},
  "additionalProperties": false
}

{}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "authKind": {
      "type": "string",
      "enum": [
        "internal",
        "api_key",
        "oauth"
      ]
    },
    "role": {
      "type": "string"
    },
    "isAdmin": {
      "type": "boolean"
    },
    "plan": {
      "type": "string",
      "enum": [
        "internal",
        "admin",
        "member",
        "developer",
        "analyst",
        "institutional",
        "free"
      ]
    },
    "allowance": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "period": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "lifetime",
            "month"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "used": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "remaining": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "clientId": {
      "type": [
        "string",
        "null"
      ]
    },
    "resetAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    },
    "allowanceKind": {
      "type": "string",
      "enum": [
        "unmetered",
        "lifetime",
        "monthly",
        "fair_use_ceiling"
      ]
    },
    "fairUseCeiling": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "burstPerMinute": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "enabledServices": {
      "maxItems": 16,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "account",
          "news",
          "calendar",
          "legacy",
          "central_banks",
          "cot",
          "energy",
          "gold",
          "research",
          "trading_activity",
          "predictions",
          "strategies",
          "markets",
          "stocks",
          "people",
          "ai"
        ]
      }
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "authKind",
    "role",
    "isAdmin",
    "plan",
    "allowance",
    "period",
    "used",
    "remaining",
    "clientId",
    "resetAt",
    "allowanceKind",
    "fairUseCeiling",
    "burstPerMinute",
    "enabledServices"
  ],
  "additionalProperties": false
}

{
  "authKind": "internal",
  "role": "example",
  "isAdmin": false,
  "plan": "internal",
  "allowance": 0,
  "period": "lifetime",
  "used": 0,
  "remaining": 0,
  "clientId": "example",
  "resetAt": "2026-10-09T00:00:00.000Z",
  "allowanceKind": "unmetered",
  "fairUseCeiling": 0,
  "burstPerMinute": 1,
  "enabledServices": []
}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_news_latest

Returns the latest published EL7 news story cards (headline, subtitle, category, sentiment, impact score, instruments, tags, timestamps, url) — no article bodies. Use this to answer 'what's happening in the news right now', or to filter by category/instrument/sentiment/impact/time window. Supports cursor pagination via next_cursor. Call el7_news_story for the full body of any card returned here.

news · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "category": {
      "description": "Filter to one news category.",
      "type": "string",
      "enum": [
        "central_banks",
        "forex",
        "commodities",
        "stocks",
        "crypto",
        "bonds",
        "macro",
        "geopolitics",
        "merger",
        "general"
      ]
    },
    "instruments": {
      "description": "Exact instrument symbols as stored in digest_stories.instruments (e.g. XAUUSD, AAPL).",
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 20
      }
    },
    "period": {
      "description": "Rolling lookback window; defaults to 24h when no from/to range is supplied. Cannot be combined with from/to.",
      "type": "string",
      "enum": [
        "1h",
        "6h",
        "24h",
        "7d",
        "30d"
      ]
    },
    "from": {
      "description": "Range start (ISO date). Must be paired with 'to'; max 90 days.",
      "type": "string",
      "maxLength": 40
    },
    "to": {
      "description": "Range end (ISO date). Must be paired with 'from'; max 90 days.",
      "type": "string",
      "maxLength": 40
    },
    "min_impact": {
      "description": "Minimum impact_score (1-10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "sentiment": {
      "type": "string",
      "enum": [
        "bullish",
        "bearish",
        "neutral",
        "mixed"
      ]
    },
    "sort": {
      "default": "latest",
      "description": "'latest' = freshest first, 'impact' = highest impact first.",
      "type": "string",
      "enum": [
        "latest",
        "impact"
      ]
    },
    "updated_since": {
      "description": "Only stories first published OR content-updated after this ISO timestamp.",
      "type": "string",
      "maxLength": 40
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "cursor": {
      "description": "Cursor tied to the caller, filters and 15-minute ordered snapshot membership. Expired or foreign cursors are rejected.",
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

{
  "period": "24h",
  "limit": 20
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "headline": {
            "type": [
              "string",
              "null"
            ]
          },
          "subtitle": {
            "type": [
              "string",
              "null"
            ]
          },
          "category": {
            "type": "string"
          },
          "sentiment": {
            "type": [
              "string",
              "null"
            ]
          },
          "impact_score": {
            "type": [
              "number",
              "null"
            ]
          },
          "instruments": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "first_published_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "last_content_updated_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "source_count": {
            "type": "number"
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "id",
          "headline",
          "subtitle",
          "category",
          "sentiment",
          "impact_score",
          "instruments",
          "tags",
          "first_published_at",
          "last_content_updated_at",
          "source_count",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "has_more": {
      "type": "boolean"
    },
    "snapshot_at": {
      "type": "string"
    },
    "snapshot_expires_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "membership_total": {
      "type": "integer",
      "minimum": 0,
      "maximum": 5000
    },
    "withdrawn_count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 50
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "items",
    "next_cursor",
    "has_more",
    "snapshot_at",
    "snapshot_expires_at",
    "membership_total",
    "withdrawn_count"
  ],
  "additionalProperties": false
}

{
  "items": [],
  "next_cursor": "example",
  "has_more": false,
  "snapshot_at": "2026-10-09T00:00:00.000Z",
  "snapshot_expires_at": "2026-10-09T00:00:00.000Z",
  "membership_total": 0,
  "withdrawn_count": 0
}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

el7_news_search

Full-text + semantic hybrid search over published EL7 news stories. Use this when the user asks about a topic, company, or event by name/keyword rather than 'latest'. Returns story cards with a short snippet (never the full body) — call el7_news_story with the returned id for the complete article. Falls back to keyword-only search if the embedding service is unavailable.

news · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "category": {
      "type": "string",
      "enum": [
        "central_banks",
        "forex",
        "commodities",
        "stocks",
        "crypto",
        "bonds",
        "macro",
        "geopolitics",
        "merger",
        "general"
      ]
    },
    "from": {
      "type": "string",
      "maxLength": 40
    },
    "to": {
      "type": "string",
      "maxLength": 40
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

{
  "query": "central bank rates",
  "limit": 10
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "headline": {
            "type": [
              "string",
              "null"
            ]
          },
          "subtitle": {
            "type": [
              "string",
              "null"
            ]
          },
          "category": {
            "type": "string"
          },
          "sentiment": {
            "type": [
              "string",
              "null"
            ]
          },
          "impact_score": {
            "type": [
              "number",
              "null"
            ]
          },
          "instruments": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "first_published_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "last_content_updated_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "source_count": {
            "type": "number"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "snippet": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "headline",
          "subtitle",
          "category",
          "sentiment",
          "impact_score",
          "instruments",
          "tags",
          "first_published_at",
          "last_content_updated_at",
          "source_count",
          "url",
          "snippet"
        ],
        "additionalProperties": false
      }
    },
    "search_mode": {
      "type": "string",
      "enum": [
        "hybrid",
        "keyword_only",
        "semantic_only"
      ]
    },
    "degraded": {
      "type": "boolean"
    },
    "unavailable_legs": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "keyword",
          "semantic"
        ]
      }
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "items",
    "search_mode",
    "degraded",
    "unavailable_legs"
  ],
  "additionalProperties": false
}

{
  "items": [],
  "search_mode": "hybrid",
  "degraded": false,
  "unavailable_legs": []
}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

el7_news_story

Fetches the full text of one published EL7 news story by slug or UUID (headline, subtitle, body, key facts, sources, updates, related stories, and linked economic-calendar events). Use this after el7_news_latest or el7_news_search to read the complete story. Returns data:null if the story is unpublished, merged into another story, archived, or a timeline-only entry.

news · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "A story slug (Arabic or English) or UUID."
    },
    "include": {
      "default": [
        "updates",
        "related",
        "calendar",
        "sources"
      ],
      "description": "Which optional sections to attach.",
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "updates",
          "related",
          "calendar",
          "sources"
        ]
      }
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

{
  "id": "00000000-0000-4000-8000-000000000001"
}

Output schema and synthetic example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "result": {
          "type": "null"
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "result"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "headline": {
          "type": [
            "string",
            "null"
          ]
        },
        "subtitle": {
          "type": [
            "string",
            "null"
          ]
        },
        "body": {
          "type": [
            "string",
            "null"
          ]
        },
        "key_facts": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "category": {
          "type": "string"
        },
        "sentiment": {
          "type": [
            "string",
            "null"
          ]
        },
        "impact_score": {
          "type": [
            "number",
            "null"
          ]
        },
        "instruments": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "first_published_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "last_content_updated_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "url": {
          "type": "string",
          "format": "uri"
        },
        "storyline_slug": {
          "type": "string"
        },
        "sources": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "url": {
                "type": "string"
              },
              "trust_tier": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "name",
              "url",
              "trust_tier"
            ],
            "additionalProperties": false
          }
        },
        "updates": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "ts": {
                "type": "string"
              },
              "text": {
                "type": "string"
              },
              "materiality": {
                "type": "string"
              }
            },
            "required": [
              "ts",
              "text",
              "materiality"
            ],
            "additionalProperties": false
          }
        },
        "related": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "headline": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "category": {
                "type": "string"
              },
              "sentiment": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "impact_score": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "first_published_at": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": "string",
                "format": "uri"
              }
            },
            "required": [
              "id",
              "headline",
              "category",
              "sentiment",
              "impact_score",
              "first_published_at",
              "url"
            ],
            "additionalProperties": false
          }
        },
        "calendar": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "date": {
                "type": "string"
              },
              "country": {
                "type": "string"
              },
              "impact": {
                "type": "string"
              },
              "indicator_slug": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "name",
              "date",
              "country",
              "impact",
              "indicator_slug"
            ],
            "additionalProperties": false
          }
        },
        "freshness": {
          "type": "object",
          "properties": {
            "components": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "unknown_components": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "required": [
            "components",
            "unknown_components"
          ],
          "additionalProperties": false
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "id",
        "headline",
        "subtitle",
        "body",
        "key_facts",
        "category",
        "sentiment",
        "impact_score",
        "instruments",
        "tags",
        "first_published_at",
        "last_content_updated_at",
        "url",
        "freshness"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "result": null
}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

el7_news_reports

Fetches EL7's editorial news reports: daily (pre_eu/pre_us/post_us/post_eu session recaps), weekly, monthly, market_open (weekend recap), or the rolling 'brief' (today's/a date's living digest). Use list:true to browse recent reports of a type, or 'latest'/a specific date to fetch one. Never returns raw market-price blocks (market_performance, session_kpis, weekly_performance, week_ahead_earnings) — those are FMP/internal price data, not news content. Briefs return up to50 visible digest stories with coverage.scope/has_more; story_count is the stored editorial count, separate from returned coverage. Desk articles are outside this MCP brief. Source timestamps may be null; brief_date never supplies an invented source time.

news · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "daily",
        "weekly",
        "monthly",
        "market_open",
        "brief"
      ]
    },
    "session": {
      "description": "Daily reports only.",
      "type": "string",
      "enum": [
        "pre_eu",
        "pre_us",
        "post_us",
        "post_eu"
      ]
    },
    "date": {
      "description": "'latest' (default) or a valid YYYY-MM-DD.",
      "anyOf": [
        {
          "type": "string",
          "const": "latest"
        },
        {
          "type": "string"
        }
      ]
    },
    "period": {
      "description": "YYYY-MM, monthly reports only.",
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
    },
    "list": {
      "default": false,
      "description": "Return summaries of the most recent reports of this type.",
      "type": "boolean"
    },
    "id": {
      "description": "Published report UUID; unavailable for rolling briefs (use their brief_date).",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "type"
  ],
  "additionalProperties": false
}

{
  "type": "daily",
  "list": true,
  "limit": 10
}

Output schema and synthetic example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "result": {
          "type": "null"
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "result"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "report_type": {
          "type": "string"
        },
        "session": {
          "type": [
            "string",
            "null"
          ]
        },
        "period_start": {
          "type": "string"
        },
        "period_end": {
          "type": "string"
        },
        "title": {
          "type": [
            "string",
            "null"
          ]
        },
        "summary": {
          "type": [
            "string",
            "null"
          ]
        },
        "sections": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "category": {
                "type": "string"
              },
              "title": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "summary": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "sentiment": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "stories": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "headline": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "id",
                    "headline"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "category",
              "title",
              "summary",
              "sentiment",
              "stories"
            ],
            "additionalProperties": false
          }
        },
        "extras": {
          "type": "object",
          "properties": {
            "theme": {
              "type": [
                "string",
                "null"
              ]
            },
            "what_changed": {
              "type": [
                "string",
                "null"
              ]
            },
            "timeline": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "date": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "day": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "text": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "date",
                  "day",
                  "text"
                ],
                "additionalProperties": false
              }
            },
            "week_ahead_events": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "date": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "country": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "name": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "forecast": {
                    "type": [
                      "string",
                      "number",
                      "null"
                    ]
                  },
                  "previous": {
                    "type": [
                      "string",
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "date",
                  "country",
                  "name",
                  "forecast",
                  "previous"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "theme",
            "what_changed",
            "timeline",
            "week_ahead_events"
          ],
          "additionalProperties": false
        },
        "story_count": {
          "type": "number"
        },
        "market_sentiment": {
          "type": [
            "string",
            "null"
          ]
        },
        "published_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "id",
        "report_type",
        "session",
        "period_start",
        "period_end",
        "title",
        "summary",
        "sections",
        "extras",
        "story_count",
        "market_sentiment",
        "published_at"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "report_type": {
          "type": "string",
          "const": "brief"
        },
        "brief_date": {
          "type": "string"
        },
        "title": {
          "type": [
            "string",
            "null"
          ]
        },
        "summary": {
          "type": [
            "string",
            "null"
          ]
        },
        "story_count": {
          "type": "number"
        },
        "published_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "market_sentiment": {
          "type": "object",
          "properties": {
            "overall": {
              "type": "string",
              "enum": [
                "bullish",
                "bearish",
                "neutral",
                "mixed"
              ]
            },
            "by_category": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "string",
                "enum": [
                  "bullish",
                  "bearish",
                  "neutral",
                  "mixed"
                ]
              }
            }
          },
          "additionalProperties": false
        },
        "stories": {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "headline": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "category": {
                "type": "string"
              },
              "sentiment": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "impact_score": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "first_published_at": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "source_updated_at": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": "string",
                "format": "uri"
              }
            },
            "required": [
              "id",
              "headline",
              "category",
              "sentiment",
              "impact_score",
              "first_published_at",
              "source_updated_at",
              "url"
            ],
            "additionalProperties": false
          }
        },
        "coverage": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string",
              "const": "digest_stories"
            },
            "scope": {
              "type": "string",
              "enum": [
                "rolling_24h",
                "brief_id"
              ]
            },
            "returned": {
              "type": "integer",
              "minimum": 0,
              "maximum": 50
            },
            "limit": {
              "anyOf": [
                {
                  "type": "number",
                  "const": 50
                },
                {
                  "type": "null"
                }
              ]
            },
            "has_more": {
              "type": [
                "boolean",
                "null"
              ]
            },
            "stored_story_count": {
              "type": "number"
            }
          },
          "required": [
            "source",
            "scope",
            "returned",
            "limit",
            "has_more",
            "stored_story_count"
          ],
          "additionalProperties": false
        },
        "freshness": {
          "type": "object",
          "properties": {
            "brief": {
              "type": [
                "string",
                "null"
              ]
            },
            "stories": {
              "type": [
                "string",
                "null"
              ]
            },
            "unknown_components": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "required": [
            "brief",
            "stories",
            "unknown_components"
          ],
          "additionalProperties": false
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "id",
        "report_type",
        "brief_date",
        "title",
        "summary",
        "story_count",
        "published_at",
        "market_sentiment",
        "stories",
        "coverage",
        "freshness"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "items": {
          "maxItems": 20,
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "report_type": {
                    "type": "string"
                  },
                  "session": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "period_start": {
                    "type": "string"
                  },
                  "period_end": {
                    "type": "string"
                  },
                  "title": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "summary": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "story_count": {
                    "type": "number"
                  },
                  "market_sentiment": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "published_at": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "id",
                  "report_type",
                  "session",
                  "period_start",
                  "period_end",
                  "title",
                  "summary",
                  "story_count",
                  "market_sentiment",
                  "published_at"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "report_type": {
                    "type": "string",
                    "const": "brief"
                  },
                  "brief_date": {
                    "type": "string"
                  },
                  "title": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "summary": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "story_count": {
                    "type": "number"
                  },
                  "published_at": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "id",
                  "report_type",
                  "brief_date",
                  "title",
                  "summary",
                  "story_count",
                  "published_at"
                ],
                "additionalProperties": false
              }
            ]
          }
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "items"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "result": null
}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

el7_news_storylines

Storylines ('events') group related stories tracking one ongoing situation over multiple days (e.g. a central bank decision cycle, an M&A saga). Use this to answer 'how has X developed over time'. Pass slug to get one storyline with its full story timeline, or omit it to list storylines by lifecycle status (default: breaking/developing/ongoing).

news · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "status": {
      "default": [
        "breaking",
        "developing",
        "ongoing"
      ],
      "description": "Storyline lifecycle states to include.",
      "minItems": 1,
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "candidate",
          "breaking",
          "developing",
          "ongoing",
          "fading",
          "resolved"
        ]
      }
    },
    "category": {
      "type": "string",
      "enum": [
        "central_banks",
        "forex",
        "commodities",
        "stocks",
        "crypto",
        "bonds",
        "macro",
        "geopolitics",
        "merger",
        "general"
      ]
    },
    "slug": {
      "description": "Return one storyline (with its stories) by slug.",
      "type": "string",
      "minLength": 1,
      "maxLength": 300
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

{
  "status": [
    "breaking",
    "developing",
    "ongoing"
  ],
  "limit": 20
}

Output schema and synthetic example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "result": {
          "type": "null"
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "result"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "items": {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "title": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "summary": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "category": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "first_detected_at": {
                "type": "string"
              },
              "last_new_fact_at": {
                "type": "string"
              },
              "article_count": {
                "type": "number"
              },
              "story_count": {
                "type": "number"
              },
              "latest_impact_score": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "affected_instruments": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "id",
              "title",
              "summary",
              "category",
              "status",
              "first_detected_at",
              "last_new_fact_at",
              "article_count",
              "story_count",
              "latest_impact_score",
              "affected_instruments"
            ],
            "additionalProperties": false
          }
        },
        "has_more": {
          "type": "boolean"
        },
        "limit": {
          "type": "number"
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "items",
        "has_more",
        "limit"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "title": {
          "type": [
            "string",
            "null"
          ]
        },
        "summary": {
          "type": [
            "string",
            "null"
          ]
        },
        "category": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "first_detected_at": {
          "type": "string"
        },
        "last_new_fact_at": {
          "type": "string"
        },
        "article_count": {
          "type": "number"
        },
        "story_count": {
          "type": "number"
        },
        "latest_impact_score": {
          "type": [
            "number",
            "null"
          ]
        },
        "affected_instruments": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "stories": {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "headline": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "category": {
                "type": "string"
              },
              "sentiment": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "impact_score": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "first_published_at": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": "string",
                "format": "uri"
              }
            },
            "required": [
              "id",
              "headline",
              "category",
              "sentiment",
              "impact_score",
              "first_published_at",
              "url"
            ],
            "additionalProperties": false
          }
        },
        "stories_coverage": {
          "type": "object",
          "properties": {
            "returned": {
              "type": "number"
            },
            "limit": {
              "type": "number"
            },
            "has_more": {
              "type": "boolean"
            }
          },
          "required": [
            "returned",
            "limit",
            "has_more"
          ],
          "additionalProperties": false
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "id",
        "title",
        "summary",
        "category",
        "status",
        "first_detected_at",
        "last_new_fact_at",
        "article_count",
        "story_count",
        "latest_impact_score",
        "affected_instruments",
        "stories",
        "stories_coverage"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "result": null
}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

el7_news_pulse

Aggregate sentiment computed from recent news coverage (NOT price action) for one symbol (view='symbol', requires symbol), an instrument category (view='kind', requires kind: forex/commodity/crypto/index/rates/vol), the whole market (view='market'), or trending topic tags (view='trending'). Scores run -1 (bearish) to +1 (bullish). Returns found:false / an empty result rather than a fabricated score when there isn't enough coverage to compute one.

news · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "view": {
      "type": "string",
      "enum": [
        "symbol",
        "kind",
        "market",
        "trending"
      ]
    },
    "symbol": {
      "description": "Required for view='symbol'.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "kind": {
      "description": "Required for view='kind'.",
      "type": "string",
      "enum": [
        "forex",
        "commodity",
        "crypto",
        "index",
        "rates",
        "vol"
      ]
    },
    "window": {
      "description": "Sentiment window for symbol, kind, or market views; defaults to 24h. Not accepted for trending.",
      "type": "string",
      "enum": [
        "1h",
        "4h",
        "24h",
        "7d",
        "30d"
      ]
    },
    "hours": {
      "description": "Lookback for view='trending', default 24 hours. Not accepted for sentiment views.",
      "type": "integer",
      "minimum": 1,
      "maximum": 168
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "view"
  ],
  "additionalProperties": false
}

{
  "view": "market",
  "window": "24h"
}

Output schema and synthetic example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "symbol": {
          "type": "string"
        },
        "window": {
          "type": "string"
        },
        "found": {
          "type": "boolean",
          "const": false
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "symbol",
        "window",
        "found"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "symbol": {
          "type": "string"
        },
        "kind": {
          "type": "string"
        },
        "window": {
          "type": "string"
        },
        "score": {
          "type": "number"
        },
        "dispersion": {
          "type": "number"
        },
        "sample_size": {
          "type": "number"
        },
        "prev_score": {
          "type": [
            "number",
            "null"
          ]
        },
        "delta": {
          "type": [
            "number",
            "null"
          ]
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "symbol",
        "kind",
        "window",
        "score",
        "dispersion",
        "sample_size",
        "prev_score",
        "delta"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string"
        },
        "window": {
          "type": "string"
        },
        "mean_score": {
          "type": [
            "number",
            "null"
          ]
        },
        "found": {
          "type": "boolean"
        },
        "symbols_covered": {
          "type": "number"
        },
        "total_samples": {
          "type": "number"
        },
        "top_symbols": {
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "symbol": {
                "type": "string"
              },
              "score": {
                "type": "number"
              },
              "sample_size": {
                "type": "number"
              },
              "source_updated_at": {
                "type": "string"
              }
            },
            "required": [
              "symbol",
              "score",
              "sample_size",
              "source_updated_at"
            ],
            "additionalProperties": false
          }
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "kind",
        "window",
        "mean_score",
        "found",
        "symbols_covered",
        "total_samples",
        "top_symbols"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "window": {
          "type": "string"
        },
        "overall_score": {
          "type": [
            "number",
            "null"
          ]
        },
        "found": {
          "type": "boolean"
        },
        "computed_at": {
          "type": "string"
        },
        "freshness_basis": {
          "type": "string",
          "const": "oldest_source_update_across_contributing_symbols"
        },
        "overall_samples": {
          "type": "number"
        },
        "by_kind": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string"
              },
              "mean_score": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "source_as_of": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "latest_source_update": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "symbols_covered": {
                "type": "number"
              },
              "total_samples": {
                "type": "number"
              }
            },
            "required": [
              "kind",
              "mean_score",
              "source_as_of",
              "latest_source_update",
              "symbols_covered",
              "total_samples"
            ],
            "additionalProperties": false
          }
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "window",
        "overall_score",
        "found",
        "computed_at",
        "freshness_basis",
        "overall_samples",
        "by_kind"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "items": {
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "tag": {
                "type": "string"
              },
              "frequency": {
                "type": "number"
              },
              "avg_impact": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "tag",
              "frequency",
              "avg_impact",
              "categories"
            ],
            "additionalProperties": false
          }
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "items"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "symbol": "example",
  "window": "example",
  "found": false
}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

el7_calendar_events

List economic calendar events for a date window or range, with consensus forecasts, prior values, and surprise z-scores. Filter by window ('today'|'tomorrow'|'this_week'|'next_week') or an explicit from/to date range (max 31 days), country, currency, impact, category, event type, a specific indicator slug, or release status. Returns items, has_more and next_cursor; reuse identical filters to page. Oversized source ranges are refused instead of silently truncated. Use this to answer 'what's on the calendar this week' or 'what high-impact US releases are coming up'. Each item includes a published EL7 url and typed sources; agency links are reference pages, not per-reading provenance. Does not include prices or AI-written commentary.

calendar · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "window": {
      "description": "A named calendar window resolved in `tz`; choose this OR from/to.",
      "type": "string",
      "enum": [
        "today",
        "tomorrow",
        "this_week",
        "next_week"
      ]
    },
    "from": {
      "description": "Start date, inclusive, YYYY-MM-DD (UTC calendar day). Requires `to`.",
      "type": "string"
    },
    "to": {
      "description": "End date, inclusive, YYYY-MM-DD (UTC calendar day). Requires `from`. Max 31 days from `from`.",
      "type": "string"
    },
    "tz": {
      "default": "UTC",
      "description": "IANA timezone used to resolve `window` boundaries (e.g. 'Asia/Dubai'). Ignored when `from`/`to` are given.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "countries": {
      "description": "ISO country codes to include.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z]{2}$"
      }
    },
    "currencies": {
      "description": "Currency codes (e.g. 'EUR') — resolved to their issuing countries and merged with `countries`.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z]{3}$"
      }
    },
    "impact": {
      "minItems": 1,
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "high",
          "medium",
          "low"
        ]
      }
    },
    "category": {
      "minItems": 1,
      "maxItems": 11,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "inflation",
          "employment",
          "growth",
          "housing",
          "manufacturing",
          "trade",
          "consumer",
          "government",
          "central_bank",
          "energy",
          "other"
        ]
      }
    },
    "event_type": {
      "minItems": 1,
      "maxItems": 7,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "data_release",
          "rate_decision",
          "speech",
          "auction",
          "holiday",
          "report",
          "meeting"
        ]
      }
    },
    "indicator": {
      "description": "Canonical indicator slug — restricts results to that one series.",
      "type": "string",
      "minLength": 1,
      "maxLength": 300
    },
    "status": {
      "description": "'released' = has an actual; 'upcoming' = does not yet.",
      "type": "string",
      "enum": [
        "upcoming",
        "released"
      ]
    },
    "limit": {
      "default": 100,
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "cursor": {
      "description": "Opaque cursor bound to this resolved window and the same filters.",
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

{
  "window": "this_week",
  "tz": "Asia/Dubai",
  "limit": 100
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 2048,
            "format": "uri"
          },
          "source_url": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048,
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "sources": {
            "minItems": 1,
            "maxItems": 2,
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "const": "el7"
                    },
                    "scope": {
                      "type": "string",
                      "enum": [
                        "calendar",
                        "indicator",
                        "country"
                      ]
                    },
                    "url": {
                      "type": "string",
                      "maxLength": 2048,
                      "format": "uri"
                    },
                    "label": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "kind",
                    "scope",
                    "url",
                    "label"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "const": "agency"
                    },
                    "scope": {
                      "type": "string",
                      "const": "agency_reference"
                    },
                    "url": {
                      "type": "string",
                      "maxLength": 2048,
                      "format": "uri"
                    },
                    "label": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "kind",
                    "scope",
                    "url",
                    "label"
                  ],
                  "additionalProperties": false
                }
              ],
              "description": "EL7 published pages and stored agency reference pages. References do not assert provenance for an individual actual, forecast or revision."
            }
          },
          "id": {
            "type": "string"
          },
          "indicator_slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "country_code": {
            "type": "string"
          },
          "country_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "date": {
            "type": "string"
          },
          "source_updated_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "impact": {
            "type": "string"
          },
          "event_type": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "actual": {
            "type": [
              "number",
              "null"
            ]
          },
          "first_print": {
            "type": [
              "number",
              "null"
            ]
          },
          "forecast": {
            "type": [
              "number",
              "null"
            ]
          },
          "previous": {
            "type": [
              "number",
              "null"
            ]
          },
          "revised": {
            "type": [
              "number",
              "null"
            ]
          },
          "surprise_zscore": {
            "type": [
              "number",
              "null"
            ]
          },
          "unit": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string"
          },
          "minutes_past_release": {
            "type": [
              "number",
              "null"
            ]
          },
          "holiday_market_status": {
            "type": [
              "string",
              "null"
            ]
          },
          "holiday_close_time": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "url",
          "source_url",
          "sources",
          "id",
          "indicator_slug",
          "name",
          "country_code",
          "country_name",
          "date",
          "source_updated_at",
          "impact",
          "event_type",
          "category",
          "actual",
          "first_print",
          "forecast",
          "previous",
          "revised",
          "surprise_zscore",
          "unit",
          "status",
          "minutes_past_release",
          "holiday_market_status",
          "holiday_close_time"
        ],
        "additionalProperties": false
      }
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "has_more": {
      "type": "boolean"
    },
    "range": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from",
        "to"
      ],
      "additionalProperties": false
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "items",
    "next_cursor",
    "has_more",
    "range"
  ],
  "additionalProperties": false
}

{
  "items": [],
  "next_cursor": "example",
  "has_more": false,
  "range": {
    "from": "example",
    "to": "example"
  }
}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

el7_calendar_event

Get full detail for one calendar event, by UUID or by (indicator slug, date). latest_release (latest alias) selects the newest row with a released actual; next_release selects the next scheduled event. Optionally include changes (revision log), details (speaker/venue for speeches), news (visibility-filtered related stories), stats (historical distribution), or history (recent prior readings). Use this after el7_calendar_events to drill into a specific release. Does not include AI predictions or raw provider payloads. Includes a published EL7 url and typed sources; agency links identify reference pages without asserting per-reading provenance.

calendar · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "id": {
      "description": "Calendar event UUID.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "indicator": {
      "description": "Indicator slug — use with `date`.",
      "type": "string",
      "minLength": 1,
      "maxLength": 300
    },
    "date": {
      "description": "latest_release (latest is its compatibility alias), next_release, or a UTC calendar date YYYY-MM-DD; use with indicator.",
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "latest",
            "latest_release",
            "next_release"
          ]
        },
        {
          "type": "string"
        }
      ]
    },
    "include": {
      "description": "Extra sections to attach. Omit for the core fields only.",
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "changes",
          "details",
          "news",
          "stats",
          "history"
        ]
      }
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

{
  "indicator": "us-unemployment-rate",
  "date": "latest_release"
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri"
    },
    "source_url": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2048,
          "format": "uri"
        },
        {
          "type": "null"
        }
      ]
    },
    "sources": {
      "minItems": 1,
      "maxItems": 2,
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "el7"
              },
              "scope": {
                "type": "string",
                "enum": [
                  "calendar",
                  "indicator",
                  "country"
                ]
              },
              "url": {
                "type": "string",
                "maxLength": 2048,
                "format": "uri"
              },
              "label": {
                "type": "string"
              }
            },
            "required": [
              "kind",
              "scope",
              "url",
              "label"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "agency"
              },
              "scope": {
                "type": "string",
                "const": "agency_reference"
              },
              "url": {
                "type": "string",
                "maxLength": 2048,
                "format": "uri"
              },
              "label": {
                "type": "string"
              }
            },
            "required": [
              "kind",
              "scope",
              "url",
              "label"
            ],
            "additionalProperties": false
          }
        ],
        "description": "EL7 published pages and stored agency reference pages. References do not assert provenance for an individual actual, forecast or revision."
      }
    },
    "id": {
      "type": "string"
    },
    "indicator_slug": {
      "type": [
        "string",
        "null"
      ]
    },
    "name": {
      "type": "string"
    },
    "country_code": {
      "type": "string"
    },
    "country_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "date": {
      "type": "string"
    },
    "source_updated_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "impact": {
      "type": "string"
    },
    "event_type": {
      "type": "string"
    },
    "category": {
      "type": [
        "string",
        "null"
      ]
    },
    "actual": {
      "type": [
        "number",
        "null"
      ]
    },
    "first_print": {
      "type": [
        "number",
        "null"
      ]
    },
    "forecast": {
      "type": [
        "number",
        "null"
      ]
    },
    "previous": {
      "type": [
        "number",
        "null"
      ]
    },
    "revised": {
      "type": [
        "number",
        "null"
      ]
    },
    "surprise_zscore": {
      "type": [
        "number",
        "null"
      ]
    },
    "unit": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": "string"
    },
    "minutes_past_release": {
      "type": [
        "number",
        "null"
      ]
    },
    "holiday_market_status": {
      "type": [
        "string",
        "null"
      ]
    },
    "holiday_close_time": {
      "type": [
        "string",
        "null"
      ]
    },
    "changes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "field_changed": {
            "type": "string"
          },
          "old_value": {
            "type": [
              "string",
              "null"
            ]
          },
          "new_value": {
            "type": [
              "string",
              "null"
            ]
          },
          "changed_at": {
            "type": "string"
          }
        },
        "required": [
          "field_changed",
          "old_value",
          "new_value",
          "changed_at"
        ],
        "additionalProperties": false
      }
    },
    "details": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "source_url": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 2048,
                  "format": "uri"
                },
                {
                  "type": "null"
                }
              ]
            },
            "live_url": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uri"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "source_url",
            "live_url"
          ],
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "stats": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "mean": {
              "type": [
                "number",
                "null"
              ]
            },
            "std_dev": {
              "type": [
                "number",
                "null"
              ]
            },
            "std_dev_upper": {
              "type": [
                "number",
                "null"
              ]
            },
            "std_dev_lower": {
              "type": [
                "number",
                "null"
              ]
            },
            "std_dev_2_upper": {
              "type": [
                "number",
                "null"
              ]
            },
            "std_dev_2_lower": {
              "type": [
                "number",
                "null"
              ]
            },
            "median": {
              "type": [
                "number",
                "null"
              ]
            },
            "min_value": {
              "type": [
                "number",
                "null"
              ]
            },
            "min_value_date": {
              "type": [
                "string",
                "null"
              ]
            },
            "max_value": {
              "type": [
                "number",
                "null"
              ]
            },
            "max_value_date": {
              "type": [
                "string",
                "null"
              ]
            },
            "surprise_mean": {
              "type": [
                "number",
                "null"
              ]
            },
            "surprise_std_dev": {
              "type": [
                "number",
                "null"
              ]
            },
            "forecast_accuracy": {
              "type": [
                "number",
                "null"
              ]
            },
            "trend_direction": {
              "type": [
                "string",
                "null"
              ]
            },
            "trend_streak": {
              "type": [
                "number",
                "null"
              ]
            },
            "surprise_streak": {
              "type": [
                "number",
                "null"
              ]
            },
            "surprise_streak_direction": {
              "type": [
                "string",
                "null"
              ]
            },
            "mom_change": {
              "type": [
                "number",
                "null"
              ]
            },
            "yoy_change": {
              "type": [
                "number",
                "null"
              ]
            },
            "data_points_count": {
              "type": [
                "number",
                "null"
              ]
            },
            "last_updated": {
              "type": "string"
            }
          },
          "required": [
            "mean",
            "std_dev",
            "std_dev_upper",
            "std_dev_lower",
            "std_dev_2_upper",
            "std_dev_2_lower",
            "median",
            "min_value",
            "min_value_date",
            "max_value",
            "max_value_date",
            "surprise_mean",
            "surprise_std_dev",
            "forecast_accuracy",
            "trend_direction",
            "trend_streak",
            "surprise_streak",
            "surprise_streak_direction",
            "mom_change",
            "yoy_change",
            "data_points_count",
            "last_updated"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "history": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 2048,
            "format": "uri"
          },
          "date": {
            "type": "string"
          },
          "actual": {
            "type": [
              "number",
              "null"
            ]
          },
          "first_print": {
            "type": [
              "number",
              "null"
            ]
          },
          "forecast": {
            "type": [
              "number",
              "null"
            ]
          },
          "previous": {
            "type": [
              "number",
              "null"
            ]
          },
          "surprise_zscore": {
            "type": [
              "number",
              "null"
            ]
          },
          "revision": {
            "type": "boolean"
          },
          "source_updated_at": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "url",
          "date",
          "actual",
          "first_print",
          "forecast",
          "previous",
          "surprise_zscore",
          "revision",
          "source_updated_at"
        ],
        "additionalProperties": false
      }
    },
    "history_coverage": {
      "type": "object",
      "properties": {
        "returned": {
          "type": "number"
        },
        "limit": {
          "type": "number"
        },
        "has_more": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "continuation_tool": {
          "type": "string",
          "const": "el7_calendar_history"
        }
      },
      "required": [
        "returned",
        "limit",
        "has_more",
        "continuation_tool"
      ],
      "additionalProperties": false
    },
    "news": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "headline": {
            "type": "string"
          },
          "first_published_at": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "headline",
          "first_published_at"
        ],
        "additionalProperties": false
      }
    },
    "freshness": {
      "type": "object",
      "properties": {
        "components": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "unknown_components": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "components",
        "unknown_components"
      ],
      "additionalProperties": false
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "url",
    "source_url",
    "sources",
    "id",
    "indicator_slug",
    "name",
    "country_code",
    "country_name",
    "date",
    "source_updated_at",
    "impact",
    "event_type",
    "category",
    "actual",
    "first_print",
    "forecast",
    "previous",
    "revised",
    "surprise_zscore",
    "unit",
    "status",
    "minutes_past_release",
    "holiday_market_status",
    "holiday_close_time",
    "freshness"
  ],
  "additionalProperties": false,
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{
  "url": "https://el7.ai/ar/economic-calendar",
  "source_url": null,
  "sources": [
    {
      "kind": "el7",
      "scope": "calendar",
      "url": "https://el7.ai/ar/economic-calendar",
      "label": "example"
    }
  ],
  "id": "example",
  "indicator_slug": "example",
  "name": "example",
  "country_code": "example",
  "country_name": "example",
  "date": "2026-10-09T00:00:00.000Z",
  "source_updated_at": "2026-10-09T00:00:00.000Z",
  "impact": "example",
  "event_type": "example",
  "category": "example",
  "actual": 0,
  "first_print": 0,
  "forecast": 0,
  "previous": 0,
  "revised": 0,
  "surprise_zscore": 0,
  "unit": "example",
  "status": "example",
  "minutes_past_release": 0,
  "holiday_market_status": "example",
  "holiday_close_time": "example",
  "freshness": {
    "components": {},
    "unknown_components": []
  }
}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

el7_calendar_indicator

Look up a canonical economic indicator by slug, or search by name/alias when the slug is unknown (returns up to 10 candidates). Returns methodology, source agency, release schedule, market-impact guidance, related indicators, the next scheduled releases, and historical statistics (mean, std dev, surprise history, trend), a published EL7 url, and typed sources. source_url is a validated stored agency reference or null, not evidence of actual/forecast provenance. Does not include AI content or market-price correlations.

calendar · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300
    },
    "query": {
      "description": "Free-text name or alias search, used when `slug` is unknown.",
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

{
  "query": "unemployment"
}

Output schema and synthetic example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "candidates": {
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "maxLength": 2048,
                "format": "uri"
              },
              "source_url": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 2048,
                    "format": "uri"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "sources": {
                "minItems": 1,
                "maxItems": 2,
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "el7"
                        },
                        "scope": {
                          "type": "string",
                          "enum": [
                            "calendar",
                            "indicator",
                            "country"
                          ]
                        },
                        "url": {
                          "type": "string",
                          "maxLength": 2048,
                          "format": "uri"
                        },
                        "label": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "kind",
                        "scope",
                        "url",
                        "label"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "agency"
                        },
                        "scope": {
                          "type": "string",
                          "const": "agency_reference"
                        },
                        "url": {
                          "type": "string",
                          "maxLength": 2048,
                          "format": "uri"
                        },
                        "label": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "kind",
                        "scope",
                        "url",
                        "label"
                      ],
                      "additionalProperties": false
                    }
                  ],
                  "description": "EL7 published pages and stored agency reference pages. References do not assert provenance for an individual actual, forecast or revision."
                }
              },
              "slug": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "country_code": {
                "type": "string"
              }
            },
            "required": [
              "url",
              "source_url",
              "sources",
              "slug",
              "name",
              "country_code"
            ],
            "additionalProperties": false
          }
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "candidates"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "url": {
          "type": "string",
          "maxLength": 2048,
          "format": "uri"
        },
        "source_url": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 2048,
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "sources": {
          "minItems": 1,
          "maxItems": 2,
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "el7"
                  },
                  "scope": {
                    "type": "string",
                    "enum": [
                      "calendar",
                      "indicator",
                      "country"
                    ]
                  },
                  "url": {
                    "type": "string",
                    "maxLength": 2048,
                    "format": "uri"
                  },
                  "label": {
                    "type": "string"
                  }
                },
                "required": [
                  "kind",
                  "scope",
                  "url",
                  "label"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "agency"
                  },
                  "scope": {
                    "type": "string",
                    "const": "agency_reference"
                  },
                  "url": {
                    "type": "string",
                    "maxLength": 2048,
                    "format": "uri"
                  },
                  "label": {
                    "type": "string"
                  }
                },
                "required": [
                  "kind",
                  "scope",
                  "url",
                  "label"
                ],
                "additionalProperties": false
              }
            ],
            "description": "EL7 published pages and stored agency reference pages. References do not assert provenance for an individual actual, forecast or revision."
          }
        },
        "slug": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "country_code": {
          "type": "string"
        },
        "category": {
          "type": [
            "string",
            "null"
          ]
        },
        "frequency": {
          "type": [
            "string",
            "null"
          ]
        },
        "unit": {
          "type": [
            "string",
            "null"
          ]
        },
        "source_agency": {
          "type": [
            "string",
            "null"
          ]
        },
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "methodology": {
          "type": [
            "string",
            "null"
          ]
        },
        "release_schedule": {
          "type": [
            "string",
            "null"
          ]
        },
        "market_impact_description": {
          "type": [
            "string",
            "null"
          ]
        },
        "bullish_condition": {
          "type": [
            "string",
            "null"
          ]
        },
        "bearish_condition": {
          "type": [
            "string",
            "null"
          ]
        },
        "assets_affected": {
          "anyOf": [
            {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            {
              "type": "null"
            }
          ]
        },
        "related_indicators": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "maxLength": 2048,
                "format": "uri"
              },
              "slug": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "country_code": {
                "type": "string"
              }
            },
            "required": [
              "url",
              "slug",
              "name",
              "country_code"
            ],
            "additionalProperties": false
          }
        },
        "next_releases": {
          "maxItems": 5,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "maxLength": 2048,
                "format": "uri"
              },
              "date": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "forecast": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "previous": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "impact": {
                "type": "string"
              },
              "source_updated_at": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "url",
              "date",
              "name",
              "forecast",
              "previous",
              "impact",
              "source_updated_at"
            ],
            "additionalProperties": false
          }
        },
        "stats": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "mean": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "std_dev": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "std_dev_upper": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "std_dev_lower": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "std_dev_2_upper": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "std_dev_2_lower": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "median": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "min_value": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "min_value_date": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "max_value": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "max_value_date": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "surprise_mean": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "surprise_std_dev": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "forecast_accuracy": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "trend_direction": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "trend_streak": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "surprise_streak": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "surprise_streak_direction": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "mom_change": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "yoy_change": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "data_points_count": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "last_updated": {
                  "type": "string"
                }
              },
              "required": [
                "mean",
                "std_dev",
                "std_dev_upper",
                "std_dev_lower",
                "std_dev_2_upper",
                "std_dev_2_lower",
                "median",
                "min_value",
                "min_value_date",
                "max_value",
                "max_value_date",
                "surprise_mean",
                "surprise_std_dev",
                "forecast_accuracy",
                "trend_direction",
                "trend_streak",
                "surprise_streak",
                "surprise_streak_direction",
                "mom_change",
                "yoy_change",
                "data_points_count",
                "last_updated"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "freshness": {
          "type": "object",
          "properties": {
            "metadata": {
              "type": [
                "string",
                "null"
              ]
            },
            "stats": {
              "type": [
                "string",
                "null"
              ]
            },
            "next_releases": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "metadata",
            "stats",
            "next_releases"
          ],
          "additionalProperties": false
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "url",
        "source_url",
        "sources",
        "slug",
        "name",
        "country_code",
        "category",
        "frequency",
        "unit",
        "source_agency",
        "description",
        "methodology",
        "release_schedule",
        "market_impact_description",
        "bullish_condition",
        "bearish_condition",
        "assets_affected",
        "related_indicators",
        "next_releases",
        "stats",
        "freshness"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "candidates": []
}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

el7_calendar_history

Paginated chronological history of actual/forecast/previous readings for one indicator, with the first print and a revision flag when a later vintage changed the value. Use `cursor` (from the previous response's `next_cursor`) to page through more than `limit` rows. Includes the published indicator url and typed sources; stored agency links are references, not per-reading provenance.

calendar · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "indicator": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "Canonical indicator slug."
    },
    "from": {
      "description": "Inclusive lower bound, YYYY-MM-DD.",
      "type": "string"
    },
    "to": {
      "description": "Inclusive upper bound, YYYY-MM-DD.",
      "type": "string"
    },
    "limit": {
      "default": 60,
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "cursor": {
      "description": "Opaque keyset cursor tied to indicator and date bounds.",
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "indicator"
  ],
  "additionalProperties": false
}

{
  "indicator": "us-unemployment-rate",
  "from": "2026-01-01",
  "to": "2026-09-30",
  "limit": 60
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri"
    },
    "source_url": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2048,
          "format": "uri"
        },
        {
          "type": "null"
        }
      ]
    },
    "sources": {
      "minItems": 1,
      "maxItems": 2,
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "el7"
              },
              "scope": {
                "type": "string",
                "enum": [
                  "calendar",
                  "indicator",
                  "country"
                ]
              },
              "url": {
                "type": "string",
                "maxLength": 2048,
                "format": "uri"
              },
              "label": {
                "type": "string"
              }
            },
            "required": [
              "kind",
              "scope",
              "url",
              "label"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "agency"
              },
              "scope": {
                "type": "string",
                "const": "agency_reference"
              },
              "url": {
                "type": "string",
                "maxLength": 2048,
                "format": "uri"
              },
              "label": {
                "type": "string"
              }
            },
            "required": [
              "kind",
              "scope",
              "url",
              "label"
            ],
            "additionalProperties": false
          }
        ],
        "description": "EL7 published pages and stored agency reference pages. References do not assert provenance for an individual actual, forecast or revision."
      }
    },
    "rows": {
      "maxItems": 500,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 2048,
            "format": "uri"
          },
          "date": {
            "type": "string"
          },
          "actual": {
            "type": [
              "number",
              "null"
            ]
          },
          "first_print": {
            "type": [
              "number",
              "null"
            ]
          },
          "forecast": {
            "type": [
              "number",
              "null"
            ]
          },
          "previous": {
            "type": [
              "number",
              "null"
            ]
          },
          "surprise_zscore": {
            "type": [
              "number",
              "null"
            ]
          },
          "revision": {
            "type": "boolean"
          },
          "source_updated_at": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "url",
          "date",
          "actual",
          "first_print",
          "forecast",
          "previous",
          "surprise_zscore",
          "revision",
          "source_updated_at"
        ],
        "additionalProperties": false
      }
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "has_more": {
      "type": "boolean"
    },
    "order": {
      "type": "string",
      "const": "newest_pages_with_chronological_rows"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "url",
    "source_url",
    "sources",
    "rows",
    "next_cursor",
    "has_more",
    "order"
  ],
  "additionalProperties": false
}

{
  "url": "https://el7.ai/ar/economic-calendar",
  "source_url": null,
  "sources": [
    {
      "kind": "el7",
      "scope": "calendar",
      "url": "https://el7.ai/ar/economic-calendar",
      "label": "example"
    }
  ],
  "rows": [],
  "next_cursor": "example",
  "has_more": false,
  "order": "newest_pages_with_chronological_rows"
}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

el7_calendar_surprise

Two views of aggregate data surprises: 'index' returns the Economic Surprise Index (ESI) per country — a weighted average of how far recent releases beat or missed consensus — with beat/miss rates and regime label. 'heatmap' returns per-country-per-day average surprise z-scores over the trailing 30 or 90 days, for spotting which economies are running hot or cold. Includes an EL7 calendar reference url and sources; this computed aggregate does not assert agency provenance.

calendar · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "view": {
      "type": "string",
      "enum": [
        "index",
        "heatmap"
      ]
    },
    "country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "window": {
      "default": "90d",
      "type": "string",
      "enum": [
        "30d",
        "90d"
      ]
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "view"
  ],
  "additionalProperties": false
}

{
  "view": "index"
}

Output schema and synthetic example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "result": {
          "maxItems": 100,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "maxLength": 2048,
                "format": "uri"
              },
              "source_url": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 2048,
                    "format": "uri"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "sources": {
                "minItems": 1,
                "maxItems": 2,
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "el7"
                        },
                        "scope": {
                          "type": "string",
                          "enum": [
                            "calendar",
                            "indicator",
                            "country"
                          ]
                        },
                        "url": {
                          "type": "string",
                          "maxLength": 2048,
                          "format": "uri"
                        },
                        "label": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "kind",
                        "scope",
                        "url",
                        "label"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "agency"
                        },
                        "scope": {
                          "type": "string",
                          "const": "agency_reference"
                        },
                        "url": {
                          "type": "string",
                          "maxLength": 2048,
                          "format": "uri"
                        },
                        "label": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "kind",
                        "scope",
                        "url",
                        "label"
                      ],
                      "additionalProperties": false
                    }
                  ],
                  "description": "EL7 published pages and stored agency reference pages. References do not assert provenance for an individual actual, forecast or revision."
                }
              },
              "country_code": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "esi_30d": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "esi_90d": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "events_30d": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "events_90d": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "beat_rate_30d": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "miss_rate_30d": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "latest_event": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "latest_zscore": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "latest_date": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "max_abs_zscore_30d": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "esi_regime": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "refreshed_at": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "url",
              "source_url",
              "sources",
              "country_code",
              "esi_30d",
              "esi_90d",
              "events_30d",
              "events_90d",
              "beat_rate_30d",
              "miss_rate_30d",
              "latest_event",
              "latest_zscore",
              "latest_date",
              "max_abs_zscore_30d",
              "esi_regime",
              "refreshed_at"
            ],
            "additionalProperties": false
          }
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "result"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "url": {
          "type": "string",
          "maxLength": 2048,
          "format": "uri"
        },
        "source_url": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 2048,
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "sources": {
          "minItems": 1,
          "maxItems": 2,
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "el7"
                  },
                  "scope": {
                    "type": "string",
                    "enum": [
                      "calendar",
                      "indicator",
                      "country"
                    ]
                  },
                  "url": {
                    "type": "string",
                    "maxLength": 2048,
                    "format": "uri"
                  },
                  "label": {
                    "type": "string"
                  }
                },
                "required": [
                  "kind",
                  "scope",
                  "url",
                  "label"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "const": "agency"
                  },
                  "scope": {
                    "type": "string",
                    "const": "agency_reference"
                  },
                  "url": {
                    "type": "string",
                    "maxLength": 2048,
                    "format": "uri"
                  },
                  "label": {
                    "type": "string"
                  }
                },
                "required": [
                  "kind",
                  "scope",
                  "url",
                  "label"
                ],
                "additionalProperties": false
              }
            ],
            "description": "EL7 published pages and stored agency reference pages. References do not assert provenance for an individual actual, forecast or revision."
          }
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "country": {
                "type": "string"
              },
              "day": {
                "type": "string"
              },
              "zscore": {
                "type": "number"
              },
              "count": {
                "type": "number"
              },
              "events": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "country",
              "day",
              "zscore",
              "count",
              "events"
            ],
            "additionalProperties": false
          }
        },
        "source_row_count": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 5000
        },
        "source_limit": {
          "type": "number",
          "const": 5000
        },
        "truncated": {
          "type": "boolean",
          "const": false
        },
        "as_of": {
          "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "url",
        "source_url",
        "sources",
        "items",
        "source_row_count",
        "source_limit",
        "truncated"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "result": []
}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

el7_calendar_country

Snapshot for one country: profile (name, currency, region), its central bank's current policy rate and last decision, key indicator stats, upcoming high-impact events (next 14 days), and recent releases. Does not include currency-pair or stock-index quotes, AI briefs, or a heuristic health score. Rate/stat values must be released; policy rates use known rate indicators, excluding surveys and vote counts. Unknown policy rates remain null. Includes the published country url and EL7 reference sources. Returns not-found for Israel (excluded upstream).

calendar · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "code": {
      "description": "ISO country code, e.g. 'SA', 'US'.",
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}

{
  "code": "US"
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri"
    },
    "source_url": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2048,
          "format": "uri"
        },
        {
          "type": "null"
        }
      ]
    },
    "sources": {
      "minItems": 1,
      "maxItems": 2,
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "el7"
              },
              "scope": {
                "type": "string",
                "enum": [
                  "calendar",
                  "indicator",
                  "country"
                ]
              },
              "url": {
                "type": "string",
                "maxLength": 2048,
                "format": "uri"
              },
              "label": {
                "type": "string"
              }
            },
            "required": [
              "kind",
              "scope",
              "url",
              "label"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "agency"
              },
              "scope": {
                "type": "string",
                "const": "agency_reference"
              },
              "url": {
                "type": "string",
                "maxLength": 2048,
                "format": "uri"
              },
              "label": {
                "type": "string"
              }
            },
            "required": [
              "kind",
              "scope",
              "url",
              "label"
            ],
            "additionalProperties": false
          }
        ],
        "description": "EL7 published pages and stored agency reference pages. References do not assert provenance for an individual actual, forecast or revision."
      }
    },
    "profile": {
      "type": "object",
      "properties": {
        "country_code": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "currency_code": {
          "type": [
            "string",
            "null"
          ]
        },
        "region": {
          "type": [
            "string",
            "null"
          ]
        },
        "central_bank": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "current_rate": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "last_decision": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "name",
                "current_rate",
                "last_decision"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "country_code",
        "name",
        "currency_code",
        "region",
        "central_bank"
      ],
      "additionalProperties": false
    },
    "key_stats": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "value": {
            "type": "number"
          },
          "category": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "value",
          "category"
        ],
        "additionalProperties": false
      }
    },
    "upcoming_events": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 2048,
            "format": "uri"
          },
          "date": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "actual": {
            "type": [
              "number",
              "null"
            ]
          },
          "forecast": {
            "type": [
              "number",
              "null"
            ]
          },
          "previous": {
            "type": [
              "number",
              "null"
            ]
          },
          "impact": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "url",
          "date",
          "name",
          "actual",
          "forecast",
          "previous",
          "impact",
          "category"
        ],
        "additionalProperties": false
      }
    },
    "recent_releases": {
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 2048,
            "format": "uri"
          },
          "date": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "actual": {
            "type": [
              "number",
              "null"
            ]
          },
          "forecast": {
            "type": [
              "number",
              "null"
            ]
          },
          "previous": {
            "type": [
              "number",
              "null"
            ]
          },
          "impact": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "url",
          "date",
          "name",
          "actual",
          "forecast",
          "previous",
          "impact",
          "category"
        ],
        "additionalProperties": false
      }
    },
    "coverage": {
      "type": "object",
      "properties": {
        "upcoming_events": {
          "type": "object",
          "properties": {
            "returned": {
              "type": "number"
            },
            "matched": {
              "type": "number"
            },
            "limit": {
              "type": "number"
            },
            "has_more": {
              "type": "boolean"
            },
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "returned",
            "matched",
            "limit",
            "has_more",
            "from",
            "to"
          ],
          "additionalProperties": false
        },
        "recent_releases": {
          "type": "object",
          "properties": {
            "returned": {
              "type": "number"
            },
            "matched": {
              "type": "number"
            },
            "limit": {
              "type": "number"
            },
            "has_more": {
              "type": "boolean"
            },
            "from": {
              "type": "string"
            },
            "to": {
              "type": "string"
            }
          },
          "required": [
            "returned",
            "matched",
            "limit",
            "has_more",
            "from",
            "to"
          ],
          "additionalProperties": false
        },
        "continuation_tool": {
          "type": "string",
          "const": "el7_calendar_events"
        }
      },
      "required": [
        "upcoming_events",
        "recent_releases",
        "continuation_tool"
      ],
      "additionalProperties": false
    },
    "freshness": {
      "type": "object",
      "properties": {
        "profile": {
          "type": "null"
        },
        "central_bank": {
          "type": "null"
        },
        "key_stats": {
          "type": "null"
        },
        "upcoming_events": {
          "type": [
            "string",
            "null"
          ]
        },
        "recent_releases": {
          "type": [
            "string",
            "null"
          ]
        },
        "unknown_components": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "profile",
        "central_bank",
        "key_stats",
        "upcoming_events",
        "recent_releases",
        "unknown_components"
      ],
      "additionalProperties": false
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "url",
    "source_url",
    "sources",
    "profile",
    "key_stats",
    "upcoming_events",
    "recent_releases",
    "coverage",
    "freshness"
  ],
  "additionalProperties": false
}

{
  "url": "https://el7.ai/ar/economic-calendar",
  "source_url": null,
  "sources": [
    {
      "kind": "el7",
      "scope": "calendar",
      "url": "https://el7.ai/ar/economic-calendar",
      "label": "example"
    }
  ],
  "profile": {
    "country_code": "example",
    "name": "example",
    "currency_code": "example",
    "region": "example",
    "central_bank": {
      "name": "example",
      "current_rate": 0,
      "last_decision": "example"
    }
  },
  "key_stats": [],
  "upcoming_events": [],
  "recent_releases": [],
  "coverage": {
    "upcoming_events": {
      "returned": 0,
      "matched": 0,
      "limit": 0,
      "has_more": false,
      "from": "example",
      "to": "example"
    },
    "recent_releases": {
      "returned": 0,
      "matched": 0,
      "limit": 0,
      "has_more": false,
      "from": "example",
      "to": "example"
    },
    "continuation_tool": "el7_calendar_events"
  },
  "freshness": {
    "profile": null,
    "central_bank": null,
    "key_stats": null,
    "upcoming_events": "example",
    "recent_releases": "example",
    "unknown_components": []
  }
}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

el7_cb_overview

Current policy rate(s), the last rate change, any decided-but-not-yet-effective change, the latest decision (tone score, vote split, dissenters, headline) and the next meeting dates for ONE central bank (fed, ecb, boe, boj, boc, rba, rbnz, snb). Start here for 'where is the <bank> policy rate' or 'when does the <bank> meet next'. Follow with el7_cb_decisions for history, el7_cb_documents / el7_cb_document for the statement text, el7_cb_tone_ranking to compare banks.

central_banks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "bank": {
      "type": "string",
      "enum": [
        "fed",
        "ecb",
        "boe",
        "boj",
        "boc",
        "rba",
        "rbnz",
        "snb"
      ],
      "description": "Central bank: fed, ecb, boe, boj, boc, rba, rbnz or snb."
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "bank"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "bank": {
      "type": "string"
    },
    "bank_name": {
      "type": "string"
    },
    "rates_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "policy_rates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "value": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "key",
          "label",
          "value"
        ],
        "additionalProperties": false
      }
    },
    "reference_rates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "value": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "key",
          "label",
          "value"
        ],
        "additionalProperties": false
      }
    },
    "last_change": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "date": {
              "type": "string"
            },
            "bps": {
              "type": [
                "number",
                "null"
              ]
            },
            "decision": {
              "type": "string"
            }
          },
          "required": [
            "date",
            "bps",
            "decision"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "pending_change": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "value": {
              "type": "number"
            },
            "effective_date": {
              "type": "string"
            },
            "direction": {
              "type": "string"
            }
          },
          "required": [
            "value",
            "effective_date",
            "direction"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "days_since_last_change": {
      "type": [
        "number",
        "null"
      ]
    },
    "latest_decision": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "meeting_date": {
              "type": "string"
            },
            "decision": {
              "type": "string"
            },
            "bps": {
              "type": [
                "number",
                "null"
              ]
            },
            "tone": {
              "type": [
                "string",
                "null"
              ]
            },
            "tone_score": {
              "type": [
                "number",
                "null"
              ]
            },
            "vote_for": {
              "type": [
                "number",
                "null"
              ]
            },
            "vote_against": {
              "type": [
                "number",
                "null"
              ]
            },
            "dissenters": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "headline": {
              "type": [
                "string",
                "null"
              ]
            },
            "headline_language": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "ar",
                    "en"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "url": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "meeting_date",
            "decision",
            "bps",
            "tone",
            "tone_score",
            "vote_for",
            "vote_against",
            "dissenters",
            "headline",
            "headline_language",
            "url"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "upcoming_meetings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "meeting_date": {
            "type": "string"
          },
          "days_until": {
            "type": [
              "number",
              "null"
            ]
          },
          "has_projections": {
            "type": "boolean"
          },
          "location": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "meeting_date",
          "days_until",
          "has_projections",
          "location"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "bank",
    "bank_name",
    "rates_date",
    "policy_rates",
    "reference_rates",
    "last_change",
    "pending_change",
    "days_since_last_change",
    "latest_decision",
    "upcoming_meetings",
    "url"
  ],
  "additionalProperties": false
}

{
  "bank": "example",
  "bank_name": "example",
  "rates_date": "2026-10-09T00:00:00.000Z",
  "policy_rates": [],
  "reference_rates": [],
  "last_change": {
    "date": "2026-10-09T00:00:00.000Z",
    "bps": 0,
    "decision": "example"
  },
  "pending_change": {
    "value": 0,
    "effective_date": "2026-10-09T00:00:00.000Z",
    "direction": "example"
  },
  "days_since_last_change": 0,
  "latest_decision": {
    "id": "example",
    "meeting_date": "2026-10-09T00:00:00.000Z",
    "decision": "example",
    "bps": 0,
    "tone": "example",
    "tone_score": 0,
    "vote_for": 0,
    "vote_against": 0,
    "dissenters": [],
    "headline": "example",
    "headline_language": "ar",
    "url": "https://el7.ai/ar/news"
  },
  "upcoming_meetings": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_cb_decisions

Rate-decision history for ONE central bank, newest first: decision (hike/cut/hold), size in bps, the policy rates after the meeting, tone score (hawkish/dovish), vote split and dissenters where the bank publishes them, which companion documents exist, and EL7's stored decision headline/summary (mostly Arabic). Use for 'what did the <bank> do at its last N meetings' or to spot a cycle. Pass from/to to window by meeting date (max 200 rows scanned). Follow with el7_cb_document (id) for the full statement and el7_cb_statement_diff to see what changed.

central_banks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "bank": {
      "type": "string",
      "enum": [
        "fed",
        "ecb",
        "boe",
        "boj",
        "boc",
        "rba",
        "rbnz",
        "snb"
      ],
      "description": "Central bank: fed, ecb, boe, boj, boc, rba, rbnz or snb."
    },
    "from": {
      "description": "Earliest meeting date (YYYY-MM-DD).",
      "type": "string"
    },
    "to": {
      "description": "Latest meeting date (YYYY-MM-DD).",
      "type": "string"
    },
    "limit": {
      "default": 12,
      "description": "Maximum decisions to return (default 12, max 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "bank"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "bank": {
      "type": "string"
    },
    "count": {
      "type": "number"
    },
    "decisions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "meeting_date": {
            "type": "string"
          },
          "decision": {
            "type": "string"
          },
          "bps": {
            "type": [
              "number",
              "null"
            ]
          },
          "rates": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": [
                "number",
                "null"
              ]
            }
          },
          "tone": {
            "type": [
              "string",
              "null"
            ]
          },
          "tone_score": {
            "type": [
              "number",
              "null"
            ]
          },
          "vote_for": {
            "type": [
              "number",
              "null"
            ]
          },
          "vote_against": {
            "type": [
              "number",
              "null"
            ]
          },
          "dissenters": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "has_press_conference": {
            "type": "boolean"
          },
          "has_projections": {
            "type": "boolean"
          },
          "has_minutes": {
            "type": "boolean"
          },
          "headline": {
            "type": [
              "string",
              "null"
            ]
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "summary_language": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "ar",
                  "en"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "key_points": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "meeting_date",
          "decision",
          "bps",
          "rates",
          "tone",
          "tone_score",
          "vote_for",
          "vote_against",
          "dissenters",
          "has_press_conference",
          "has_projections",
          "has_minutes",
          "headline",
          "summary",
          "summary_language",
          "key_points",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "bank",
    "count",
    "decisions"
  ],
  "additionalProperties": false
}

{
  "bank": "example",
  "count": 0,
  "decisions": []
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_cb_documents

List a central bank's published documents of one kind, newest first: decision statements, minutes/accounts, press-conference opening statements, speeches (and Fed testimony), or periodic reports. Each row has id, date, speaker/title, tone score and category, EL7's stored headline/summary (mostly Arabic, language tagged) and whether the English/Arabic full text is stored. Use to find a document id, then call el7_cb_document for its text. Not every bank has every kind (SNB has no minutes; only Fed/BoE/BoC/RBA/RBNZ have reports); an unsupported kind returns the kinds that exist.

central_banks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "bank": {
      "type": "string",
      "enum": [
        "fed",
        "ecb",
        "boe",
        "boj",
        "boc",
        "rba",
        "rbnz",
        "snb"
      ],
      "description": "Central bank: fed, ecb, boe, boj, boc, rba, rbnz or snb."
    },
    "kind": {
      "type": "string",
      "enum": [
        "statement",
        "minutes",
        "press_conference",
        "speech",
        "report"
      ],
      "description": "Document kind: statement (decision statement), minutes (minutes/accounts), press_conference, speech (incl. Fed testimony) or report (e.g. MPR/FSR/SoMP)."
    },
    "from": {
      "description": "Earliest document date (YYYY-MM-DD).",
      "type": "string"
    },
    "to": {
      "description": "Latest document date (YYYY-MM-DD).",
      "type": "string"
    },
    "speaker": {
      "description": "Optional case-insensitive speaker-name filter (speeches and press conferences).",
      "type": "string",
      "minLength": 2,
      "maxLength": 80
    },
    "limit": {
      "default": 15,
      "description": "Maximum documents (default 15, max 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "bank",
    "kind"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "bank": {
      "type": "string"
    },
    "kind": {
      "type": "string"
    },
    "count": {
      "type": "number"
    },
    "documents": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "sub_kind": {
            "type": "string"
          },
          "date": {
            "type": [
              "string",
              "null"
            ]
          },
          "released_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "speaker": {
            "type": [
              "string",
              "null"
            ]
          },
          "tone_score": {
            "type": [
              "number",
              "null"
            ]
          },
          "tone_category": {
            "type": [
              "string",
              "null"
            ]
          },
          "headline": {
            "type": [
              "string",
              "null"
            ]
          },
          "headline_language": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "ar",
                  "en"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "summary_language": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "ar",
                  "en"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "has_text_en": {
            "type": "boolean"
          },
          "has_text_ar": {
            "type": "boolean"
          },
          "source_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "sub_kind",
          "date",
          "released_at",
          "title",
          "speaker",
          "tone_score",
          "tone_category",
          "headline",
          "headline_language",
          "summary",
          "summary_language",
          "has_text_en",
          "has_text_ar",
          "source_url",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "bank",
    "kind",
    "count",
    "documents"
  ],
  "additionalProperties": false
}

{
  "bank": "example",
  "kind": "example",
  "count": 0,
  "documents": []
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_cb_document

One central bank document in full: the official English text (text_en) and EL7's stored Arabic translation (text_ar) where available, plus tone score/category, speaker, release time, source link and EL7's stored headline/summary (mostly Arabic). Pass the id from el7_cb_documents (or el7_cb_decisions), or a YYYY-MM-DD date for date-addressed documents. Long documents are cut at max_chars with text_truncated=true; raise max_chars (up to 120000) for minutes. Related: el7_cb_statement_diff compares a statement/minutes with the previous one; el7_cb_press_conference_qa returns the Q&A of a press conference.

central_banks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "bank": {
      "type": "string",
      "enum": [
        "fed",
        "ecb",
        "boe",
        "boj",
        "boc",
        "rba",
        "rbnz",
        "snb"
      ],
      "description": "Central bank: fed, ecb, boe, boj, boc, rba, rbnz or snb."
    },
    "kind": {
      "type": "string",
      "enum": [
        "statement",
        "minutes",
        "press_conference",
        "speech",
        "report"
      ],
      "description": "Document kind: statement (decision statement), minutes (minutes/accounts), press_conference, speech (incl. Fed testimony) or report (e.g. MPR/FSR/SoMP)."
    },
    "id": {
      "type": "string",
      "description": "Document id (uuid) from el7_cb_documents, or a YYYY-MM-DD meeting/release date."
    },
    "max_chars": {
      "default": 30000,
      "description": "Maximum characters of each text field (default 30000, max 120000).",
      "type": "integer",
      "minimum": 1000,
      "maximum": 120000
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "bank",
    "kind",
    "id"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "sub_kind": {
      "type": "string"
    },
    "date": {
      "type": [
        "string",
        "null"
      ]
    },
    "released_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "title": {
      "type": [
        "string",
        "null"
      ]
    },
    "speaker": {
      "type": [
        "string",
        "null"
      ]
    },
    "tone_score": {
      "type": [
        "number",
        "null"
      ]
    },
    "tone_category": {
      "type": [
        "string",
        "null"
      ]
    },
    "headline": {
      "type": [
        "string",
        "null"
      ]
    },
    "headline_language": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "ar",
            "en"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "summary": {
      "type": [
        "string",
        "null"
      ]
    },
    "summary_language": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "ar",
            "en"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "has_text_en": {
      "type": "boolean"
    },
    "has_text_ar": {
      "type": "boolean"
    },
    "source_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "url": {
      "type": "string"
    },
    "bank": {
      "type": "string"
    },
    "kind": {
      "type": "string"
    },
    "text_en": {
      "type": [
        "string",
        "null"
      ]
    },
    "text_ar": {
      "type": [
        "string",
        "null"
      ]
    },
    "text_chars_total_en": {
      "type": "number"
    },
    "text_chars_total_ar": {
      "type": "number"
    },
    "text_truncated": {
      "type": "boolean"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "id",
    "sub_kind",
    "date",
    "released_at",
    "title",
    "speaker",
    "tone_score",
    "tone_category",
    "headline",
    "headline_language",
    "summary",
    "summary_language",
    "has_text_en",
    "has_text_ar",
    "source_url",
    "url",
    "bank",
    "kind",
    "text_en",
    "text_ar",
    "text_chars_total_en",
    "text_chars_total_ar",
    "text_truncated"
  ],
  "additionalProperties": false
}

{
  "id": "example",
  "sub_kind": "example",
  "date": "2026-10-09T00:00:00.000Z",
  "released_at": "2026-10-09T00:00:00.000Z",
  "title": "example",
  "speaker": "example",
  "tone_score": 0,
  "tone_category": "example",
  "headline": "example",
  "headline_language": "ar",
  "summary": "example",
  "summary_language": "ar",
  "has_text_en": false,
  "has_text_ar": false,
  "source_url": null,
  "url": "https://el7.ai/ar/news",
  "bank": "example",
  "kind": "example",
  "text_en": "example",
  "text_ar": "example",
  "text_chars_total_en": 0,
  "text_chars_total_ar": 0,
  "text_truncated": false
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_cb_press_conference_qa

The journalist question-and-answer exchanges of one press conference, in order, with questioner, outlet, who answered, tone score and topic tags where stored. Pass the press-conference id (or its meeting date) from el7_cb_documents(kind=press_conference). Text is English, or EL7's Arabic translation when lang=ar and one is stored. Page with offset; each question/answer is cut at 4000 characters. Not every bank has Q&A stored (SNB has none).

central_banks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "bank": {
      "type": "string",
      "enum": [
        "fed",
        "ecb",
        "boe",
        "boj",
        "boc",
        "rba",
        "rbnz",
        "snb"
      ],
      "description": "Central bank: fed, ecb, boe, boj, boc, rba, rbnz or snb."
    },
    "id": {
      "type": "string",
      "description": "Document id (uuid) from el7_cb_documents, or a YYYY-MM-DD meeting/release date."
    },
    "limit": {
      "default": 15,
      "description": "Q&A items to return (default 15, max 30).",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    },
    "offset": {
      "default": 0,
      "description": "Items to skip, for paging.",
      "type": "integer",
      "minimum": 0,
      "maximum": 2000
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "bank",
    "id"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "bank": {
      "type": "string"
    },
    "meeting_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "total": {
      "type": "number"
    },
    "returned": {
      "type": "number"
    },
    "has_more": {
      "type": "boolean"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "number": {
            "type": [
              "number",
              "null"
            ]
          },
          "questioner": {
            "type": [
              "string",
              "null"
            ]
          },
          "outlet": {
            "type": [
              "string",
              "null"
            ]
          },
          "speaker": {
            "type": [
              "string",
              "null"
            ]
          },
          "question": {
            "type": [
              "string",
              "null"
            ]
          },
          "answer": {
            "type": [
              "string",
              "null"
            ]
          },
          "language": {
            "type": "string",
            "enum": [
              "ar",
              "en"
            ]
          },
          "tone_score": {
            "type": [
              "number",
              "null"
            ]
          },
          "tone_category": {
            "type": [
              "string",
              "null"
            ]
          },
          "topics": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "number",
          "questioner",
          "outlet",
          "speaker",
          "question",
          "answer",
          "language",
          "tone_score",
          "tone_category",
          "topics"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "bank",
    "meeting_date",
    "total",
    "returned",
    "has_more",
    "items",
    "url"
  ],
  "additionalProperties": false
}

{
  "bank": "example",
  "meeting_date": "2026-10-09T00:00:00.000Z",
  "total": 0,
  "returned": 0,
  "has_more": false,
  "items": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_cb_statement_diff

What changed between a central bank statement (or minutes) and the one before it: sentences added and removed (capped at 30 each, with totals), the share of text changed, the tone-score delta and hawkish/dovish shift, and for the Fed and ECB statements the stored word-level comparison. Defaults to the latest document; pass meeting_date to diff the document on or before that date against its predecessor. Computed from stored text on request (deterministic, no AI). Use after el7_cb_decisions to explain a tone shift.

central_banks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "bank": {
      "type": "string",
      "enum": [
        "fed",
        "ecb",
        "boe",
        "boj",
        "boc",
        "rba",
        "rbnz",
        "snb"
      ],
      "description": "Central bank: fed, ecb, boe, boj, boc, rba, rbnz or snb."
    },
    "kind": {
      "default": "statement",
      "description": "Document kind to compare (default statement).",
      "type": "string",
      "enum": [
        "statement",
        "minutes"
      ]
    },
    "meeting_date": {
      "description": "Meeting date of the current document; default the latest (YYYY-MM-DD).",
      "type": "string"
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "bank"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "bank": {
      "type": "string"
    },
    "kind": {
      "type": "string"
    },
    "current": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "date": {
          "type": [
            "string",
            "null"
          ]
        },
        "tone_score": {
          "type": [
            "number",
            "null"
          ]
        },
        "tone_category": {
          "type": [
            "string",
            "null"
          ]
        },
        "words": {
          "type": "number"
        },
        "url": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "date",
        "tone_score",
        "tone_category",
        "words",
        "url"
      ],
      "additionalProperties": false
    },
    "previous": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "date": {
          "type": [
            "string",
            "null"
          ]
        },
        "tone_score": {
          "type": [
            "number",
            "null"
          ]
        },
        "tone_category": {
          "type": [
            "string",
            "null"
          ]
        },
        "words": {
          "type": "number"
        },
        "url": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "date",
        "tone_score",
        "tone_category",
        "words",
        "url"
      ],
      "additionalProperties": false
    },
    "language": {
      "type": "string",
      "enum": [
        "ar",
        "en"
      ]
    },
    "tone_delta": {
      "type": [
        "number",
        "null"
      ]
    },
    "tone_shift": {
      "type": "string",
      "enum": [
        "hawkish",
        "dovish",
        "unchanged",
        "unknown"
      ]
    },
    "sentences_added": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sentences_removed": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sentences_added_total": {
      "type": "number"
    },
    "sentences_removed_total": {
      "type": "number"
    },
    "sentences_unchanged": {
      "type": "number"
    },
    "change_pct": {
      "type": "number"
    },
    "stored_comparison": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "added_words": {
              "type": [
                "number",
                "null"
              ]
            },
            "removed_words": {
              "type": [
                "number",
                "null"
              ]
            },
            "unchanged_words": {
              "type": [
                "number",
                "null"
              ]
            },
            "tone_score_delta": {
              "type": [
                "number",
                "null"
              ]
            },
            "category_changed": {
              "type": [
                "boolean",
                "null"
              ]
            }
          },
          "required": [
            "added_words",
            "removed_words",
            "unchanged_words",
            "tone_score_delta",
            "category_changed"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "bank",
    "kind",
    "current",
    "previous",
    "language",
    "tone_delta",
    "tone_shift",
    "sentences_added",
    "sentences_removed",
    "sentences_added_total",
    "sentences_removed_total",
    "sentences_unchanged",
    "change_pct",
    "stored_comparison"
  ],
  "additionalProperties": false
}

{
  "bank": "example",
  "kind": "example",
  "current": {
    "id": "example",
    "date": "2026-10-09T00:00:00.000Z",
    "tone_score": 0,
    "tone_category": "example",
    "words": 0,
    "url": "https://el7.ai/ar/news"
  },
  "previous": {
    "id": "example",
    "date": "2026-10-09T00:00:00.000Z",
    "tone_score": 0,
    "tone_category": "example",
    "words": 0,
    "url": "https://el7.ai/ar/news"
  },
  "language": "ar",
  "tone_delta": 0,
  "tone_shift": "hawkish",
  "sentences_added": [],
  "sentences_removed": [],
  "sentences_added_total": 0,
  "sentences_removed_total": 0,
  "sentences_unchanged": 0,
  "change_pct": 0,
  "stored_comparison": {
    "added_words": 0,
    "removed_words": 0,
    "unchanged_words": 0,
    "tone_score_delta": 0,
    "category_changed": false
  }
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_cb_tone_ranking

Ranks all eight central banks from most hawkish to most dovish by the tone score of their latest published decision statement, with the previous meeting's score and the change. Use to compare policy stance across banks or to see which bank turned more hawkish/dovish. Scores come from EL7's stored statement tone analysis (higher = more hawkish). Follow with el7_cb_statement_diff or el7_cb_overview for one bank.

central_banks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ranking": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "number"
          },
          "bank": {
            "type": "string"
          },
          "bank_name": {
            "type": "string"
          },
          "meeting_date": {
            "type": "string"
          },
          "tone_score": {
            "type": "number"
          },
          "tone_category": {
            "type": [
              "string",
              "null"
            ]
          },
          "previous_meeting_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "previous_tone_score": {
            "type": [
              "number",
              "null"
            ]
          },
          "tone_delta": {
            "type": [
              "number",
              "null"
            ]
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "rank",
          "bank",
          "bank_name",
          "meeting_date",
          "tone_score",
          "tone_category",
          "previous_meeting_date",
          "previous_tone_score",
          "tone_delta",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "note": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "ranking",
    "note"
  ],
  "additionalProperties": false
}

{
  "ranking": [],
  "note": "example"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_cb_previews

EL7's pre-meeting preview briefs for the Fed (FOMC), ECB, BoE, BoJ, BoC, RBA and RBNZ. Without slot_date it lists stored previews for the bank, newest first, flagging which are current (created within 45 days, the same freshness rule as the website). With slot_date (YYYY-MM-DD from the list, or 'latest' for the current one) it returns the full brief: rate expectation with confidence, the sections (executive summary, forecast, press-conference preview ...), scenarios and EL7's verdict. Briefs are written in Arabic. An empty list or a null article means no fresh preview exists; do not substitute an old one as current.

central_banks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "bank": {
      "type": "string",
      "enum": [
        "fed",
        "ecb",
        "boe",
        "boj",
        "boc",
        "rba",
        "rbnz"
      ],
      "description": "Bank whose preview to read: fed (FOMC), ecb, boe, boj, boc, rba or rbnz."
    },
    "slot_date": {
      "description": "Meeting date of the preview (YYYY-MM-DD) or 'latest'. Omit to list.",
      "type": "string"
    },
    "limit": {
      "default": 8,
      "description": "Maximum previews when listing (default 8, max 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "bank"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "bank": {
      "type": "string"
    },
    "mode": {
      "type": "string",
      "enum": [
        "list",
        "article"
      ]
    },
    "previews": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "bank": {
            "type": "string"
          },
          "meeting_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "slot_key": {
            "type": "string"
          },
          "created_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "is_current": {
            "type": "boolean"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "bank",
          "meeting_date",
          "slot_key",
          "created_at",
          "is_current",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "article": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "meeting_date": {
              "type": [
                "string",
                "null"
              ]
            },
            "created_at": {
              "type": [
                "string",
                "null"
              ]
            },
            "is_current": {
              "type": "boolean"
            },
            "title": {
              "type": [
                "string",
                "null"
              ]
            },
            "title_language": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "ar",
                    "en"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "rate_expectation": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "decision": {
                      "type": "string"
                    },
                    "confidence": {
                      "type": [
                        "number",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "decision",
                    "confidence"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "sections": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "title": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "content": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "title",
                  "content"
                ],
                "additionalProperties": false
              }
            },
            "scenarios": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "probability": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "description": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "name",
                  "probability",
                  "description"
                ],
                "additionalProperties": false
              }
            },
            "verdict": {
              "type": [
                "string",
                "null"
              ]
            },
            "content_language": {
              "type": "string",
              "const": "ar"
            },
            "word_count": {
              "type": [
                "number",
                "null"
              ]
            },
            "url": {
              "type": "string"
            }
          },
          "required": [
            "meeting_date",
            "created_at",
            "is_current",
            "title",
            "title_language",
            "rate_expectation",
            "sections",
            "scenarios",
            "verdict",
            "content_language",
            "word_count",
            "url"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "bank",
    "mode",
    "previews",
    "article"
  ],
  "additionalProperties": false
}

{
  "bank": "example",
  "mode": "list",
  "previews": [],
  "article": {
    "meeting_date": "2026-10-09T00:00:00.000Z",
    "created_at": "2026-10-09T00:00:00.000Z",
    "is_current": false,
    "title": "example",
    "title_language": "ar",
    "rate_expectation": {
      "decision": "example",
      "confidence": 0
    },
    "sections": [],
    "scenarios": [],
    "verdict": "example",
    "content_language": "ar",
    "word_count": 0,
    "url": "https://el7.ai/ar/news"
  }
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_cb_sep

The Fed's Summary of Economic Projections for one FOMC meeting (default the latest): median, central-tendency and range projections for fed funds rate, GDP, unemployment, PCE and core PCE by year (year 'longer_run' = long-run), and the dot plot (how many participants sit at each rate level per year). Use for the Fed's projected rate path. Also lists recent meetings with a stored SEP. Pair with el7_cb_overview (current rate) and el7_cb_documents(kind=statement).

central_banks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "meeting_date": {
      "description": "FOMC meeting date with an SEP; default the latest (YYYY-MM-DD).",
      "type": "string"
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "meeting_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "participant_count": {
      "type": [
        "number",
        "null"
      ]
    },
    "available_meetings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "projections": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "variable": {
            "type": "string"
          },
          "year": {
            "type": "string"
          },
          "median": {
            "type": [
              "number",
              "null"
            ]
          },
          "central_tendency_low": {
            "type": [
              "number",
              "null"
            ]
          },
          "central_tendency_high": {
            "type": [
              "number",
              "null"
            ]
          },
          "range_low": {
            "type": [
              "number",
              "null"
            ]
          },
          "range_high": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "variable",
          "year",
          "median",
          "central_tendency_low",
          "central_tendency_high",
          "range_low",
          "range_high"
        ],
        "additionalProperties": false
      }
    },
    "dot_plot": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "year": {
            "type": "string"
          },
          "rate_level": {
            "type": [
              "number",
              "null"
            ]
          },
          "participants": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "year",
          "rate_level",
          "participants"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "meeting_date",
    "participant_count",
    "available_meetings",
    "projections",
    "dot_plot",
    "url"
  ],
  "additionalProperties": false
}

{
  "meeting_date": "2026-10-09T00:00:00.000Z",
  "participant_count": 0,
  "available_meetings": [],
  "projections": [],
  "dot_plot": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_cb_beige_book

The Fed's Beige Book as stored by EL7. Without report_date it lists recent editions with tone score and headline. With report_date (YYYY-MM-DD from the list) it returns that edition: the national summary, EL7's summary, tone score with theme breakdown (inflation, employment, growth, consumer, manufacturing, real estate) and the twelve district summaries. Use for the Fed's anecdotal read on the economy ahead of an FOMC meeting.

central_banks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "report_date": {
      "description": "Beige Book release date; omit to list editions (YYYY-MM-DD).",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "description": "Editions to list (default 10, max 30).",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "list",
        "report"
      ]
    },
    "reports": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "report_date": {
            "type": "string"
          },
          "fomc_meeting_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "tone_score": {
            "type": [
              "number",
              "null"
            ]
          },
          "tone_category": {
            "type": [
              "string",
              "null"
            ]
          },
          "headline": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "report_date",
          "fomc_meeting_date",
          "tone_score",
          "tone_category",
          "headline",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "report": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "report_date": {
              "type": "string"
            },
            "fomc_meeting_date": {
              "type": [
                "string",
                "null"
              ]
            },
            "tone_score": {
              "type": [
                "number",
                "null"
              ]
            },
            "tone_category": {
              "type": [
                "string",
                "null"
              ]
            },
            "tone_by_theme": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "headline": {
              "type": [
                "string",
                "null"
              ]
            },
            "summary": {
              "type": [
                "string",
                "null"
              ]
            },
            "national_summary": {
              "type": [
                "string",
                "null"
              ]
            },
            "language": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "ar",
                    "en"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "source_url": {
              "type": [
                "string",
                "null"
              ]
            },
            "districts": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "number": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "name": {
                    "type": "string"
                  },
                  "summary": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "tone_score": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "tone_category": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "number",
                  "name",
                  "summary",
                  "tone_score",
                  "tone_category"
                ],
                "additionalProperties": false
              }
            },
            "url": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "report_date",
            "fomc_meeting_date",
            "tone_score",
            "tone_category",
            "tone_by_theme",
            "headline",
            "summary",
            "national_summary",
            "language",
            "source_url",
            "districts",
            "url"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "mode",
    "reports",
    "report"
  ],
  "additionalProperties": false
}

{
  "mode": "list",
  "reports": [],
  "report": {
    "id": "example",
    "report_date": "2026-10-09T00:00:00.000Z",
    "fomc_meeting_date": "2026-10-09T00:00:00.000Z",
    "tone_score": 0,
    "tone_category": "example",
    "tone_by_theme": {},
    "headline": "example",
    "summary": "example",
    "national_summary": "example",
    "language": "ar",
    "source_url": null,
    "districts": [],
    "url": "https://el7.ai/ar/news"
  }
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_cb_balance_sheet

Central bank balance sheet data. Fed: each weekly series (Treasuries, MBS, reserves, reverse repo, TGA ...) with latest level, previous value and change; pass series_id and weeks for its recent history. ECB, BoE and BoJ: the same series shape from stored data (series can be empty if nothing is stored yet). SNB, BoC, RBA and RBNZ: recent release snapshots of total assets and main components (SNB also weekly sight deposits). Use for QT/QE and liquidity questions; pair with el7_cb_overview.

central_banks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "bank": {
      "type": "string",
      "enum": [
        "fed",
        "ecb",
        "boe",
        "boj",
        "boc",
        "rba",
        "rbnz",
        "snb"
      ],
      "description": "Central bank: fed, ecb, boe, boj, boc, rba, rbnz or snb."
    },
    "series_id": {
      "description": "Fed, ECB, BoE, BoJ: series id for a history window (e.g. WALCL); call without it to list series ids.",
      "type": "string",
      "pattern": "^[A-Za-z0-9_.]{2,40}$"
    },
    "weeks": {
      "default": 26,
      "description": "History points, or snapshot rows for other banks (default 26, max 260).",
      "type": "integer",
      "minimum": 1,
      "maximum": 260
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "bank"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "bank": {
      "type": "string"
    },
    "series": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "series_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "units": {
            "type": [
              "string",
              "null"
            ]
          },
          "frequency": {
            "type": [
              "string",
              "null"
            ]
          },
          "latest_date": {
            "type": "string"
          },
          "latest_value": {
            "type": [
              "number",
              "null"
            ]
          },
          "previous_value": {
            "type": [
              "number",
              "null"
            ]
          },
          "change": {
            "type": [
              "number",
              "null"
            ]
          },
          "change_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "history": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string"
                },
                "value": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "date",
                "value"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "series_id",
          "name",
          "category",
          "units",
          "frequency",
          "latest_date",
          "latest_value",
          "previous_value",
          "change",
          "change_pct",
          "history"
        ],
        "additionalProperties": false
      }
    },
    "snapshots": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "release_date": {
            "type": "string"
          },
          "values": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": [
                "number",
                "null"
              ]
            }
          }
        },
        "required": [
          "release_date",
          "values"
        ],
        "additionalProperties": false
      }
    },
    "sight_deposits": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "release_date": {
            "type": "string"
          },
          "total_chf": {
            "type": [
              "number",
              "null"
            ]
          },
          "domestic_chf": {
            "type": [
              "number",
              "null"
            ]
          },
          "foreign_chf": {
            "type": [
              "number",
              "null"
            ]
          },
          "week_over_week_change_chf": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "release_date",
          "total_chf",
          "domestic_chf",
          "foreign_chf",
          "week_over_week_change_chf"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "bank",
    "series",
    "snapshots",
    "sight_deposits",
    "url"
  ],
  "additionalProperties": false
}

{
  "bank": "example",
  "series": [],
  "snapshots": [],
  "sight_deposits": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_people_search

Find people EL7 tracks (central bank governors and committee members, officials, politicians ...) by name and/or institution, with current role, voter status and the hawk/dove score (higher = more hawkish) where one exists. Use to resolve a name to a slug, to list a bank's board (institution=fed) or to browse by type. Follow with el7_person (slug) for the full profile, speeches, votes and score history; el7_people_cb_members for a whole bank's roster with averages.

people · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "query": {
      "description": "Name search (English or Arabic, partial match). Omit to browse by filters.",
      "type": "string",
      "minLength": 2,
      "maxLength": 80
    },
    "institution": {
      "description": "Institution code filter, e.g. fed, ecb, boe, boj.",
      "type": "string",
      "pattern": "^[a-z0-9_]{2,20}$"
    },
    "person_type": {
      "description": "Filter by person type, e.g. central_banker or politician.",
      "type": "string",
      "enum": [
        "central_banker",
        "government_official",
        "corporate_leader",
        "fund_manager",
        "journalist",
        "economist",
        "politician",
        "other"
      ]
    },
    "active_only": {
      "default": true,
      "description": "Only people with an active role (default true).",
      "type": "boolean"
    },
    "limit": {
      "default": 15,
      "description": "Maximum people (default 15, max 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "default": 0,
      "description": "People to skip, for paging.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "count": {
      "type": "number"
    },
    "has_more": {
      "type": "boolean"
    },
    "people": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "short_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "person_type": {
            "type": "string"
          },
          "institution": {
            "type": [
              "string",
              "null"
            ]
          },
          "institution_code": {
            "type": [
              "string",
              "null"
            ]
          },
          "role_title": {
            "type": [
              "string",
              "null"
            ]
          },
          "role_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "is_voter": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "district": {
            "type": [
              "string",
              "null"
            ]
          },
          "is_active": {
            "type": "boolean"
          },
          "nationality": {
            "type": [
              "string",
              "null"
            ]
          },
          "hawk_dove_score": {
            "type": [
              "number",
              "null"
            ]
          },
          "hawk_dove_category": {
            "type": [
              "string",
              "null"
            ]
          },
          "score_updated_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "name",
          "short_name",
          "person_type",
          "institution",
          "institution_code",
          "role_title",
          "role_type",
          "is_voter",
          "district",
          "is_active",
          "nationality",
          "hawk_dove_score",
          "hawk_dove_category",
          "score_updated_at",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "count",
    "has_more",
    "people"
  ],
  "additionalProperties": false
}

{
  "count": 0,
  "has_more": false,
  "people": []
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_person

One person's full EL7 profile: bio, career roles, current role and voter status, the hawk/dove score with its history over the last N months (speech- and vote-based, higher = more hawkish), recent speeches (with the bank and id to open via el7_cb_document kind=speech), recorded policy votes, and recent news mentions. Use after el7_people_search resolved a slug, e.g. to judge how a committee member's stance has moved before a meeting.

people · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "slug": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{1,120}$",
      "description": "Person slug from el7_people_search (e.g. jerome-powell)."
    },
    "months": {
      "default": 6,
      "description": "Months of hawk/dove score history (default 6, max 36).",
      "type": "integer",
      "minimum": 1,
      "maximum": 36
    },
    "limit": {
      "default": 10,
      "description": "Maximum speeches, votes and news mentions each (default 10, max 30).",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "short_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "person_type": {
      "type": "string"
    },
    "bio": {
      "type": [
        "string",
        "null"
      ]
    },
    "nationality": {
      "type": [
        "string",
        "null"
      ]
    },
    "is_active": {
      "type": "boolean"
    },
    "photo_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "current_role": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "institution": {
              "type": [
                "string",
                "null"
              ]
            },
            "institution_code": {
              "type": [
                "string",
                "null"
              ]
            },
            "title": {
              "type": [
                "string",
                "null"
              ]
            },
            "role_type": {
              "type": [
                "string",
                "null"
              ]
            },
            "is_voter": {
              "type": [
                "boolean",
                "null"
              ]
            },
            "since": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "institution",
            "institution_code",
            "title",
            "role_type",
            "is_voter",
            "since"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "hawk_dove_score": {
      "type": [
        "number",
        "null"
      ]
    },
    "hawk_dove_category": {
      "type": [
        "string",
        "null"
      ]
    },
    "hawk_dove_history": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "scored_at": {
            "type": "string"
          },
          "score": {
            "type": [
              "number",
              "null"
            ]
          },
          "source_type": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "scored_at",
          "score",
          "source_type"
        ],
        "additionalProperties": false
      }
    },
    "roles": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "institution": {
            "type": [
              "string",
              "null"
            ]
          },
          "institution_code": {
            "type": [
              "string",
              "null"
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "role_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "start_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "end_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "is_primary": {
            "type": "boolean"
          },
          "is_voter": {
            "type": [
              "boolean",
              "null"
            ]
          }
        },
        "required": [
          "institution",
          "institution_code",
          "title",
          "role_type",
          "start_date",
          "end_date",
          "is_primary",
          "is_voter"
        ],
        "additionalProperties": false
      }
    },
    "speeches": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "bank": {
            "type": "string"
          },
          "date": {
            "type": [
              "string",
              "null"
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "bank",
          "date",
          "title",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "speech_count": {
      "type": "number"
    },
    "votes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "bank": {
            "type": "string"
          },
          "meeting_date": {
            "type": "string"
          },
          "vote": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "bank",
          "meeting_date",
          "vote",
          "description"
        ],
        "additionalProperties": false
      }
    },
    "news_mentions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "story_id": {
            "type": "string"
          },
          "mention_type": {
            "type": "string"
          },
          "headline": {
            "type": [
              "string",
              "null"
            ]
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "sentiment": {
            "type": [
              "string",
              "null"
            ]
          },
          "first_published_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "story_id",
          "mention_type",
          "headline",
          "category",
          "sentiment",
          "first_published_at",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "slug",
    "name",
    "short_name",
    "person_type",
    "bio",
    "nationality",
    "is_active",
    "photo_url",
    "current_role",
    "hawk_dove_score",
    "hawk_dove_category",
    "hawk_dove_history",
    "roles",
    "speeches",
    "speech_count",
    "votes",
    "news_mentions",
    "url"
  ],
  "additionalProperties": false
}

{
  "slug": "example",
  "name": "example",
  "short_name": "example",
  "person_type": "example",
  "bio": "example",
  "nationality": "example",
  "is_active": false,
  "photo_url": "https://el7.ai/ar/news",
  "current_role": {
    "institution": "example",
    "institution_code": "example",
    "title": "example",
    "role_type": "example",
    "is_voter": false,
    "since": "example"
  },
  "hawk_dove_score": 0,
  "hawk_dove_category": "example",
  "hawk_dove_history": [],
  "roles": [],
  "speeches": [],
  "speech_count": 0,
  "votes": [],
  "news_mentions": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_people_cb_members

The active policy-setting members of each central bank (or one bank) with role, voter status, hawk/dove score (higher = more hawkish), speech count and latest speech date, plus each bank's average score. Mirrors the central-banks members page. Use for 'who is the most hawkish on the FOMC' or 'who votes this year'. Follow with el7_person (slug) for one member's history.

people · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "bank": {
      "description": "One bank (fed, ecb, boe, boj, boc, rba, rbnz, snb). Omit for every bank.",
      "type": "string",
      "enum": [
        "fed",
        "ecb",
        "boe",
        "boj",
        "boc",
        "rba",
        "rbnz",
        "snb"
      ]
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "banks": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "bank": {
            "type": "string"
          },
          "member_count": {
            "type": "number"
          },
          "average_hawk_dove": {
            "type": [
              "number",
              "null"
            ]
          },
          "members": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "slug": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "short_name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "person_type": {
                  "type": "string"
                },
                "institution": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "institution_code": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "role_title": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "role_type": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "is_voter": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "district": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "is_active": {
                  "type": "boolean"
                },
                "nationality": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "hawk_dove_score": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "hawk_dove_category": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "score_updated_at": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "url": {
                  "type": "string"
                },
                "speech_count": {
                  "type": "number"
                },
                "latest_speech_date": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "slug",
                "name",
                "short_name",
                "person_type",
                "institution",
                "institution_code",
                "role_title",
                "role_type",
                "is_voter",
                "district",
                "is_active",
                "nationality",
                "hawk_dove_score",
                "hawk_dove_category",
                "score_updated_at",
                "url",
                "speech_count",
                "latest_speech_date"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "bank",
          "member_count",
          "average_hawk_dove",
          "members"
        ],
        "additionalProperties": false
      }
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "banks"
  ],
  "additionalProperties": false
}

{
  "banks": []
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_cot_markets

Lists the CFTC Commitments of Traders markets EL7 tracks (about 100 futures contracts across currencies, indices, rates, crypto, energy, metals, grains, softs), each with its CFTC code, symbol, category, the 0-100 COT index (the website heatmap value), an EL7 conviction score and the latest speculator positioning statistics (net position, z-score, percentile, positioning category, 4w/13w averages). Use it to find the cftc_code for a market, or set sort_by (cot_index, conviction, z_score, percentile, wow_change) with limit up to 120 to build the heatmap, the conviction leaderboard or the most crowded/least crowded lists. Next: call el7_cot_positioning for the full trader-group breakdown and history, el7_cot_market_detail for concentration/participation/options/bank structure, el7_cot_analysis for EL7's written analysis, or el7_cot_weekly for the week's biggest moves.

cot · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "category": {
      "description": "Filter by market category (currencies, indices, rates, crypto, energy, metals, grains, softs, wood).",
      "type": "string",
      "enum": [
        "currencies",
        "indices",
        "rates",
        "crypto",
        "energy",
        "metals",
        "grains",
        "softs",
        "wood"
      ]
    },
    "report_type": {
      "description": "Filter by CFTC report type: tff (financial futures) or disaggregated (commodities).",
      "type": "string",
      "enum": [
        "tff",
        "disaggregated"
      ]
    },
    "search": {
      "description": "Case-insensitive text match on market name (English/Arabic), symbol or CFTC code, e.g. 'gold', 'EUR', '088691'.",
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "sort_by": {
      "default": "default",
      "description": "Ranking: default (category, symbol), cot_index (0-100 positioning index, the website heatmap), conviction (EL7 conviction score 0-100), z_score (1y z-score), percentile, wow_change. Non-default sorts rank across all matching markets before the limit.",
      "type": "string",
      "enum": [
        "default",
        "cot_index",
        "conviction",
        "z_score",
        "percentile",
        "wow_change"
      ]
    },
    "sort_order": {
      "default": "desc",
      "description": "Direction for sort_by (default desc: highest first). Ignored for sort_by=default.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "default": 20,
      "description": "Maximum markets to return (1-120, default 20). Use 120 with sort_by to get the full heatmap or leaderboard.",
      "type": "integer",
      "minimum": 1,
      "maximum": 120
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "total_matching": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "returned": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "items": {
      "maxItems": 120,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cftc_code": {
            "type": "string"
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "report_type": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "exchange": {
            "type": [
              "string",
              "null"
            ]
          },
          "latest_report_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "speculator_group": {
            "type": [
              "string",
              "null"
            ]
          },
          "cot_index": {
            "type": [
              "number",
              "null"
            ]
          },
          "cot_index_category": {
            "type": [
              "string",
              "null"
            ]
          },
          "conviction": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "score": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "grade": {
                    "type": "string",
                    "enum": [
                      "high",
                      "medium",
                      "low"
                    ]
                  }
                },
                "required": [
                  "score",
                  "grade"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "stats": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "net_spec_position": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "net_spec_pct_oi": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "z_score_1y": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "z_score_3y": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "positioning_percentile": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "positioning_category": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "trend_direction": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "momentum_class": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "wow_change": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "net_spec_4w_avg": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "net_spec_13w_avg": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "net_spec_position",
                  "net_spec_pct_oi",
                  "z_score_1y",
                  "z_score_3y",
                  "positioning_percentile",
                  "positioning_category",
                  "trend_direction",
                  "momentum_class",
                  "wow_change",
                  "net_spec_4w_avg",
                  "net_spec_13w_avg"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "cftc_code",
          "symbol",
          "name",
          "category",
          "report_type",
          "url",
          "exchange",
          "latest_report_date",
          "speculator_group",
          "cot_index",
          "cot_index_category",
          "conviction",
          "stats"
        ],
        "additionalProperties": false
      }
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "total_matching",
    "returned",
    "items"
  ],
  "additionalProperties": false
}

{
  "total_matching": 0,
  "returned": 0,
  "items": []
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_cot_positioning

Returns one market's Commitments of Traders positioning: the latest week's long/short/net by trader group (e.g. leveraged funds, asset managers, dealers for financials; managed money, swap dealers, producers for commodities), week-over-week change, the 0-100 COT index, speculator z-scores (1y/3y), percentile, positioning category, momentum and 4w/13w net averages, plus a weekly history (up to 10 years) of net positions with the same index/z-score/percentile per week. lens=combined switches the group positions to futures+options. Use it to judge how crowded or stretched a market is and to chart it. Get the code from el7_cot_markets; for concentration, trader counts, options leg, bank participation and cohorts use el7_cot_market_detail; for the week's cross-market moves use el7_cot_weekly. Data is the CFTC release (positions as of Tuesday), not a price feed.

cot · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "market": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "description": "CFTC contract code (e.g. '088691' for gold), symbol (e.g. 'GC', 'EUR') or exact market name (e.g. 'Gold'). Find codes with el7_cot_markets."
    },
    "weeks": {
      "default": 12,
      "description": "Weekly reports of history to return (1-520 = 10 years, default 12). Series above roughly 300 weeks are thinned to every 2nd/3rd week to fit the response limit; history_every_n_weeks says by how much.",
      "type": "integer",
      "minimum": 1,
      "maximum": 520
    },
    "lens": {
      "default": "futures",
      "description": "futures = futures-only (default, has z-score/index per week); combined = futures + options positions per trader group (disaggregated and TFF markets only; z-score/index history is not computed for combined).",
      "type": "string",
      "enum": [
        "futures",
        "combined"
      ]
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "market"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "market": {
      "type": "object",
      "properties": {
        "cftc_code": {
          "type": "string"
        },
        "symbol": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "type": "string"
        },
        "category": {
          "type": [
            "string",
            "null"
          ]
        },
        "report_type": {
          "type": "string"
        },
        "url": {
          "type": "string",
          "format": "uri"
        },
        "exchange": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "cftc_code",
        "symbol",
        "name",
        "category",
        "report_type",
        "url",
        "exchange"
      ],
      "additionalProperties": false
    },
    "basis": {
      "type": "string",
      "enum": [
        "tff",
        "disaggregated",
        "legacy"
      ]
    },
    "stats_basis": {
      "type": "string",
      "enum": [
        "tff",
        "disaggregated",
        "legacy"
      ]
    },
    "speculator_group": {
      "type": "string"
    },
    "lens": {
      "type": "string",
      "enum": [
        "futures",
        "combined"
      ]
    },
    "lens_note": {
      "type": [
        "string",
        "null"
      ]
    },
    "stats_lens": {
      "type": "string",
      "const": "futures"
    },
    "latest": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "report_date": {
              "type": "string"
            },
            "open_interest": {
              "type": [
                "number",
                "null"
              ]
            },
            "cot_index": {
              "type": [
                "number",
                "null"
              ]
            },
            "cot_index_category": {
              "type": [
                "string",
                "null"
              ]
            },
            "groups": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "group": {
                    "type": "string"
                  },
                  "label": {
                    "type": "string"
                  },
                  "long": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "short": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "net": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "net_change_wow": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "group",
                  "label",
                  "long",
                  "short",
                  "net",
                  "net_change_wow"
                ],
                "additionalProperties": false
              }
            },
            "stats": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "net_spec_position": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "net_spec_pct_oi": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "z_score_1y": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "z_score_3y": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "positioning_percentile": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "positioning_category": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "trend_direction": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "momentum_class": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "wow_change": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "net_spec_4w_avg": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "net_spec_13w_avg": {
                      "type": [
                        "number",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "net_spec_position",
                    "net_spec_pct_oi",
                    "z_score_1y",
                    "z_score_3y",
                    "positioning_percentile",
                    "positioning_category",
                    "trend_direction",
                    "momentum_class",
                    "wow_change",
                    "net_spec_4w_avg",
                    "net_spec_13w_avg"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "report_date",
            "open_interest",
            "cot_index",
            "cot_index_category",
            "groups",
            "stats"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "history": {
      "maxItems": 520,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "report_date": {
            "type": "string"
          },
          "open_interest": {
            "type": [
              "number",
              "null"
            ]
          },
          "net": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": [
                "number",
                "null"
              ]
            }
          },
          "z_score_1y": {
            "type": [
              "number",
              "null"
            ]
          },
          "positioning_percentile": {
            "type": [
              "number",
              "null"
            ]
          },
          "positioning_category": {
            "type": [
              "string",
              "null"
            ]
          },
          "cot_index": {
            "type": [
              "number",
              "null"
            ]
          },
          "net_spec_4w_avg": {
            "type": [
              "number",
              "null"
            ]
          },
          "net_spec_13w_avg": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "report_date",
          "open_interest",
          "net",
          "z_score_1y",
          "positioning_percentile",
          "positioning_category",
          "cot_index",
          "net_spec_4w_avg",
          "net_spec_13w_avg"
        ],
        "additionalProperties": false
      }
    },
    "history_every_n_weeks": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "index_traders": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "report_date": {
              "type": "string"
            },
            "long": {
              "type": [
                "number",
                "null"
              ]
            },
            "short": {
              "type": [
                "number",
                "null"
              ]
            },
            "net": {
              "type": [
                "number",
                "null"
              ]
            }
          },
          "required": [
            "report_date",
            "long",
            "short",
            "net"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "market",
    "basis",
    "stats_basis",
    "speculator_group",
    "lens",
    "lens_note",
    "stats_lens",
    "latest",
    "history",
    "history_every_n_weeks",
    "index_traders",
    "url"
  ],
  "additionalProperties": false
}

{
  "market": {
    "cftc_code": "example",
    "symbol": "example",
    "name": "example",
    "category": "example",
    "report_type": "example",
    "url": "https://el7.ai/ar/news",
    "exchange": "example"
  },
  "basis": "tff",
  "stats_basis": "tff",
  "speculator_group": "example",
  "lens": "futures",
  "lens_note": "example",
  "stats_lens": "futures",
  "latest": {
    "report_date": "2026-10-09T00:00:00.000Z",
    "open_interest": 0,
    "cot_index": 0,
    "cot_index_category": "example",
    "groups": [],
    "stats": {
      "net_spec_position": 0,
      "net_spec_pct_oi": 0,
      "z_score_1y": 0,
      "z_score_3y": 0,
      "positioning_percentile": 0,
      "positioning_category": "example",
      "trend_direction": "example",
      "momentum_class": "example",
      "wow_change": 0,
      "net_spec_4w_avg": 0,
      "net_spec_13w_avg": 0
    }
  },
  "history": [],
  "history_every_n_weeks": 1,
  "index_traders": {
    "report_date": "2026-10-09T00:00:00.000Z",
    "long": 0,
    "short": 0,
    "net": 0
  },
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_cot_weekly

The weekly Commitments of Traders digest, computed from stored data: the biggest speculator position changes (relative to open interest), markets whose net speculator position flipped long/short, and the most extreme long and short positioning (by percentile), for one CFTC report date. Use it for 'what moved in positioning this week' or to find crowded trades across all markets. Follow up with el7_cot_positioning for any market's detail. Also carries a short summary (headline, lede, opening excerpt) of EL7's AI-written weekly report, which is written in Arabic; call el7_cot_analysis (no market) for the full text.

cot · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "report_date": {
      "description": "COT report date (the Tuesday positions are as of), YYYY-MM-DD. Omit for the latest report; a date between releases resolves to the newest report on or before it.",
      "type": "string"
    },
    "category": {
      "description": "Restrict every section to one market category.",
      "type": "string",
      "enum": [
        "currencies",
        "indices",
        "rates",
        "crypto",
        "energy",
        "metals",
        "grains",
        "softs",
        "wood"
      ]
    },
    "limit": {
      "default": 10,
      "description": "Maximum rows per section (1-25, default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "report_date": {
      "type": "string"
    },
    "markets_reported": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "positioning_breakdown": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "integer",
        "minimum": -9007199254740991,
        "maximum": 9007199254740991
      }
    },
    "biggest_changes": {
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cftc_code": {
            "type": "string"
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "net_spec_position": {
            "type": [
              "number",
              "null"
            ]
          },
          "wow_change": {
            "type": [
              "number",
              "null"
            ]
          },
          "wow_change_pct_oi": {
            "type": [
              "number",
              "null"
            ]
          },
          "z_score_1y": {
            "type": [
              "number",
              "null"
            ]
          },
          "positioning_percentile": {
            "type": [
              "number",
              "null"
            ]
          },
          "positioning_category": {
            "type": [
              "string",
              "null"
            ]
          },
          "momentum_class": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "cftc_code",
          "symbol",
          "name",
          "category",
          "net_spec_position",
          "wow_change",
          "wow_change_pct_oi",
          "z_score_1y",
          "positioning_percentile",
          "positioning_category",
          "momentum_class",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "net_flips": {
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cftc_code": {
            "type": "string"
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "net_spec_position": {
            "type": [
              "number",
              "null"
            ]
          },
          "wow_change": {
            "type": [
              "number",
              "null"
            ]
          },
          "wow_change_pct_oi": {
            "type": [
              "number",
              "null"
            ]
          },
          "z_score_1y": {
            "type": [
              "number",
              "null"
            ]
          },
          "positioning_percentile": {
            "type": [
              "number",
              "null"
            ]
          },
          "positioning_category": {
            "type": [
              "string",
              "null"
            ]
          },
          "momentum_class": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "flipped_to": {
            "type": "string",
            "enum": [
              "net_long",
              "net_short"
            ]
          }
        },
        "required": [
          "cftc_code",
          "symbol",
          "name",
          "category",
          "net_spec_position",
          "wow_change",
          "wow_change_pct_oi",
          "z_score_1y",
          "positioning_percentile",
          "positioning_category",
          "momentum_class",
          "url",
          "flipped_to"
        ],
        "additionalProperties": false
      }
    },
    "extreme_long": {
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cftc_code": {
            "type": "string"
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "net_spec_position": {
            "type": [
              "number",
              "null"
            ]
          },
          "wow_change": {
            "type": [
              "number",
              "null"
            ]
          },
          "wow_change_pct_oi": {
            "type": [
              "number",
              "null"
            ]
          },
          "z_score_1y": {
            "type": [
              "number",
              "null"
            ]
          },
          "positioning_percentile": {
            "type": [
              "number",
              "null"
            ]
          },
          "positioning_category": {
            "type": [
              "string",
              "null"
            ]
          },
          "momentum_class": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "cftc_code",
          "symbol",
          "name",
          "category",
          "net_spec_position",
          "wow_change",
          "wow_change_pct_oi",
          "z_score_1y",
          "positioning_percentile",
          "positioning_category",
          "momentum_class",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "extreme_short": {
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cftc_code": {
            "type": "string"
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "net_spec_position": {
            "type": [
              "number",
              "null"
            ]
          },
          "wow_change": {
            "type": [
              "number",
              "null"
            ]
          },
          "wow_change_pct_oi": {
            "type": [
              "number",
              "null"
            ]
          },
          "z_score_1y": {
            "type": [
              "number",
              "null"
            ]
          },
          "positioning_percentile": {
            "type": [
              "number",
              "null"
            ]
          },
          "positioning_category": {
            "type": [
              "string",
              "null"
            ]
          },
          "momentum_class": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "cftc_code",
          "symbol",
          "name",
          "category",
          "net_spec_position",
          "wow_change",
          "wow_change_pct_oi",
          "z_score_1y",
          "positioning_percentile",
          "positioning_category",
          "momentum_class",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "weekly_report_url": {
      "anyOf": [
        {
          "type": "string",
          "format": "uri"
        },
        {
          "type": "null"
        }
      ]
    },
    "ai_summary": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "language": {
              "type": "string",
              "const": "ar"
            },
            "headline": {
              "type": [
                "string",
                "null"
              ]
            },
            "lede": {
              "type": [
                "string",
                "null"
              ]
            },
            "big_picture_excerpt": {
              "type": [
                "string",
                "null"
              ]
            },
            "analysis_tool": {
              "type": "string",
              "const": "el7_cot_analysis"
            }
          },
          "required": [
            "language",
            "headline",
            "lede",
            "big_picture_excerpt",
            "analysis_tool"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "report_date",
    "markets_reported",
    "positioning_breakdown",
    "biggest_changes",
    "net_flips",
    "extreme_long",
    "extreme_short",
    "weekly_report_url",
    "ai_summary"
  ],
  "additionalProperties": false
}

{
  "report_date": "2026-10-09T00:00:00.000Z",
  "markets_reported": 0,
  "positioning_breakdown": {},
  "biggest_changes": [],
  "net_flips": [],
  "extreme_long": [],
  "extreme_short": [],
  "weekly_report_url": "https://el7.ai/ar/news",
  "ai_summary": {
    "language": "ar",
    "headline": "example",
    "lede": "example",
    "big_picture_excerpt": "example",
    "analysis_tool": "el7_cot_analysis"
  }
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_cot_market_detail

The structure blocks of the website's /cot/<cftcCode> page for one market's latest report: trader concentration (top-4/top-8 gross and net, long/short, with percentile vs the contract's own 3-year history and anomalies), number of traders per group with average position size and spread positions, the options leg and hedge ratio (disaggregated markets), CIT index-trader history (agricultural markets), bank participation (US/non-US banks, where CFTC publishes it), cohort quality and agreement (disaggregated), EL7 conviction quality score (0-100 with components), position-flow regime (accumulation/distribution/rotation), EL7 market regime, headline COT index and z-score stats, and data anomalies flagged for the market. Use it after el7_cot_positioning when asked who holds the positions, how concentrated or crowded they are, or whether the signal is high quality. Blocks that do not apply to the market's report type are null. Not included: user alerts (personal) and the rule backtester (compute-heavy).

cot · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "market": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "description": "CFTC contract code (e.g. '088691' for gold), symbol (e.g. 'GC', 'EUR') or exact market name (e.g. 'Gold'). Find codes with el7_cot_markets."
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "market"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "market": {
      "type": "object",
      "properties": {
        "cftc_code": {
          "type": "string"
        },
        "symbol": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "type": "string"
        },
        "category": {
          "type": [
            "string",
            "null"
          ]
        },
        "report_type": {
          "type": "string"
        },
        "url": {
          "type": "string",
          "format": "uri"
        },
        "exchange": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "cftc_code",
        "symbol",
        "name",
        "category",
        "report_type",
        "url",
        "exchange"
      ],
      "additionalProperties": false
    },
    "basis": {
      "type": "string",
      "enum": [
        "tff",
        "disaggregated",
        "legacy"
      ]
    },
    "report_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "contract_units": {
      "type": [
        "string",
        "null"
      ]
    },
    "open_interest": {
      "type": [
        "number",
        "null"
      ]
    },
    "cot_index": {
      "type": [
        "number",
        "null"
      ]
    },
    "cot_index_category": {
      "type": [
        "string",
        "null"
      ]
    },
    "stats": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "net_spec_position": {
              "type": [
                "number",
                "null"
              ]
            },
            "net_spec_pct_oi": {
              "type": [
                "number",
                "null"
              ]
            },
            "z_score_1y": {
              "type": [
                "number",
                "null"
              ]
            },
            "z_score_3y": {
              "type": [
                "number",
                "null"
              ]
            },
            "positioning_percentile": {
              "type": [
                "number",
                "null"
              ]
            },
            "positioning_category": {
              "type": [
                "string",
                "null"
              ]
            },
            "trend_direction": {
              "type": [
                "string",
                "null"
              ]
            },
            "momentum_class": {
              "type": [
                "string",
                "null"
              ]
            },
            "wow_change": {
              "type": [
                "number",
                "null"
              ]
            },
            "net_spec_4w_avg": {
              "type": [
                "number",
                "null"
              ]
            },
            "net_spec_13w_avg": {
              "type": [
                "number",
                "null"
              ]
            }
          },
          "required": [
            "net_spec_position",
            "net_spec_pct_oi",
            "z_score_1y",
            "z_score_3y",
            "positioning_percentile",
            "positioning_category",
            "trend_direction",
            "momentum_class",
            "wow_change",
            "net_spec_4w_avg",
            "net_spec_13w_avg"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "concentration": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "top4_gross_pct_oi": {
              "type": "object",
              "properties": {
                "long": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "short": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "long",
                "short"
              ],
              "additionalProperties": false
            },
            "top8_gross_pct_oi": {
              "type": "object",
              "properties": {
                "long": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "short": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "long",
                "short"
              ],
              "additionalProperties": false
            },
            "top4_net_pct_oi": {
              "type": "object",
              "properties": {
                "long": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "short": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "long",
                "short"
              ],
              "additionalProperties": false
            },
            "top8_net_pct_oi": {
              "type": "object",
              "properties": {
                "long": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "short": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "long",
                "short"
              ],
              "additionalProperties": false
            },
            "percentile_vs_3y": {
              "type": "object",
              "properties": {
                "top4_gross": {
                  "type": "object",
                  "properties": {
                    "long": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "short": {
                      "type": [
                        "number",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "long",
                    "short"
                  ],
                  "additionalProperties": false
                },
                "top8_gross": {
                  "type": "object",
                  "properties": {
                    "long": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "short": {
                      "type": [
                        "number",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "long",
                    "short"
                  ],
                  "additionalProperties": false
                },
                "top4_net": {
                  "type": "object",
                  "properties": {
                    "long": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "short": {
                      "type": [
                        "number",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "long",
                    "short"
                  ],
                  "additionalProperties": false
                },
                "top8_net": {
                  "type": "object",
                  "properties": {
                    "long": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "short": {
                      "type": [
                        "number",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "long",
                    "short"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "top4_gross",
                "top8_gross",
                "top4_net",
                "top8_net"
              ],
              "additionalProperties": false
            },
            "history_weeks": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "anomalies": {
              "maxItems": 10,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string"
                  },
                  "severity": {
                    "type": "string"
                  },
                  "metric": {
                    "type": "string"
                  },
                  "value": {
                    "type": "number"
                  },
                  "threshold": {
                    "type": "number"
                  },
                  "description": {
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "severity",
                  "metric",
                  "value",
                  "threshold",
                  "description"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "top4_gross_pct_oi",
            "top8_gross_pct_oi",
            "top4_net_pct_oi",
            "top8_net_pct_oi",
            "percentile_vs_3y",
            "history_weeks",
            "anomalies"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "participation": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "total_traders": {
              "type": [
                "number",
                "null"
              ]
            },
            "reportable_long_traders": {
              "type": [
                "number",
                "null"
              ]
            },
            "reportable_short_traders": {
              "type": [
                "number",
                "null"
              ]
            },
            "reportable_share_of_oi_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "groups": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "group": {
                    "type": "string"
                  },
                  "label": {
                    "type": "string"
                  },
                  "traders_long": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "traders_short": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "traders_spread": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "positions_long": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "positions_short": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "spread_positions": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "spread_pct_oi": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "avg_position_long": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "avg_position_short": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "group",
                  "label",
                  "traders_long",
                  "traders_short",
                  "traders_spread",
                  "positions_long",
                  "positions_short",
                  "spread_positions",
                  "spread_pct_oi",
                  "avg_position_long",
                  "avg_position_short"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "total_traders",
            "reportable_long_traders",
            "reportable_short_traders",
            "reportable_share_of_oi_pct",
            "groups"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "options_leg": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "report_date": {
              "type": "string"
            },
            "managed_money": {
              "type": "object",
              "properties": {
                "long": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "short": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "net": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "hedge_ratio": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "long",
                "short",
                "net",
                "hedge_ratio"
              ],
              "additionalProperties": false
            },
            "producers_merchants": {
              "type": "object",
              "properties": {
                "long": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "short": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "net": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "hedge_ratio": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "long",
                "short",
                "net",
                "hedge_ratio"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "report_date",
            "managed_money",
            "producers_merchants"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "cit": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "latest": {
              "type": "object",
              "properties": {
                "report_date": {
                  "type": "string"
                },
                "long": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "short": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "net": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "pct_oi_long": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "pct_oi_short": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "change_long": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "change_short": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "traders_long": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "traders_short": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "report_date",
                "long",
                "short",
                "net",
                "pct_oi_long",
                "pct_oi_short",
                "change_long",
                "change_short",
                "traders_long",
                "traders_short"
              ],
              "additionalProperties": false
            },
            "history": {
              "maxItems": 52,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "report_date": {
                    "type": "string"
                  },
                  "long": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "short": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "net": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "report_date",
                  "long",
                  "short",
                  "net"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "latest",
            "history"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "bank_participation": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "commodity": {
              "type": "string"
            },
            "report_date": {
              "type": "string"
            },
            "futures": {
              "type": "object",
              "properties": {
                "us": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "non_us": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "total": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "open_interest": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "us",
                "non_us",
                "total",
                "open_interest"
              ],
              "additionalProperties": false
            },
            "options": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "us": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": [
                          "number",
                          "null"
                        ]
                      }
                    },
                    "non_us": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": [
                          "number",
                          "null"
                        ]
                      }
                    },
                    "total": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": [
                          "number",
                          "null"
                        ]
                      }
                    },
                    "open_interest": {
                      "type": [
                        "number",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "us",
                    "non_us",
                    "total",
                    "open_interest"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "commodity",
            "report_date",
            "futures",
            "options"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "cohorts": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "report_date": {
              "type": "string"
            },
            "dominant_cohort": {
              "type": [
                "string",
                "null"
              ]
            },
            "flow_attribution": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "number"
              }
            },
            "items": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "cohort": {
                    "type": "string"
                  },
                  "long": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "short": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "spread": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "net": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "traders": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "pct_oi_total": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "top4_share_pct": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "turnover_pct": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "avg_contracts_per_trader": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "quality": {
                    "type": "number"
                  },
                  "grade": {
                    "type": "string",
                    "enum": [
                      "high",
                      "medium",
                      "low"
                    ]
                  }
                },
                "required": [
                  "cohort",
                  "long",
                  "short",
                  "spread",
                  "net",
                  "traders",
                  "pct_oi_total",
                  "top4_share_pct",
                  "turnover_pct",
                  "avg_contracts_per_trader",
                  "quality",
                  "grade"
                ],
                "additionalProperties": false
              }
            },
            "agreement_matrix": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "number"
                }
              }
            }
          },
          "required": [
            "report_date",
            "dominant_cohort",
            "flow_attribution",
            "items",
            "agreement_matrix"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "conviction": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "score": {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            },
            "grade": {
              "type": "string",
              "enum": [
                "high",
                "medium",
                "low"
              ]
            },
            "components": {
              "type": "object",
              "properties": {
                "breadth": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "spread_purity": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "concentration": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "coverage": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "magnitude": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "breadth",
                "spread_purity",
                "concentration",
                "coverage",
                "magnitude"
              ],
              "additionalProperties": false
            },
            "components_available": {
              "type": "integer",
              "minimum": 0,
              "maximum": 5
            },
            "narrative": {
              "type": "string"
            }
          },
          "required": [
            "score",
            "grade",
            "components",
            "components_available",
            "narrative"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "position_flow": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "report_date": {
              "type": "string"
            },
            "regime": {
              "type": "string",
              "enum": [
                "accumulation",
                "distribution",
                "rotation",
                "neutral"
              ]
            },
            "confidence": {
              "type": "number"
            },
            "evidence": {
              "maxItems": 10,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "weeks_analysed": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "ls_ratio": {
              "type": [
                "number",
                "null"
              ]
            },
            "ls_momentum": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "improving",
                    "declining",
                    "stable"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "spread_pct_oi": {
              "type": [
                "number",
                "null"
              ]
            },
            "groups": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "group": {
                    "type": "string"
                  },
                  "flow_type": {
                    "type": "string"
                  },
                  "long_change": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "short_change": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "net_change": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "group",
                  "flow_type",
                  "long_change",
                  "short_change",
                  "net_change"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "report_date",
            "regime",
            "confidence",
            "evidence",
            "weeks_analysed",
            "ls_ratio",
            "ls_momentum",
            "spread_pct_oi",
            "groups"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "market_regime": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "regime": {
              "type": "string"
            },
            "confidence": {
              "type": "number"
            },
            "signals": {
              "maxItems": 12,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "crowding": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "extreme",
                    "elevated",
                    "moderate",
                    "low"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "regime",
            "confidence",
            "signals",
            "crowding"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "anomalies": {
      "type": "object",
      "properties": {
        "unresolved_total": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "latest": {
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "report_date": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "type": {
                "type": "string"
              },
              "severity": {
                "type": "string"
              },
              "field": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "report_date",
              "type",
              "severity",
              "field",
              "message"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "unresolved_total",
        "latest"
      ],
      "additionalProperties": false
    },
    "unavailable_blocks": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "not_included": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "market",
    "basis",
    "report_date",
    "contract_units",
    "open_interest",
    "cot_index",
    "cot_index_category",
    "stats",
    "concentration",
    "participation",
    "options_leg",
    "cit",
    "bank_participation",
    "cohorts",
    "conviction",
    "position_flow",
    "market_regime",
    "anomalies",
    "unavailable_blocks",
    "not_included",
    "url"
  ],
  "additionalProperties": false
}

{
  "market": {
    "cftc_code": "example",
    "symbol": "example",
    "name": "example",
    "category": "example",
    "report_type": "example",
    "url": "https://el7.ai/ar/news",
    "exchange": "example"
  },
  "basis": "tff",
  "report_date": "2026-10-09T00:00:00.000Z",
  "contract_units": "example",
  "open_interest": 0,
  "cot_index": 0,
  "cot_index_category": "example",
  "stats": {
    "net_spec_position": 0,
    "net_spec_pct_oi": 0,
    "z_score_1y": 0,
    "z_score_3y": 0,
    "positioning_percentile": 0,
    "positioning_category": "example",
    "trend_direction": "example",
    "momentum_class": "example",
    "wow_change": 0,
    "net_spec_4w_avg": 0,
    "net_spec_13w_avg": 0
  },
  "concentration": {
    "top4_gross_pct_oi": {
      "long": 0,
      "short": 0
    },
    "top8_gross_pct_oi": {
      "long": 0,
      "short": 0
    },
    "top4_net_pct_oi": {
      "long": 0,
      "short": 0
    },
    "top8_net_pct_oi": {
      "long": 0,
      "short": 0
    },
    "percentile_vs_3y": {
      "top4_gross": {
        "long": 0,
        "short": 0
      },
      "top8_gross": {
        "long": 0,
        "short": 0
      },
      "top4_net": {
        "long": 0,
        "short": 0
      },
      "top8_net": {
        "long": 0,
        "short": 0
      }
    },
    "history_weeks": 0,
    "anomalies": []
  },
  "participation": {
    "total_traders": 0,
    "reportable_long_traders": 0,
    "reportable_short_traders": 0,
    "reportable_share_of_oi_pct": 0,
    "groups": []
  },
  "options_leg": {
    "report_date": "2026-10-09T00:00:00.000Z",
    "managed_money": {
      "long": 0,
      "short": 0,
      "net": 0,
      "hedge_ratio": 0
    },
    "producers_merchants": {
      "long": 0,
      "short": 0,
      "net": 0,
      "hedge_ratio": 0
    }
  },
  "cit": {
    "latest": {
      "report_date": "2026-10-09T00:00:00.000Z",
      "long": 0,
      "short": 0,
      "net": 0,
      "pct_oi_long": 0,
      "pct_oi_short": 0,
      "change_long": 0,
      "change_short": 0,
      "traders_long": 0,
      "traders_short": 0
    },
    "history": []
  },
  "bank_participation": {
    "commodity": "example",
    "report_date": "2026-10-09T00:00:00.000Z",
    "futures": {
      "us": {},
      "non_us": {},
      "total": {},
      "open_interest": 0
    },
    "options": {
      "us": {},
      "non_us": {},
      "total": {},
      "open_interest": 0
    }
  },
  "cohorts": {
    "report_date": "2026-10-09T00:00:00.000Z",
    "dominant_cohort": "example",
    "flow_attribution": {},
    "items": [],
    "agreement_matrix": {}
  },
  "conviction": {
    "score": 0,
    "grade": "high",
    "components": {
      "breadth": 0,
      "spread_purity": 0,
      "concentration": 0,
      "coverage": 0,
      "magnitude": 0
    },
    "components_available": 0,
    "narrative": "example"
  },
  "position_flow": {
    "report_date": "2026-10-09T00:00:00.000Z",
    "regime": "accumulation",
    "confidence": 0,
    "evidence": [],
    "weeks_analysed": 0,
    "ls_ratio": 0,
    "ls_momentum": "improving",
    "spread_pct_oi": 0,
    "groups": []
  },
  "market_regime": {
    "regime": "example",
    "confidence": 0,
    "signals": [],
    "crowding": "extreme"
  },
  "anomalies": {
    "unresolved_total": 0,
    "latest": []
  },
  "unavailable_blocks": [],
  "not_included": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_cot_analysis

EL7's own stored, AI-written COT analysis, returned as plain text, never generated on request. With a market (cftc_code or symbol): the weekly per-market analysis shown on /cot/<cftcCode>, with signal direction, confidence and the key number / what to watch / historical anchor when present, in your language. Without a market: the full weekly AI report for all markets (big picture, highlights, major markets, cross-asset links, surprises, positioning table) as text capped at 12,000 characters with a truncated flag; that report is written in Arabic. Use it when asked for EL7's view or narrative on positioning; pair with el7_cot_positioning or el7_cot_market_detail for the numbers behind it. el7_cot_weekly carries only a short summary of the same report.

cot · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "market": {
      "description": "CFTC contract code (e.g. '088691'), symbol (e.g. 'GC') or exact market name (e.g. 'Gold'). Give it for EL7's per-market weekly AI analysis; omit it for the full weekly AI report across all markets.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "report_date": {
      "description": "COT report date (Tuesday positions), YYYY-MM-DD. Omit for the latest; a date between releases resolves to the newest analysis on or before it.",
      "type": "string"
    },
    "limit": {
      "default": 1,
      "description": "Market mode only: how many weekly analyses to return, newest first (1-8, default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 8
    },
    "max_chars": {
      "default": 12000,
      "description": "Weekly-report mode only: maximum characters of report text (1000-12000, default 12000). The result says if it was truncated.",
      "type": "integer",
      "minimum": 1000,
      "maximum": 12000
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "scope": {
      "type": "string",
      "enum": [
        "market",
        "weekly_report"
      ]
    },
    "market": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "cftc_code": {
              "type": "string"
            },
            "symbol": {
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "type": "string"
            },
            "category": {
              "type": [
                "string",
                "null"
              ]
            },
            "report_type": {
              "type": "string"
            },
            "url": {
              "type": "string",
              "format": "uri"
            },
            "exchange": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "cftc_code",
            "symbol",
            "name",
            "category",
            "report_type",
            "url",
            "exchange"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "analyses": {
      "maxItems": 8,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "report_date": {
            "type": "string"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "text": {
            "type": "string"
          },
          "language": {
            "type": "string",
            "enum": [
              "en",
              "ar"
            ]
          },
          "signal": {
            "type": [
              "string",
              "null"
            ]
          },
          "confidence": {
            "type": [
              "number",
              "null"
            ]
          },
          "key_number": {
            "type": [
              "string",
              "null"
            ]
          },
          "watch_next_week": {
            "type": [
              "string",
              "null"
            ]
          },
          "historical_anchor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "report_date",
          "title",
          "text",
          "language",
          "signal",
          "confidence",
          "key_number",
          "watch_next_week",
          "historical_anchor"
        ],
        "additionalProperties": false
      }
    },
    "weekly_report": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "report_date": {
              "type": "string"
            },
            "publication_date": {
              "type": [
                "string",
                "null"
              ]
            },
            "headline": {
              "type": [
                "string",
                "null"
              ]
            },
            "language": {
              "type": "string",
              "const": "ar"
            },
            "text": {
              "type": "string"
            },
            "total_chars": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "truncated": {
              "type": "boolean"
            },
            "url": {
              "type": "string",
              "format": "uri"
            }
          },
          "required": [
            "report_date",
            "publication_date",
            "headline",
            "language",
            "text",
            "total_chars",
            "truncated",
            "url"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "note": {
      "type": [
        "string",
        "null"
      ]
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "scope",
    "market",
    "analyses",
    "weekly_report",
    "note",
    "url"
  ],
  "additionalProperties": false
}

{
  "scope": "market",
  "market": {
    "cftc_code": "example",
    "symbol": "example",
    "name": "example",
    "category": "example",
    "report_type": "example",
    "url": "https://el7.ai/ar/news",
    "exchange": "example"
  },
  "analyses": [],
  "weekly_report": {
    "report_date": "2026-10-09T00:00:00.000Z",
    "publication_date": "2026-10-09T00:00:00.000Z",
    "headline": "example",
    "language": "ar",
    "text": "example",
    "total_chars": 0,
    "truncated": false,
    "url": "https://el7.ai/ar/news"
  },
  "note": "example",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_oil_inventories

Returns the EIA Weekly Petroleum Status Report stocks EL7 stores: US commercial crude, Cushing and Strategic Petroleum Reserve inventories (million barrels) with week-over-week change, deviation from the 5-year average and prior year, the API estimate vs EIA actual, plus the latest refined-product stocks (gasoline, distillate, etc.). Use it for questions about US crude draws/builds and stock levels. For production and imports call el7_oil_supply; for demand forecasts el7_oil_outlook.

energy · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "weeks": {
      "default": 12,
      "description": "Weeks of crude inventory history to return (1-104, default 12).",
      "type": "integer",
      "minimum": 1,
      "maximum": 104
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "latest": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "week_ending": {
              "type": "string"
            },
            "total_inventory_mb": {
              "type": [
                "number",
                "null"
              ]
            },
            "cushing_inventory_mb": {
              "type": [
                "number",
                "null"
              ]
            },
            "spr_inventory_mb": {
              "type": [
                "number",
                "null"
              ]
            },
            "weekly_change_mb": {
              "type": [
                "number",
                "null"
              ]
            },
            "cushing_change_mb": {
              "type": [
                "number",
                "null"
              ]
            },
            "vs_five_year_avg_mb": {
              "type": [
                "number",
                "null"
              ]
            },
            "vs_five_year_avg_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "vs_last_year_mb": {
              "type": [
                "number",
                "null"
              ]
            }
          },
          "required": [
            "week_ending",
            "total_inventory_mb",
            "cushing_inventory_mb",
            "spr_inventory_mb",
            "weekly_change_mb",
            "cushing_change_mb",
            "vs_five_year_avg_mb",
            "vs_five_year_avg_pct",
            "vs_last_year_mb"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "average_weekly_change_4w_mb": {
      "type": [
        "number",
        "null"
      ]
    },
    "history": {
      "maxItems": 104,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "week_ending": {
            "type": "string"
          },
          "total_inventory_mb": {
            "type": [
              "number",
              "null"
            ]
          },
          "cushing_inventory_mb": {
            "type": [
              "number",
              "null"
            ]
          },
          "spr_inventory_mb": {
            "type": [
              "number",
              "null"
            ]
          },
          "weekly_change_mb": {
            "type": [
              "number",
              "null"
            ]
          },
          "cushing_change_mb": {
            "type": [
              "number",
              "null"
            ]
          },
          "vs_five_year_avg_mb": {
            "type": [
              "number",
              "null"
            ]
          },
          "api_estimate_mb": {
            "type": [
              "number",
              "null"
            ]
          },
          "api_vs_eia_mb": {
            "type": [
              "number",
              "null"
            ]
          },
          "surprise_direction": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "week_ending",
          "total_inventory_mb",
          "cushing_inventory_mb",
          "spr_inventory_mb",
          "weekly_change_mb",
          "cushing_change_mb",
          "vs_five_year_avg_mb",
          "api_estimate_mb",
          "api_vs_eia_mb",
          "surprise_direction"
        ],
        "additionalProperties": false
      }
    },
    "product_stocks": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "series_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "units": {
            "type": [
              "string",
              "null"
            ]
          },
          "period": {
            "type": "string"
          },
          "value": {
            "type": [
              "number",
              "null"
            ]
          },
          "change": {
            "type": [
              "number",
              "null"
            ]
          },
          "change_pct": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "series_id",
          "name",
          "units",
          "period",
          "value",
          "change",
          "change_pct"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "latest",
    "average_weekly_change_4w_mb",
    "history",
    "product_stocks",
    "url"
  ],
  "additionalProperties": false
}

{
  "latest": {
    "week_ending": "example",
    "total_inventory_mb": 0,
    "cushing_inventory_mb": 0,
    "spr_inventory_mb": 0,
    "weekly_change_mb": 0,
    "cushing_change_mb": 0,
    "vs_five_year_avg_mb": 0,
    "vs_five_year_avg_pct": 0,
    "vs_last_year_mb": 0
  },
  "average_weekly_change_4w_mb": 0,
  "history": [],
  "product_stocks": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_oil_supply

Returns EIA oil supply-side series stored by EL7: US crude production, refinery utilisation, supply/disposition, imports and exports (latest value with change, or history for one series_id), plus the latest top US states by crude output and the Drilling Productivity Report by shale region (new-well output per rig, DUC wells). Use it for US supply questions. For stock levels call el7_oil_inventories; for forecasts el7_oil_outlook. Price series are not served.

energy · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "category": {
      "default": "production",
      "description": "EIA series group: production (crude output, refinery utilisation, supply and disposition) or imports.",
      "type": "string",
      "enum": [
        "production",
        "imports"
      ]
    },
    "series_id": {
      "description": "One EIA series id (as returned by this tool, e.g. PET.WCRFPUS2.W) to get its history. Omit for the latest value of every series in the category.",
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "periods": {
      "default": 12,
      "description": "History length in periods when series_id is given (1-60, default 12).",
      "type": "integer",
      "minimum": 1,
      "maximum": 60
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "series": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "series_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "frequency": {
            "type": [
              "string",
              "null"
            ]
          },
          "units": {
            "type": [
              "string",
              "null"
            ]
          },
          "period": {
            "type": [
              "string",
              "null"
            ]
          },
          "value": {
            "type": [
              "number",
              "null"
            ]
          },
          "change": {
            "type": [
              "number",
              "null"
            ]
          },
          "change_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "history": {
            "maxItems": 60,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "period": {
                  "type": "string"
                },
                "value": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "change": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "change_pct": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "period",
                "value",
                "change",
                "change_pct"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "series_id",
          "name",
          "category",
          "frequency",
          "units",
          "period",
          "value",
          "change",
          "change_pct",
          "history"
        ],
        "additionalProperties": false
      }
    },
    "us_states": {
      "maxItems": 15,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "period": {
            "type": "string"
          },
          "state_code": {
            "type": "string"
          },
          "state_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "production_kbd": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "period",
          "state_code",
          "state_name",
          "production_kbd"
        ],
        "additionalProperties": false
      }
    },
    "drilling_productivity": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "report_date": {
            "type": "string"
          },
          "region": {
            "type": "string"
          },
          "new_well_oil_prod_per_rig": {
            "type": [
              "number",
              "null"
            ]
          },
          "total_oil_production_kbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "legacy_oil_production_change_kbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "duc_wells": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "report_date",
          "region",
          "new_well_oil_prod_per_rig",
          "total_oil_production_kbd",
          "legacy_oil_production_change_kbd",
          "duc_wells"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "series",
    "us_states",
    "drilling_productivity",
    "url"
  ],
  "additionalProperties": false
}

{
  "series": [],
  "us_states": [],
  "drilling_productivity": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_oil_outlook

Returns the agencies' published oil market forecasts as stored by EL7: IEA Oil Market Report (world demand, supply, growth, implied balance, OECD stocks), EIA Short-Term Energy Outlook (demand, supply, OPEC/non-OPEC and US production by year) and OPEC's Monthly Oil Market Report (demand, non-OPEC supply, call on OPEC, OECD stocks), latest editions first, in million barrels per day. Use it to compare agency views or ask where demand growth and the supply-demand balance are heading. Price forecasts and Brent/WTI averages are not served. See also el7_oil_opec and el7_oil_inventories.

energy · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "sources": {
      "default": [
        "iea",
        "eia",
        "opec"
      ],
      "description": "Which agencies to include: iea (Oil Market Report), eia (Short-Term Energy Outlook), opec (Monthly Oil Market Report). Default all three.",
      "minItems": 1,
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "iea",
          "eia",
          "opec"
        ]
      }
    },
    "reports": {
      "default": 1,
      "description": "How many of each agency's latest report editions to return (1-6, default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 6
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "iea": {
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "report_date": {
            "type": "string"
          },
          "source_report": {
            "type": [
              "string",
              "null"
            ]
          },
          "forecasts": {
            "maxItems": 40,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "forecast_year": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "forecast_quarter": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "world_demand_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "demand_growth_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "demand_growth_pct": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "oecd_demand_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "non_oecd_demand_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "china_demand_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "us_demand_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "world_supply_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "supply_growth_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "opec_production_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "non_opec_production_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "us_production_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "implied_balance_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "oecd_stocks_mb": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "days_of_demand": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "demand_revision_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "forecast_year",
                "forecast_quarter",
                "world_demand_mbd",
                "demand_growth_mbd",
                "demand_growth_pct",
                "oecd_demand_mbd",
                "non_oecd_demand_mbd",
                "china_demand_mbd",
                "us_demand_mbd",
                "world_supply_mbd",
                "supply_growth_mbd",
                "opec_production_mbd",
                "non_opec_production_mbd",
                "us_production_mbd",
                "implied_balance_mbd",
                "oecd_stocks_mb",
                "days_of_demand",
                "demand_revision_mbd"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "report_date",
          "source_report",
          "forecasts"
        ],
        "additionalProperties": false
      }
    },
    "eia_steo": {
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "report_date": {
            "type": "string"
          },
          "forecasts": {
            "maxItems": 40,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "forecast_year": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "forecast_quarter": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "world_demand_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "demand_growth_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "demand_growth_pct": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "oecd_demand_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "non_oecd_demand_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "china_demand_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "us_demand_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "world_supply_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "supply_growth_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "opec_production_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "non_opec_production_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "us_production_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "implied_balance_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "oecd_stocks_mb": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "days_of_demand": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "demand_revision_mbd": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "forecast_year",
                "forecast_quarter",
                "world_demand_mbd",
                "demand_growth_mbd",
                "demand_growth_pct",
                "oecd_demand_mbd",
                "non_oecd_demand_mbd",
                "china_demand_mbd",
                "us_demand_mbd",
                "world_supply_mbd",
                "supply_growth_mbd",
                "opec_production_mbd",
                "non_opec_production_mbd",
                "us_production_mbd",
                "implied_balance_mbd",
                "oecd_stocks_mb",
                "days_of_demand",
                "demand_revision_mbd"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "report_date",
          "forecasts"
        ],
        "additionalProperties": false
      }
    },
    "opec_momr": {
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "report_date": {
            "type": "string"
          },
          "world_demand_current_year_mbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "world_demand_next_year_mbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "demand_growth_current_year_mbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "demand_growth_next_year_mbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "non_opec_supply_current_year_mbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "non_opec_supply_growth_mbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "opec_production_avg_mbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "call_on_opec_mbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "oecd_stocks_mb": {
            "type": [
              "number",
              "null"
            ]
          },
          "oecd_stocks_vs_avg_mb": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "report_date",
          "world_demand_current_year_mbd",
          "world_demand_next_year_mbd",
          "demand_growth_current_year_mbd",
          "demand_growth_next_year_mbd",
          "non_opec_supply_current_year_mbd",
          "non_opec_supply_growth_mbd",
          "opec_production_avg_mbd",
          "call_on_opec_mbd",
          "oecd_stocks_mb",
          "oecd_stocks_vs_avg_mb"
        ],
        "additionalProperties": false
      }
    },
    "iea_omr_editions": {
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "report_date": {
            "type": "string"
          },
          "headline": {
            "type": [
              "string",
              "null"
            ]
          },
          "source_url": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "report_date",
          "headline",
          "source_url"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "iea",
    "eia_steo",
    "opec_momr",
    "iea_omr_editions",
    "url"
  ],
  "additionalProperties": false
}

{
  "iea": [],
  "eia_steo": [],
  "opec_momr": [],
  "iea_omr_editions": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_oil_opec

Returns OPEC and OPEC+ data stored by EL7: monthly crude production by country (thousand barrels/day) with quota and compliance where known, the latest production quotas and voluntary cuts, the OPEC Reference Basket price (OPEC's own published reference series) and the OPEC / OPEC+ meeting schedule with decision summaries. Use it for questions about OPEC output, cuts, compliance and upcoming ministerial meetings. For agency supply-demand forecasts call el7_oil_outlook.

energy · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "include": {
      "default": [
        "production",
        "quotas",
        "basket",
        "meetings"
      ],
      "description": "Sections to return: production (monthly crude output by country), quotas (latest production targets), basket (OPEC Reference Basket price), meetings (OPEC/OPEC+ ministerial meetings). Default all.",
      "minItems": 1,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "production",
          "quotas",
          "basket",
          "meetings"
        ]
      }
    },
    "country": {
      "description": "Three-letter country code (e.g. SAU, RUS, IRQ) to filter production and quotas.",
      "type": "string",
      "pattern": "^[A-Za-z]{3}$"
    },
    "months": {
      "default": 3,
      "description": "Months of production history ending at the latest stored month (1-24, default 3).",
      "type": "integer",
      "minimum": 1,
      "maximum": 24
    },
    "basket_days": {
      "default": 30,
      "description": "Daily OPEC basket price observations to return (1-90, default 30).",
      "type": "integer",
      "minimum": 1,
      "maximum": 90
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "production": {
      "maxItems": 600,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "country_code": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "is_opec_member": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "is_opec_plus": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "year": {
            "type": "number"
          },
          "month": {
            "type": "number"
          },
          "production_kbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "quota_kbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "compliance_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "production_change_kbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "production_change_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "source": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "country_code",
          "country",
          "is_opec_member",
          "is_opec_plus",
          "year",
          "month",
          "production_kbd",
          "quota_kbd",
          "compliance_pct",
          "production_change_kbd",
          "production_change_pct",
          "source"
        ],
        "additionalProperties": false
      }
    },
    "quotas": {
      "maxItems": 60,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "country_code": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "is_opec_member": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "is_opec_plus": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "effective_date": {
            "type": "string"
          },
          "quota_kbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "voluntary_cut_kbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "total_target_kbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "decision_meeting_date": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "country_code",
          "country",
          "is_opec_member",
          "is_opec_plus",
          "effective_date",
          "quota_kbd",
          "voluntary_cut_kbd",
          "total_target_kbd",
          "decision_meeting_date"
        ],
        "additionalProperties": false
      }
    },
    "basket": {
      "type": "object",
      "properties": {
        "latest": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string"
                },
                "price_usd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "change_usd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "change_pct": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "date",
                "price_usd",
                "change_usd",
                "change_pct"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "history": {
          "maxItems": 90,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "date": {
                "type": "string"
              },
              "price_usd": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "change_usd": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "change_pct": {
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "required": [
              "date",
              "price_usd",
              "change_usd",
              "change_pct"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "latest",
        "history"
      ],
      "additionalProperties": false
    },
    "meetings": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "meeting_date": {
            "type": "string"
          },
          "meeting_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "meeting_number": {
            "type": [
              "number",
              "null"
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "location": {
            "type": [
              "string",
              "null"
            ]
          },
          "is_virtual": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "is_completed": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "decision_summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "communique_url": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "meeting_date",
          "meeting_type",
          "meeting_number",
          "title",
          "location",
          "is_virtual",
          "is_completed",
          "decision_summary",
          "communique_url"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "production",
    "quotas",
    "basket",
    "meetings",
    "url"
  ],
  "additionalProperties": false
}

{
  "production": [],
  "quotas": [],
  "basket": {
    "latest": {
      "date": "2026-10-09T00:00:00.000Z",
      "price_usd": 0,
      "change_usd": 0,
      "change_pct": 0
    },
    "history": []
  },
  "meetings": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_oil_country_stats

Returns the monthly crude oil balance per country that EL7 shows on its oil statistics page, from the JODI-Oil World Database (about 60 reporting countries, roughly two months behind): crude production, refinery intake, crude imports and exports (thousand barrels/day) and closing crude stocks (million barrels). Use it to compare countries' crude balances over recent months. Total product demand is not in this dataset. For the global picture call el7_oil_outlook; for US weekly data el7_oil_inventories and el7_oil_supply.

energy · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "country": {
      "description": "Country code, two-letter (SA, US, CN) or three-letter (SAU, USA, CHN). Omit for every reporting country.",
      "type": "string",
      "pattern": "^[A-Za-z]{2,3}$"
    },
    "months": {
      "default": 6,
      "description": "Months of history ending at the latest month stored for the country (1-24, default 6). Without a country at most 3 months are returned.",
      "type": "integer",
      "minimum": 1,
      "maximum": 24
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 300,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "country_code": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "year": {
            "type": "number"
          },
          "month": {
            "type": "number"
          },
          "crude_production_kbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "refinery_intake_kbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "crude_imports_kbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "crude_exports_kbd": {
            "type": [
              "number",
              "null"
            ]
          },
          "crude_closing_stocks_mb": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "country_code",
          "country",
          "year",
          "month",
          "crude_production_kbd",
          "refinery_intake_kbd",
          "crude_imports_kbd",
          "crude_exports_kbd",
          "crude_closing_stocks_mb"
        ],
        "additionalProperties": false
      }
    },
    "latest_month": {
      "type": [
        "string",
        "null"
      ]
    },
    "source": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "items",
    "latest_month",
    "source",
    "url"
  ],
  "additionalProperties": false
}

{
  "items": [],
  "latest_month": "example",
  "source": "example",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_gold_overview

EL7's own Gold Conditions Index: a 0-100 composite of how supportive macro and positioning conditions are for gold (80+ strongly bullish, 60-79 bullish, 40-59 neutral, 20-39 bearish, below 20 strongly bearish), with the regime label and the six weighted components: 10Y real yields, dollar, COT speculator positioning, breakeven inflation, VIX/GVZ risk sentiment and GLD ETF flows (each with score, weight and signal). Use it for a quick read on the gold backdrop. It contains no gold prices. Drill down with el7_gold_flows (ETF/COMEX/vault/COT), el7_gold_macro (drivers) and el7_gold_reserves (central banks).

gold · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "score": {
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "regime": {
      "type": "string",
      "enum": [
        "strongly_bullish",
        "bullish",
        "neutral",
        "bearish",
        "strongly_bearish"
      ]
    },
    "components": {
      "type": "object",
      "properties": {
        "real_yields": {
          "type": "object",
          "properties": {
            "score": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            },
            "weight": {
              "type": "number"
            },
            "signal": {
              "type": "string",
              "enum": [
                "bullish",
                "bearish",
                "neutral"
              ]
            },
            "value": {
              "type": [
                "number",
                "null"
              ]
            },
            "value_unit": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "score",
            "weight",
            "signal",
            "value",
            "value_unit"
          ],
          "additionalProperties": false
        },
        "dxy": {
          "type": "object",
          "properties": {
            "score": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            },
            "weight": {
              "type": "number"
            },
            "signal": {
              "type": "string",
              "enum": [
                "bullish",
                "bearish",
                "neutral"
              ]
            },
            "value": {
              "type": [
                "number",
                "null"
              ]
            },
            "value_unit": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "score",
            "weight",
            "signal",
            "value",
            "value_unit"
          ],
          "additionalProperties": false
        },
        "cot_positioning": {
          "type": "object",
          "properties": {
            "score": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            },
            "weight": {
              "type": "number"
            },
            "signal": {
              "type": "string",
              "enum": [
                "bullish",
                "bearish",
                "neutral"
              ]
            },
            "value": {
              "type": [
                "number",
                "null"
              ]
            },
            "value_unit": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "score",
            "weight",
            "signal",
            "value",
            "value_unit"
          ],
          "additionalProperties": false
        },
        "breakeven_inflation": {
          "type": "object",
          "properties": {
            "score": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            },
            "weight": {
              "type": "number"
            },
            "signal": {
              "type": "string",
              "enum": [
                "bullish",
                "bearish",
                "neutral"
              ]
            },
            "value": {
              "type": [
                "number",
                "null"
              ]
            },
            "value_unit": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "score",
            "weight",
            "signal",
            "value",
            "value_unit"
          ],
          "additionalProperties": false
        },
        "risk_sentiment": {
          "type": "object",
          "properties": {
            "score": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            },
            "weight": {
              "type": "number"
            },
            "signal": {
              "type": "string",
              "enum": [
                "bullish",
                "bearish",
                "neutral"
              ]
            },
            "value": {
              "type": [
                "number",
                "null"
              ]
            },
            "value_unit": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "score",
            "weight",
            "signal",
            "value",
            "value_unit"
          ],
          "additionalProperties": false
        },
        "etf_flows": {
          "type": "object",
          "properties": {
            "score": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            },
            "weight": {
              "type": "number"
            },
            "signal": {
              "type": "string",
              "enum": [
                "bullish",
                "bearish",
                "neutral"
              ]
            },
            "value": {
              "type": [
                "number",
                "null"
              ]
            },
            "value_unit": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "score",
            "weight",
            "signal",
            "value",
            "value_unit"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "real_yields",
        "dxy",
        "cot_positioning",
        "breakeven_inflation",
        "risk_sentiment",
        "etf_flows"
      ],
      "additionalProperties": false
    },
    "data_freshness": {
      "type": [
        "string",
        "null"
      ]
    },
    "methodology": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "score",
    "regime",
    "components",
    "data_freshness",
    "methodology",
    "url"
  ],
  "additionalProperties": false
}

{
  "score": 0,
  "regime": "strongly_bullish",
  "components": {
    "real_yields": {
      "score": 0,
      "weight": 0,
      "signal": "bullish",
      "value": 0,
      "value_unit": "example"
    },
    "dxy": {
      "score": 0,
      "weight": 0,
      "signal": "bullish",
      "value": 0,
      "value_unit": "example"
    },
    "cot_positioning": {
      "score": 0,
      "weight": 0,
      "signal": "bullish",
      "value": 0,
      "value_unit": "example"
    },
    "breakeven_inflation": {
      "score": 0,
      "weight": 0,
      "signal": "bullish",
      "value": 0,
      "value_unit": "example"
    },
    "risk_sentiment": {
      "score": 0,
      "weight": 0,
      "signal": "bullish",
      "value": 0,
      "value_unit": "example"
    },
    "etf_flows": {
      "score": 0,
      "weight": 0,
      "signal": "bullish",
      "value": 0,
      "value_unit": "example"
    }
  },
  "data_freshness": "example",
  "methodology": "example",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_gold_flows

Physical and positioning flows for gold as EL7 tracks them: GLD ETF holdings in tonnes with daily change, window net flow and inflow/outflow day counts; COMEX warehouse eligible/registered stocks (troy ounces); London vault holdings (monthly); and the latest CFTC managed-money positioning in gold futures with z-score, percentile and momentum. No prices or USD values. Use it to see whether investors and warehouses are accumulating or releasing gold. For the composite backdrop call el7_gold_overview; for any COT market in depth el7_cot_positioning (gold code 088691).

gold · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "include": {
      "default": [
        "etf",
        "comex",
        "vault",
        "cot"
      ],
      "description": "Sections: etf (GLD holdings and flows), comex (warehouse eligible/registered stocks), vault (London vault holdings, monthly), cot (CFTC managed-money positioning in gold futures). Default all.",
      "minItems": 1,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "etf",
          "comex",
          "vault",
          "cot"
        ]
      }
    },
    "days": {
      "default": 30,
      "description": "Window in trading days for the GLD net-flow summary (1-365, default 30).",
      "type": "integer",
      "minimum": 1,
      "maximum": 365
    },
    "history_points": {
      "default": 30,
      "description": "Most recent observations to list per series (1-90, default 30).",
      "type": "integer",
      "minimum": 1,
      "maximum": 90
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "etf": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "fund": {
              "type": "string"
            },
            "latest_date": {
              "type": [
                "string",
                "null"
              ]
            },
            "latest_holdings_tonnes": {
              "type": [
                "number",
                "null"
              ]
            },
            "window_days": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "window_net_flow_tonnes": {
              "type": [
                "number",
                "null"
              ]
            },
            "inflow_days": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "outflow_days": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "history": {
              "maxItems": 90,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "date": {
                    "type": "string"
                  },
                  "holdings_tonnes": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "change_tonnes": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "cumulative_flow_tonnes": {
                    "type": "number"
                  }
                },
                "required": [
                  "date",
                  "holdings_tonnes",
                  "change_tonnes",
                  "cumulative_flow_tonnes"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "fund",
            "latest_date",
            "latest_holdings_tonnes",
            "window_days",
            "window_net_flow_tonnes",
            "inflow_days",
            "outflow_days",
            "history"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "comex": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "latest": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "date": {
                      "type": "string"
                    },
                    "eligible_oz": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "registered_oz": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "total_oz": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "change_oz": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "change_pct": {
                      "type": [
                        "number",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "date",
                    "eligible_oz",
                    "registered_oz",
                    "total_oz",
                    "change_oz",
                    "change_pct"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "history": {
              "maxItems": 90,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "date": {
                    "type": "string"
                  },
                  "eligible_oz": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "registered_oz": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "total_oz": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "change_oz": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "date",
                  "eligible_oz",
                  "registered_oz",
                  "total_oz",
                  "change_oz"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "latest",
            "history"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "vault": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "latest": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "report_date": {
                      "type": "string"
                    },
                    "total_oz": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "total_tonnes": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "change_oz": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "change_pct": {
                      "type": [
                        "number",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "report_date",
                    "total_oz",
                    "total_tonnes",
                    "change_oz",
                    "change_pct"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "history": {
              "maxItems": 90,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "report_date": {
                    "type": "string"
                  },
                  "total_oz": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "total_tonnes": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "change_oz": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "report_date",
                  "total_oz",
                  "total_tonnes",
                  "change_oz"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "latest",
            "history"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "cot": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "report_date": {
              "type": "string"
            },
            "managed_money_net": {
              "type": [
                "number",
                "null"
              ]
            },
            "net_spec_pct_oi": {
              "type": [
                "number",
                "null"
              ]
            },
            "z_score_1y": {
              "type": [
                "number",
                "null"
              ]
            },
            "positioning_percentile": {
              "type": [
                "number",
                "null"
              ]
            },
            "positioning_category": {
              "type": [
                "string",
                "null"
              ]
            },
            "trend_direction": {
              "type": [
                "string",
                "null"
              ]
            },
            "momentum_class": {
              "type": [
                "string",
                "null"
              ]
            },
            "wow_change": {
              "type": [
                "number",
                "null"
              ]
            },
            "detail_url": {
              "type": "string",
              "format": "uri"
            }
          },
          "required": [
            "report_date",
            "managed_money_net",
            "net_spec_pct_oi",
            "z_score_1y",
            "positioning_percentile",
            "positioning_category",
            "trend_direction",
            "momentum_class",
            "wow_change",
            "detail_url"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "urls": {
      "type": "object",
      "properties": {
        "etf": {
          "type": "string",
          "format": "uri"
        },
        "comex": {
          "type": "string",
          "format": "uri"
        },
        "vault": {
          "type": "string",
          "format": "uri"
        },
        "cot": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "etf",
        "comex",
        "vault",
        "cot"
      ],
      "additionalProperties": false
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "etf",
    "comex",
    "vault",
    "cot",
    "urls"
  ],
  "additionalProperties": false
}

{
  "etf": {
    "fund": "example",
    "latest_date": "2026-10-09T00:00:00.000Z",
    "latest_holdings_tonnes": 0,
    "window_days": 0,
    "window_net_flow_tonnes": 0,
    "inflow_days": 0,
    "outflow_days": 0,
    "history": []
  },
  "comex": {
    "latest": {
      "date": "2026-10-09T00:00:00.000Z",
      "eligible_oz": 0,
      "registered_oz": 0,
      "total_oz": 0,
      "change_oz": 0,
      "change_pct": 0
    },
    "history": []
  },
  "vault": {
    "latest": {
      "report_date": "2026-10-09T00:00:00.000Z",
      "total_oz": 0,
      "total_tonnes": 0,
      "change_oz": 0,
      "change_pct": 0
    },
    "history": []
  },
  "cot": {
    "report_date": "2026-10-09T00:00:00.000Z",
    "managed_money_net": 0,
    "net_spec_pct_oi": 0,
    "z_score_1y": 0,
    "positioning_percentile": 0,
    "positioning_category": "example",
    "trend_direction": "example",
    "momentum_class": "example",
    "wow_change": 0,
    "detail_url": "https://el7.ai/ar/news"
  },
  "urls": {
    "etf": "https://el7.ai/ar/news",
    "comex": "https://el7.ai/ar/news",
    "vault": "https://el7.ai/ar/news",
    "cot": "https://el7.ai/ar/news"
  }
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_gold_reserves

Central-bank gold holdings (World Gold Council data stored by EL7): the latest ranking of the largest official holders with tonnes, change in the period and gold's share of total reserves, or one country's holdings history. Use it for questions on who holds the most gold, who is buying or selling and how reserve gold has trended. For the demand side by quarter see el7_gold_supply_demand; for investor flows el7_gold_flows.

gold · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "country": {
      "description": "Two-letter country code (US, DE, CN, SA, TR, IN...). Omit for the latest ranking of all holders; with a country you get that country's reserve history.",
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "limit": {
      "default": 20,
      "description": "Holders to return in the ranking (1-50, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "months": {
      "default": 24,
      "description": "Periods of history when country is given (1-120, default 24).",
      "type": "integer",
      "minimum": 1,
      "maximum": 120
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "report_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "items": {
      "maxItems": 120,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rank": {
            "type": [
              "number",
              "null"
            ]
          },
          "country_code": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "report_date": {
            "type": "string"
          },
          "holdings_tonnes": {
            "type": [
              "number",
              "null"
            ]
          },
          "change_tonnes": {
            "type": [
              "number",
              "null"
            ]
          },
          "pct_of_total_reserves": {
            "type": [
              "number",
              "null"
            ]
          },
          "source": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "rank",
          "country_code",
          "country",
          "report_date",
          "holdings_tonnes",
          "change_tonnes",
          "pct_of_total_reserves",
          "source"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "report_date",
    "items",
    "url"
  ],
  "additionalProperties": false
}

{
  "report_date": "2026-10-09T00:00:00.000Z",
  "items": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_gold_supply_demand

The quarterly global gold balance sheet stored by EL7 (tonnes): mine production, recycling and total supply against jewelry, technology, investment (bar/coin, ETF), central-bank demand and total demand, with the surplus/deficit and its share of demand, newest quarter first. Use it to explain what drives gold demand (jewelry vs investment vs central banks) and whether the market is in surplus. See el7_gold_reserves for country-level central-bank holdings and el7_gold_flows for ETF flows.

gold · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "quarters": {
      "default": 8,
      "description": "Number of most recent quarters (1-40, default 8).",
      "type": "integer",
      "minimum": 1,
      "maximum": 40
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "year": {
            "type": "number"
          },
          "quarter": {
            "type": "number"
          },
          "mine_production_tonnes": {
            "type": [
              "number",
              "null"
            ]
          },
          "recycled_gold_tonnes": {
            "type": [
              "number",
              "null"
            ]
          },
          "total_supply_tonnes": {
            "type": [
              "number",
              "null"
            ]
          },
          "jewelry_tonnes": {
            "type": [
              "number",
              "null"
            ]
          },
          "technology_tonnes": {
            "type": [
              "number",
              "null"
            ]
          },
          "investment_tonnes": {
            "type": [
              "number",
              "null"
            ]
          },
          "bar_coin_tonnes": {
            "type": [
              "number",
              "null"
            ]
          },
          "etf_tonnes": {
            "type": [
              "number",
              "null"
            ]
          },
          "central_bank_tonnes": {
            "type": [
              "number",
              "null"
            ]
          },
          "total_demand_tonnes": {
            "type": [
              "number",
              "null"
            ]
          },
          "surplus_deficit_tonnes": {
            "type": [
              "number",
              "null"
            ]
          },
          "surplus_deficit_pct_of_demand": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "year",
          "quarter",
          "mine_production_tonnes",
          "recycled_gold_tonnes",
          "total_supply_tonnes",
          "jewelry_tonnes",
          "technology_tonnes",
          "investment_tonnes",
          "bar_coin_tonnes",
          "etf_tonnes",
          "central_bank_tonnes",
          "total_demand_tonnes",
          "surplus_deficit_tonnes",
          "surplus_deficit_pct_of_demand"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "items",
    "url"
  ],
  "additionalProperties": false
}

{
  "items": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_gold_macro

The macro series EL7 tracks as gold drivers (FRED data): 10Y real yield, 5Y/10Y breakeven inflation, Fed funds rate, M2, Fed balance sheet, CPI, Fort Knox reserves and gold-mining output. Latest value with change for each, or one series' history, plus optionally each driver's correlation with gold. Use it to explain the rates and inflation backdrop. The dollar index and volatility indices appear only as scored inputs of el7_gold_overview. No gold prices are returned.

gold · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "series_id": {
      "description": "One macro series for its history: DFII10 (10Y real yield), T10YIE / T5YIE (breakeven inflation), DFF (Fed funds), M2SL (M2), WALCL (Fed balance sheet), CPIAUCSL (CPI), FKKYGTA (Fort Knox gold), IPG21222S (gold-mining output index). Omit for the latest value of all.",
      "type": "string",
      "enum": [
        "DFII10",
        "T10YIE",
        "T5YIE",
        "DFF",
        "M2SL",
        "WALCL",
        "CPIAUCSL",
        "FKKYGTA",
        "IPG21222S"
      ]
    },
    "periods": {
      "default": 30,
      "description": "History length when series_id is given (1-120, default 30).",
      "type": "integer",
      "minimum": 1,
      "maximum": 120
    },
    "include_correlations": {
      "default": false,
      "description": "Also return the Pearson correlation of each macro series (including dollar and volatility) with gold over about one trading year. Slower; default false.",
      "type": "boolean"
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "series": {
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "series_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "units": {
            "type": [
              "string",
              "null"
            ]
          },
          "frequency": {
            "type": [
              "string",
              "null"
            ]
          },
          "date": {
            "type": [
              "string",
              "null"
            ]
          },
          "value": {
            "type": [
              "number",
              "null"
            ]
          },
          "change": {
            "type": [
              "number",
              "null"
            ]
          },
          "change_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "history": {
            "maxItems": 120,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string"
                },
                "value": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "change": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "change_pct": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "date",
                "value",
                "change",
                "change_pct"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "series_id",
          "name",
          "category",
          "units",
          "frequency",
          "date",
          "value",
          "change",
          "change_pct",
          "history"
        ],
        "additionalProperties": false
      }
    },
    "correlations": {
      "anyOf": [
        {
          "maxItems": 12,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "series_id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "correlation": {
                "type": "number"
              },
              "observations": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "series_id",
              "name",
              "correlation",
              "observations"
            ],
            "additionalProperties": false
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "series",
    "correlations",
    "url"
  ],
  "additionalProperties": false
}

{
  "series": [],
  "correlations": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_research_list

List EL7's published research articles (about 280: AI capex, central banks, energy, gold, crypto, deals, macro), newest first, with title, verdict/excerpt, date, reading time and a link. Filter by text in the title/excerpt (`query`), sector, or a publication date range, and page with `offset`. In English only articles that already have an English edition are listed (as on the website); in Arabic, all of them. Use this to find an article or see what EL7 has published on a topic, then call el7_research_article with the slug to read it. Mirrors https://el7.ai/ar/research.

research · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "query": {
      "description": "Case-insensitive text to find in titles and excerpts.",
      "type": "string",
      "minLength": 2,
      "maxLength": 100
    },
    "sector": {
      "description": "Filter to one research sector. Few articles carry a sector yet, so prefer `query` for topic search.",
      "type": "string",
      "enum": [
        "ai",
        "cb",
        "energy",
        "metals",
        "crypto",
        "deals",
        "macro"
      ]
    },
    "from": {
      "description": "Published on or after this date (YYYY-MM-DD).",
      "type": "string"
    },
    "to": {
      "description": "Published on or before this date (YYYY-MM-DD).",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Rows to return (1-50, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "default": 0,
      "description": "Rows to skip, for paging (use next_offset from the previous response).",
      "type": "integer",
      "minimum": 0,
      "maximum": 5000
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "summary": {
            "description": "Excerpt (or, for research, the authored verdict line when one exists).",
            "type": [
              "string",
              "null"
            ]
          },
          "published_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "updated_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "reading_time_minutes": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "word_count": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "sector": {
            "description": "Research sector code (ai, cb, energy, metals, crypto, deals, macro) when assigned.",
            "type": [
              "string",
              "null"
            ]
          },
          "category": {
            "type": "string"
          },
          "content_type": {
            "type": "string"
          },
          "language": {
            "type": "string",
            "enum": [
              "ar",
              "en"
            ],
            "description": "Language of title/summary as returned."
          },
          "has_english": {
            "type": "boolean",
            "description": "True when an English edition exists."
          },
          "is_paid": {
            "type": "boolean",
            "description": "True when the article is a paid page on the website."
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "title",
          "summary",
          "published_at",
          "updated_at",
          "reading_time_minutes",
          "word_count",
          "sector",
          "category",
          "content_type",
          "language",
          "has_english",
          "is_paid",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "total": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Total rows matching the filters."
    },
    "returned": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "offset": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "has_more": {
      "type": "boolean"
    },
    "next_offset": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "items",
    "total",
    "returned",
    "offset",
    "has_more",
    "next_offset"
  ],
  "additionalProperties": false
}

{
  "items": [],
  "total": 0,
  "returned": 0,
  "offset": 0,
  "has_more": false,
  "next_offset": 0
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_research_article

Read one EL7 research article as clean plain text (charts and styling removed, tables flattened with ' | '). Long articles are paged: the response carries total_chars, truncated and next_offset — call again with offset=next_offset to continue; max_chars bounds each slice (default 12,000). Returns the English edition when the language is English and one exists, otherwise the Arabic original (body_language says which). Get slugs from el7_research_list. Mirrors https://el7.ai/ar/research/<slug>.

research · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[a-z0-9][a-z0-9_-]{0,254}$",
      "description": "Research article slug, e.g. 'ai-capex-power' (from el7_research_list)."
    },
    "max_chars": {
      "default": 12000,
      "description": "Maximum characters of article text to return (500-60000, default 12000). Long articles are paged with offset.",
      "type": "integer",
      "minimum": 500,
      "maximum": 60000
    },
    "offset": {
      "default": 0,
      "description": "Character offset to start from; use next_offset from a truncated response to read the rest.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "summary": {
      "type": [
        "string",
        "null"
      ]
    },
    "category": {
      "type": "string"
    },
    "content_type": {
      "type": "string"
    },
    "published_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "updated_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "reading_time_minutes": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "word_count": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "is_paid": {
      "type": "boolean"
    },
    "title_language": {
      "type": "string",
      "enum": [
        "ar",
        "en"
      ]
    },
    "body_language": {
      "type": "string",
      "enum": [
        "ar",
        "en"
      ],
      "description": "Language of `text`. Falls back to the other language when the requested edition does not exist."
    },
    "body_available": {
      "type": "boolean",
      "description": "False when the stored body could not be read; `text` is then empty and `summary` is all that is held."
    },
    "text": {
      "type": "string",
      "description": "Article text for this slice (plain text, no HTML)."
    },
    "offset": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "returned_chars": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "total_chars": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "truncated": {
      "type": "boolean"
    },
    "next_offset": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "url": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "slug",
    "title",
    "summary",
    "category",
    "content_type",
    "published_at",
    "updated_at",
    "reading_time_minutes",
    "word_count",
    "is_paid",
    "title_language",
    "body_language",
    "body_available",
    "text",
    "offset",
    "returned_chars",
    "total_chars",
    "truncated",
    "next_offset",
    "url"
  ],
  "additionalProperties": false
}

{
  "slug": "example",
  "title": "example",
  "summary": "example",
  "category": "example",
  "content_type": "example",
  "published_at": "2026-10-09T00:00:00.000Z",
  "updated_at": "2026-10-09T00:00:00.000Z",
  "reading_time_minutes": 0,
  "word_count": 0,
  "is_paid": false,
  "title_language": "ar",
  "body_language": "ar",
  "body_available": false,
  "text": "example",
  "offset": 0,
  "returned_chars": 0,
  "total_chars": 0,
  "truncated": false,
  "next_offset": 0,
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_insights_list

List EL7 insights — market updates (weekly live coverage), education and tutorials — newest first, with excerpt, date, category and link. Filter by text, hub section (`content_type`), `category`, `tag`, `series` or a date range; page with `offset`. Research articles are excluded unless content_type='research' (use el7_research_list for those). Interviews are listed by el7_interviews_list. Read the full text with el7_insight. Mirrors https://el7.ai/ar/insights and its category / series / tag pages.

research · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "query": {
      "description": "Case-insensitive text to find in titles and excerpts.",
      "type": "string",
      "minLength": 2,
      "maxLength": 100
    },
    "content_type": {
      "description": "Hub section. Omit for market updates and education (research has its own tool).",
      "type": "string",
      "enum": [
        "market_update",
        "education",
        "research"
      ]
    },
    "category": {
      "description": "Category slug, e.g. 'market-updates', 'education', 'product-tutorials'.",
      "type": "string",
      "minLength": 1,
      "maxLength": 30,
      "pattern": "^[a-z0-9-]+$"
    },
    "tag": {
      "description": "Tag slug.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "pattern": "^[a-z0-9-]+$"
    },
    "series": {
      "description": "Series slug.",
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[a-z0-9-]+$"
    },
    "from": {
      "description": "Published on or after this date (YYYY-MM-DD).",
      "type": "string"
    },
    "to": {
      "description": "Published on or before this date (YYYY-MM-DD).",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Rows to return (1-50, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "default": 0,
      "description": "Rows to skip, for paging (use next_offset from the previous response).",
      "type": "integer",
      "minimum": 0,
      "maximum": 5000
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "summary": {
            "description": "Excerpt (or, for research, the authored verdict line when one exists).",
            "type": [
              "string",
              "null"
            ]
          },
          "published_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "updated_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "reading_time_minutes": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "word_count": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "sector": {
            "description": "Research sector code (ai, cb, energy, metals, crypto, deals, macro) when assigned.",
            "type": [
              "string",
              "null"
            ]
          },
          "category": {
            "type": "string"
          },
          "content_type": {
            "type": "string"
          },
          "language": {
            "type": "string",
            "enum": [
              "ar",
              "en"
            ],
            "description": "Language of title/summary as returned."
          },
          "has_english": {
            "type": "boolean",
            "description": "True when an English edition exists."
          },
          "is_paid": {
            "type": "boolean",
            "description": "True when the article is a paid page on the website."
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "title",
          "summary",
          "published_at",
          "updated_at",
          "reading_time_minutes",
          "word_count",
          "sector",
          "category",
          "content_type",
          "language",
          "has_english",
          "is_paid",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "total": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Total rows matching the filters."
    },
    "returned": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "offset": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "has_more": {
      "type": "boolean"
    },
    "next_offset": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "items",
    "total",
    "returned",
    "offset",
    "has_more",
    "next_offset"
  ],
  "additionalProperties": false
}

{
  "items": [],
  "total": 0,
  "returned": 0,
  "offset": 0,
  "has_more": false,
  "next_offset": 0
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_insight

Read one EL7 insight (market update, live-coverage digest, education article) as clean plain text, paged like el7_research_article (total_chars / truncated / next_offset; max_chars bounds each slice). Get slugs from el7_insights_list. Research articles and interviews have their own tools (el7_research_article, el7_interview). Mirrors https://el7.ai/ar/post/<slug>.

research · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[a-z0-9][a-z0-9_-]{0,254}$",
      "description": "Insight slug, e.g. 'live-coverage-2026-10-05' (from el7_insights_list)."
    },
    "max_chars": {
      "default": 12000,
      "description": "Maximum characters of article text to return (500-60000, default 12000). Long articles are paged with offset.",
      "type": "integer",
      "minimum": 500,
      "maximum": 60000
    },
    "offset": {
      "default": 0,
      "description": "Character offset to start from; use next_offset from a truncated response to read the rest.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "summary": {
      "type": [
        "string",
        "null"
      ]
    },
    "category": {
      "type": "string"
    },
    "content_type": {
      "type": "string"
    },
    "published_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "updated_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "reading_time_minutes": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "word_count": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "is_paid": {
      "type": "boolean"
    },
    "title_language": {
      "type": "string",
      "enum": [
        "ar",
        "en"
      ]
    },
    "body_language": {
      "type": "string",
      "enum": [
        "ar",
        "en"
      ],
      "description": "Language of `text`. Falls back to the other language when the requested edition does not exist."
    },
    "body_available": {
      "type": "boolean",
      "description": "False when the stored body could not be read; `text` is then empty and `summary` is all that is held."
    },
    "text": {
      "type": "string",
      "description": "Article text for this slice (plain text, no HTML)."
    },
    "offset": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "returned_chars": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "total_chars": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "truncated": {
      "type": "boolean"
    },
    "next_offset": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "url": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "slug",
    "title",
    "summary",
    "category",
    "content_type",
    "published_at",
    "updated_at",
    "reading_time_minutes",
    "word_count",
    "is_paid",
    "title_language",
    "body_language",
    "body_available",
    "text",
    "offset",
    "returned_chars",
    "total_chars",
    "truncated",
    "next_offset",
    "url"
  ],
  "additionalProperties": false
}

{
  "slug": "example",
  "title": "example",
  "summary": "example",
  "category": "example",
  "content_type": "example",
  "published_at": "2026-10-09T00:00:00.000Z",
  "updated_at": "2026-10-09T00:00:00.000Z",
  "reading_time_minutes": 0,
  "word_count": 0,
  "is_paid": false,
  "title_language": "ar",
  "body_language": "ar",
  "body_available": false,
  "text": "example",
  "offset": 0,
  "returned_chars": 0,
  "total_chars": 0,
  "truncated": false,
  "next_offset": 0,
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_interviews_list

List EL7's published interviews and market conversations, newest first, with excerpt, date and link. Free content on the website. Read one in full with el7_interview. Mirrors https://el7.ai/ar/interviews.

research · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "query": {
      "description": "Case-insensitive text to find in titles and excerpts.",
      "type": "string",
      "minLength": 2,
      "maxLength": 100
    },
    "from": {
      "description": "Published on or after this date (YYYY-MM-DD).",
      "type": "string"
    },
    "to": {
      "description": "Published on or before this date (YYYY-MM-DD).",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Rows to return (1-50, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "default": 0,
      "description": "Rows to skip, for paging (use next_offset from the previous response).",
      "type": "integer",
      "minimum": 0,
      "maximum": 5000
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "summary": {
            "description": "Excerpt (or, for research, the authored verdict line when one exists).",
            "type": [
              "string",
              "null"
            ]
          },
          "published_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "updated_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "reading_time_minutes": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "word_count": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "sector": {
            "description": "Research sector code (ai, cb, energy, metals, crypto, deals, macro) when assigned.",
            "type": [
              "string",
              "null"
            ]
          },
          "category": {
            "type": "string"
          },
          "content_type": {
            "type": "string"
          },
          "language": {
            "type": "string",
            "enum": [
              "ar",
              "en"
            ],
            "description": "Language of title/summary as returned."
          },
          "has_english": {
            "type": "boolean",
            "description": "True when an English edition exists."
          },
          "is_paid": {
            "type": "boolean",
            "description": "True when the article is a paid page on the website."
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "title",
          "summary",
          "published_at",
          "updated_at",
          "reading_time_minutes",
          "word_count",
          "sector",
          "category",
          "content_type",
          "language",
          "has_english",
          "is_paid",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "total": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Total rows matching the filters."
    },
    "returned": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "offset": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "has_more": {
      "type": "boolean"
    },
    "next_offset": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "items",
    "total",
    "returned",
    "offset",
    "has_more",
    "next_offset"
  ],
  "additionalProperties": false
}

{
  "items": [],
  "total": 0,
  "returned": 0,
  "offset": 0,
  "has_more": false,
  "next_offset": 0
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_interview

Read one EL7 interview as clean plain text, paged like el7_research_article (total_chars / truncated / next_offset; max_chars bounds each slice). Get slugs from el7_interviews_list. Mirrors https://el7.ai/ar/interviews/<slug>.

research · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[a-z0-9][a-z0-9_-]{0,254}$",
      "description": "Interview slug (from el7_interviews_list)."
    },
    "max_chars": {
      "default": 12000,
      "description": "Maximum characters of article text to return (500-60000, default 12000). Long articles are paged with offset.",
      "type": "integer",
      "minimum": 500,
      "maximum": 60000
    },
    "offset": {
      "default": 0,
      "description": "Character offset to start from; use next_offset from a truncated response to read the rest.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "summary": {
      "type": [
        "string",
        "null"
      ]
    },
    "category": {
      "type": "string"
    },
    "content_type": {
      "type": "string"
    },
    "published_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "updated_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "reading_time_minutes": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "word_count": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "is_paid": {
      "type": "boolean"
    },
    "title_language": {
      "type": "string",
      "enum": [
        "ar",
        "en"
      ]
    },
    "body_language": {
      "type": "string",
      "enum": [
        "ar",
        "en"
      ],
      "description": "Language of `text`. Falls back to the other language when the requested edition does not exist."
    },
    "body_available": {
      "type": "boolean",
      "description": "False when the stored body could not be read; `text` is then empty and `summary` is all that is held."
    },
    "text": {
      "type": "string",
      "description": "Article text for this slice (plain text, no HTML)."
    },
    "offset": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "returned_chars": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "total_chars": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "truncated": {
      "type": "boolean"
    },
    "next_offset": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "url": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "slug",
    "title",
    "summary",
    "category",
    "content_type",
    "published_at",
    "updated_at",
    "reading_time_minutes",
    "word_count",
    "is_paid",
    "title_language",
    "body_language",
    "body_available",
    "text",
    "offset",
    "returned_chars",
    "total_chars",
    "truncated",
    "next_offset",
    "url"
  ],
  "additionalProperties": false
}

{
  "slug": "example",
  "title": "example",
  "summary": "example",
  "category": "example",
  "content_type": "example",
  "published_at": "2026-10-09T00:00:00.000Z",
  "updated_at": "2026-10-09T00:00:00.000Z",
  "reading_time_minutes": 0,
  "word_count": 0,
  "is_paid": false,
  "title_language": "ar",
  "body_language": "ar",
  "body_available": false,
  "text": "example",
  "offset": 0,
  "returned_chars": 0,
  "total_chars": 0,
  "truncated": false,
  "next_offset": 0,
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_insider_trades

Lists recent open-market insider purchases and sales filed with the SEC (Form 4), newest first, with the insider, company, shares, filed price and total value. Filter by ticker, insider name, buy/sell, minimum value, window and executives only. Derivative lines, amended lines and placeholder tickers are excluded, as on the EL7 /insider-trading page. Use el7_insider with an insider_slug for one insider's profile and history; for Congress members use el7_congress_trades.

trading_activity · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "symbol": {
      "description": "Issuer ticker, e.g. 'NVDA'. Omit for market-wide.",
      "type": "string",
      "minLength": 1,
      "maxLength": 12,
      "pattern": "^[A-Za-z0-9.\\-]+$"
    },
    "insider": {
      "description": "Part of an insider's name, e.g. 'Huang'. Matches EL7 insider profiles; use el7_insider with the returned insider_slug for full detail.",
      "type": "string",
      "minLength": 2,
      "maxLength": 80
    },
    "side": {
      "default": "both",
      "description": "'buy' = open-market purchases (code P), 'sell' = open-market sales (code S), 'both' = either.",
      "type": "string",
      "enum": [
        "buy",
        "sell",
        "both"
      ]
    },
    "min_value_usd": {
      "description": "Only lines whose filed total value is at least this many USD.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000000
    },
    "days": {
      "default": 30,
      "description": "Look-back window in days, by transaction date (max 365).",
      "type": "integer",
      "minimum": 1,
      "maximum": 365
    },
    "executives_only": {
      "default": false,
      "description": "Only filings with an officer or director among the reporting owners.",
      "type": "boolean"
    },
    "limit": {
      "default": 20,
      "description": "Rows to return (max 50). Newest first.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "company": {
            "type": [
              "string",
              "null"
            ]
          },
          "insider_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "insider_slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "insider_role": {
            "type": [
              "string",
              "null"
            ]
          },
          "side": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "buy",
                  "sell"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "transaction_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "filing_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "shares": {
            "type": [
              "number",
              "null"
            ]
          },
          "price_per_share": {
            "type": [
              "number",
              "null"
            ]
          },
          "total_value_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "shares_owned_after": {
            "type": [
              "number",
              "null"
            ]
          },
          "ownership": {
            "type": [
              "string",
              "null"
            ]
          },
          "under_10b5_1_plan": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "form_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "sec_filing_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "id",
          "symbol",
          "company",
          "insider_name",
          "insider_slug",
          "insider_role",
          "side",
          "transaction_date",
          "filing_date",
          "shares",
          "price_per_share",
          "total_value_usd",
          "shares_owned_after",
          "ownership",
          "under_10b5_1_plan",
          "form_type",
          "sec_filing_url",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "total_matching": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "returned_buy_value_usd": {
      "type": "number"
    },
    "returned_sell_value_usd": {
      "type": "number"
    },
    "window_days": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "items",
    "total_matching",
    "returned_buy_value_usd",
    "returned_sell_value_usd",
    "window_days"
  ],
  "additionalProperties": false
}

{
  "items": [],
  "total_matching": 0,
  "returned_buy_value_usd": 0,
  "returned_sell_value_usd": 0,
  "window_days": 0
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_insider

One corporate insider's EL7 profile: role, lifetime buy/sell totals, number of companies, returns-based performance score and win rate, and their most recent open-market trades. Use after el7_insider_trades gives you an insider_slug. Mirrors the /insider-trading/insiders page (AI-written commentary is not included).

trading_activity · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Insider profile slug as returned by el7_insider_trades (insider_slug), e.g. 'benioff-marc'."
    },
    "recent_trades": {
      "default": 10,
      "description": "How many of the insider's most recent open-market trades to include (0-25).",
      "type": "integer",
      "minimum": 0,
      "maximum": 25
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "is_person": {
      "type": "boolean"
    },
    "primary_role": {
      "type": [
        "string",
        "null"
      ]
    },
    "primary_title": {
      "type": [
        "string",
        "null"
      ]
    },
    "bio": {
      "type": [
        "string",
        "null"
      ]
    },
    "first_trade_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "last_trade_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "totals": {
      "type": "object",
      "properties": {
        "trades": {
          "type": [
            "number",
            "null"
          ]
        },
        "buys": {
          "type": [
            "number",
            "null"
          ]
        },
        "sells": {
          "type": [
            "number",
            "null"
          ]
        },
        "companies": {
          "type": [
            "number",
            "null"
          ]
        },
        "buy_value_usd": {
          "type": [
            "number",
            "null"
          ]
        },
        "sell_value_usd": {
          "type": [
            "number",
            "null"
          ]
        },
        "net_value_usd": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "trades",
        "buys",
        "sells",
        "companies",
        "buy_value_usd",
        "sell_value_usd",
        "net_value_usd"
      ],
      "additionalProperties": false
    },
    "performance": {
      "type": "object",
      "properties": {
        "score": {
          "type": [
            "number",
            "null"
          ]
        },
        "win_rate": {
          "type": [
            "number",
            "null"
          ]
        },
        "avg_return_3m_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "avg_return_6m_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "avg_return_12m_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "trades_scored": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "score",
        "win_rate",
        "avg_return_3m_pct",
        "avg_return_6m_pct",
        "avg_return_12m_pct",
        "trades_scored"
      ],
      "additionalProperties": false
    },
    "stats_computed_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "recent_trades": {
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "company": {
            "type": [
              "string",
              "null"
            ]
          },
          "insider_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "insider_slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "insider_role": {
            "type": [
              "string",
              "null"
            ]
          },
          "side": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "buy",
                  "sell"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "transaction_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "filing_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "shares": {
            "type": [
              "number",
              "null"
            ]
          },
          "price_per_share": {
            "type": [
              "number",
              "null"
            ]
          },
          "total_value_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "shares_owned_after": {
            "type": [
              "number",
              "null"
            ]
          },
          "ownership": {
            "type": [
              "string",
              "null"
            ]
          },
          "under_10b5_1_plan": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "form_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "sec_filing_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "id",
          "symbol",
          "company",
          "insider_name",
          "insider_slug",
          "insider_role",
          "side",
          "transaction_date",
          "filing_date",
          "shares",
          "price_per_share",
          "total_value_usd",
          "shares_owned_after",
          "ownership",
          "under_10b5_1_plan",
          "form_type",
          "sec_filing_url",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "slug",
    "name",
    "is_person",
    "primary_role",
    "primary_title",
    "bio",
    "first_trade_date",
    "last_trade_date",
    "totals",
    "performance",
    "stats_computed_at",
    "recent_trades",
    "url"
  ],
  "additionalProperties": false
}

{
  "slug": "example",
  "name": "example",
  "is_person": false,
  "primary_role": "example",
  "primary_title": "example",
  "bio": "example",
  "first_trade_date": "2026-10-09T00:00:00.000Z",
  "last_trade_date": "2026-10-09T00:00:00.000Z",
  "totals": {
    "trades": 0,
    "buys": 0,
    "sells": 0,
    "companies": 0,
    "buy_value_usd": 0,
    "sell_value_usd": 0,
    "net_value_usd": 0
  },
  "performance": {
    "score": 0,
    "win_rate": 0,
    "avg_return_3m_pct": 0,
    "avg_return_6m_pct": 0,
    "avg_return_12m_pct": 0,
    "trades_scored": 0
  },
  "stats_computed_at": "2026-10-09T00:00:00.000Z",
  "recent_trades": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_congress_trades

Lists US Senate and House periodic transaction disclosures, newest filing first: member, party, ticker, buy/sell, transaction and filing dates, disclosure lag and the disclosed dollar BRACKET (never a point estimate). Filter by member name, ticker, chamber, party, side, minimum amount and window. Mirrors the EL7 /congressional-trading page. Use el7_congress_member for one member's summary; for corporate insiders use el7_insider_trades.

trading_activity · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "member": {
      "description": "Part of a member's name, e.g. 'Pelosi'.",
      "type": "string",
      "minLength": 2,
      "maxLength": 80
    },
    "symbol": {
      "description": "Ticker symbol the member traded, e.g. 'NVDA'.",
      "type": "string",
      "minLength": 1,
      "maxLength": 12,
      "pattern": "^[A-Za-z0-9.\\-]+$"
    },
    "chamber": {
      "description": "Restrict to one chamber.",
      "type": "string",
      "enum": [
        "senate",
        "house"
      ]
    },
    "party": {
      "description": "Member party (from EL7's people records).",
      "type": "string",
      "enum": [
        "democrat",
        "republican",
        "independent"
      ]
    },
    "side": {
      "default": "both",
      "description": "'buy' = purchases, 'sell' = sales (full or partial), 'both' = all.",
      "type": "string",
      "enum": [
        "buy",
        "sell",
        "both"
      ]
    },
    "min_amount_usd": {
      "description": "Only trades whose disclosed bracket upper bound is at least this many USD.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000
    },
    "days": {
      "default": 90,
      "description": "Look-back window in days, by FILING date (max 730).",
      "type": "integer",
      "minimum": 1,
      "maximum": 730
    },
    "stocks_only": {
      "default": true,
      "description": "Only trades with a ticker (default). Set false to include funds, bonds and other assets without one.",
      "type": "boolean"
    },
    "limit": {
      "default": 20,
      "description": "Rows to return (max 50). Newest filing first.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "member": {
            "type": "string"
          },
          "member_slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "chamber": {
            "type": "string",
            "enum": [
              "senate",
              "house"
            ]
          },
          "party": {
            "type": [
              "string",
              "null"
            ]
          },
          "state": {
            "type": [
              "string",
              "null"
            ]
          },
          "district": {
            "type": [
              "string",
              "null"
            ]
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "asset": {
            "type": [
              "string",
              "null"
            ]
          },
          "asset_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "side": {
            "type": "string",
            "enum": [
              "buy",
              "sell",
              "exchange",
              "other"
            ]
          },
          "sale_kind": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "full",
                  "partial"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "transaction_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "filing_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "disclosure_lag_days": {
            "type": [
              "number",
              "null"
            ]
          },
          "amount_range": {
            "type": [
              "string",
              "null"
            ]
          },
          "amount_low_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "amount_high_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "exact_value_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "owner": {
            "type": [
              "string",
              "null"
            ]
          },
          "filing_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "id",
          "member",
          "member_slug",
          "chamber",
          "party",
          "state",
          "district",
          "symbol",
          "asset",
          "asset_type",
          "side",
          "sale_kind",
          "transaction_date",
          "filing_date",
          "disclosure_lag_days",
          "amount_range",
          "amount_low_usd",
          "amount_high_usd",
          "exact_value_usd",
          "owner",
          "filing_url",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "total_matching": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "window_days": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "items",
    "total_matching",
    "window_days"
  ],
  "additionalProperties": false
}

{
  "items": [],
  "total_matching": 0,
  "window_days": 0
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_congress_member

One Congress member's disclosed trading over a window: counts of buys and sells, total disclosed dollar brackets, most-traded tickers and their latest trades. Accepts a name fragment or the member_slug from el7_congress_trades; an ambiguous name returns the candidate slugs. Amounts are disclosure brackets, so totals are ranges (low..high).

trading_activity · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "member": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "A member's EL7 people slug (e.g. 'jared-moskowitz', as returned in member_slug) or part of their name."
    },
    "days": {
      "default": 365,
      "description": "Look-back window in days by filing date for the summary and recent trades (max 1825).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1825
    },
    "recent_trades": {
      "default": 10,
      "description": "How many of the member's most recent trades to include (0-25).",
      "type": "integer",
      "minimum": 0,
      "maximum": 25
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "member"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "member": {
      "type": "string"
    },
    "member_slug": {
      "type": [
        "string",
        "null"
      ]
    },
    "chamber": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "senate",
            "house"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "party": {
      "type": [
        "string",
        "null"
      ]
    },
    "state": {
      "type": [
        "string",
        "null"
      ]
    },
    "district": {
      "type": [
        "string",
        "null"
      ]
    },
    "window_days": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "summary_stats": {
      "type": "object",
      "properties": {
        "trades": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "buys": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "sells": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "distinct_symbols": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "buy_low_usd": {
          "type": "number"
        },
        "buy_high_usd": {
          "type": "number"
        },
        "sell_low_usd": {
          "type": "number"
        },
        "sell_high_usd": {
          "type": "number"
        },
        "first_filing_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "last_filing_date": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "trades",
        "buys",
        "sells",
        "distinct_symbols",
        "buy_low_usd",
        "buy_high_usd",
        "sell_low_usd",
        "sell_high_usd",
        "first_filing_date",
        "last_filing_date"
      ],
      "additionalProperties": false
    },
    "top_symbols": {
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string"
          },
          "trades": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "buys": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "sells": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "symbol",
          "trades",
          "buys",
          "sells"
        ],
        "additionalProperties": false
      }
    },
    "recent_trades": {
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "member": {
            "type": "string"
          },
          "member_slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "chamber": {
            "type": "string",
            "enum": [
              "senate",
              "house"
            ]
          },
          "party": {
            "type": [
              "string",
              "null"
            ]
          },
          "state": {
            "type": [
              "string",
              "null"
            ]
          },
          "district": {
            "type": [
              "string",
              "null"
            ]
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "asset": {
            "type": [
              "string",
              "null"
            ]
          },
          "asset_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "side": {
            "type": "string",
            "enum": [
              "buy",
              "sell",
              "exchange",
              "other"
            ]
          },
          "sale_kind": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "full",
                  "partial"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "transaction_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "filing_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "disclosure_lag_days": {
            "type": [
              "number",
              "null"
            ]
          },
          "amount_range": {
            "type": [
              "string",
              "null"
            ]
          },
          "amount_low_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "amount_high_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "exact_value_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "owner": {
            "type": [
              "string",
              "null"
            ]
          },
          "filing_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "id",
          "member",
          "member_slug",
          "chamber",
          "party",
          "state",
          "district",
          "symbol",
          "asset",
          "asset_type",
          "side",
          "sale_kind",
          "transaction_date",
          "filing_date",
          "disclosure_lag_days",
          "amount_range",
          "amount_low_usd",
          "amount_high_usd",
          "exact_value_usd",
          "owner",
          "filing_url",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "member",
    "member_slug",
    "chamber",
    "party",
    "state",
    "district",
    "window_days",
    "summary_stats",
    "top_symbols",
    "recent_trades",
    "url"
  ],
  "additionalProperties": false
}

{
  "member": "example",
  "member_slug": "example",
  "chamber": "senate",
  "party": "example",
  "state": "example",
  "district": "example",
  "window_days": 0,
  "summary_stats": {
    "trades": 0,
    "buys": 0,
    "sells": 0,
    "distinct_symbols": 0,
    "buy_low_usd": 0,
    "buy_high_usd": 0,
    "sell_low_usd": 0,
    "sell_high_usd": 0,
    "first_filing_date": "2026-10-09T00:00:00.000Z",
    "last_filing_date": "2026-10-09T00:00:00.000Z"
  },
  "top_symbols": [],
  "recent_trades": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_predictions_markets

Lists prediction markets (Polymarket odds as stored by EL7) on rates, geopolitics, growth, commodities and more: title, category, end date, volume, liquidity and the top outcomes with their implied probabilities and one-day change. status='active' shows live markets; status='resolved' shows the archive. Filter by category or text search. Use el7_prediction with a slug for one market's full outcome list, history summary and resolution rules.

predictions · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "status": {
      "default": "active",
      "description": "'active' = live markets still trading; 'resolved' = the archive of ended or closed markets (newest end date first).",
      "type": "string",
      "enum": [
        "active",
        "resolved"
      ]
    },
    "category": {
      "description": "Category slug, e.g. 'central_bank_rate', 'geopolitics', 'gdp_growth', 'commodity_price', 'crypto_price', 'employment'.",
      "type": "string",
      "minLength": 1,
      "maxLength": 50,
      "pattern": "^[a-z_]+$"
    },
    "search": {
      "description": "Text to find in the market title (English or Arabic) or slug.",
      "type": "string",
      "minLength": 2,
      "maxLength": 80
    },
    "sort": {
      "default": "volume",
      "description": "'volume' = most traded, 'ending_soon' = nearest end date, 'recent' = most recently updated odds. Ignored for status='resolved' (always newest end date first).",
      "type": "string",
      "enum": [
        "volume",
        "ending_soon",
        "recent"
      ]
    },
    "limit": {
      "default": 20,
      "description": "Rows to return (max 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "default": 0,
      "description": "Rows to skip, for paging.",
      "type": "integer",
      "minimum": 0,
      "maximum": 5000
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "active",
              "closed",
              "resolved"
            ]
          },
          "end_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "total_volume_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "liquidity_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "resolved_outcome": {
            "type": [
              "string",
              "null"
            ]
          },
          "top_outcomes": {
            "maxItems": 5,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "probability": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "one_day_change": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "volume_usd": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "name",
                "probability",
                "one_day_change",
                "volume_usd"
              ],
              "additionalProperties": false
            }
          },
          "odds_as_of": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "slug",
          "title",
          "category",
          "status",
          "end_date",
          "total_volume_usd",
          "liquidity_usd",
          "resolved_outcome",
          "top_outcomes",
          "odds_as_of",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "total_matching": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "has_more": {
      "type": "boolean"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "items",
    "total_matching",
    "has_more"
  ],
  "additionalProperties": false
}

{
  "items": [],
  "total_matching": 0,
  "has_more": false
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_prediction

Full detail of one prediction market: every outcome's current implied probability, volume, liquidity, spread and open interest, a per-outcome summary of the last day of odds (start, end, change, low, high), and the resolution state (proposed/resolved outcome, dispute state, settlement source and rules text). Get the slug from el7_predictions_markets. Odds are market-implied probabilities, not EL7 forecasts.

predictions · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "Market slug as returned by el7_predictions_markets (slug), e.g. 'how-many-fed-rate-cuts-in-2026'."
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "category": {
      "type": [
        "string",
        "null"
      ]
    },
    "event_type": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "closed",
        "resolved"
      ]
    },
    "end_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "total_volume_usd": {
      "type": [
        "number",
        "null"
      ]
    },
    "liquidity_usd": {
      "type": [
        "number",
        "null"
      ]
    },
    "open_interest_usd": {
      "type": [
        "number",
        "null"
      ]
    },
    "spread": {
      "type": [
        "number",
        "null"
      ]
    },
    "outcomes": {
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "probability": {
            "type": [
              "number",
              "null"
            ]
          },
          "one_day_change": {
            "type": [
              "number",
              "null"
            ]
          },
          "volume_usd": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "name",
          "probability",
          "one_day_change",
          "volume_usd"
        ],
        "additionalProperties": false
      }
    },
    "history": {
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "outcome": {
            "type": "string"
          },
          "points": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "from": {
            "type": [
              "string",
              "null"
            ]
          },
          "to": {
            "type": [
              "string",
              "null"
            ]
          },
          "start_probability": {
            "type": [
              "number",
              "null"
            ]
          },
          "end_probability": {
            "type": [
              "number",
              "null"
            ]
          },
          "change": {
            "type": [
              "number",
              "null"
            ]
          },
          "low": {
            "type": [
              "number",
              "null"
            ]
          },
          "high": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "outcome",
          "points",
          "from",
          "to",
          "start_probability",
          "end_probability",
          "change",
          "low",
          "high"
        ],
        "additionalProperties": false
      }
    },
    "history_interval": {
      "type": [
        "string",
        "null"
      ]
    },
    "resolution": {
      "type": "object",
      "properties": {
        "status": {
          "type": [
            "string",
            "null"
          ]
        },
        "proposed_outcome": {
          "type": [
            "string",
            "null"
          ]
        },
        "resolved_outcome": {
          "type": [
            "string",
            "null"
          ]
        },
        "proposed_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "resolved_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "dispute_state": {
          "type": [
            "string",
            "null"
          ]
        },
        "settlement_source": {
          "type": [
            "string",
            "null"
          ]
        },
        "contract_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "rules": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "status",
        "proposed_outcome",
        "resolved_outcome",
        "proposed_at",
        "resolved_at",
        "dispute_state",
        "settlement_source",
        "contract_url",
        "rules"
      ],
      "additionalProperties": false
    },
    "odds_as_of": {
      "type": [
        "string",
        "null"
      ]
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "slug",
    "title",
    "category",
    "event_type",
    "status",
    "end_date",
    "total_volume_usd",
    "liquidity_usd",
    "open_interest_usd",
    "spread",
    "outcomes",
    "history",
    "history_interval",
    "resolution",
    "odds_as_of",
    "url"
  ],
  "additionalProperties": false
}

{
  "slug": "example",
  "title": "example",
  "category": "example",
  "event_type": "example",
  "status": "active",
  "end_date": "2026-10-09T00:00:00.000Z",
  "total_volume_usd": 0,
  "liquidity_usd": 0,
  "open_interest_usd": 0,
  "spread": 0,
  "outcomes": [],
  "history": [],
  "history_interval": "example",
  "resolution": {
    "status": "example",
    "proposed_outcome": "example",
    "resolved_outcome": "example",
    "proposed_at": "2026-10-09T00:00:00.000Z",
    "resolved_at": "2026-10-09T00:00:00.000Z",
    "dispute_state": "example",
    "settlement_source": "example",
    "contract_url": "https://el7.ai/ar/news",
    "rules": "example"
  },
  "odds_as_of": "2026-10-09T00:00:00.000Z",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_strategies_list

Lists strategies from EL7's published strategy library with each one's level (0 not tested, 1 backtest only, 2 cleared bar 1, 3 survived paper, or rejected) and the best cell that earned it (instrument, timeframe, profit factor, trades, drawdown, net return, cells tested/graded/bar-1). Strategies have no home market: the level is earned by the best cell, so filter 'instrument' matches only the strategy's original market. Filter by indicator, timeframe, behaviour, minimum level or text. Backtested history, not a forecast. Use el7_strategy for one strategy's rules and cross-market evidence; el7_strategy_baskets for portfolios of strategies.

strategies · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "source": {
      "default": "library",
      "description": "'library' = strategies EL7's engine harvested (the default catalog tab); 'members' = strategies members authored and published.",
      "type": "string",
      "enum": [
        "library",
        "members"
      ]
    },
    "query": {
      "description": "Text to find in the strategy name, instrument or indicator list.",
      "type": "string",
      "minLength": 2,
      "maxLength": 80
    },
    "indicator": {
      "description": "Indicator slug the strategy uses, e.g. 'rsi'.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[A-Za-z0-9_]+$"
    },
    "timeframe": {
      "description": "The strategy's own timeframe.",
      "type": "string",
      "enum": [
        "1m",
        "5m",
        "15m",
        "30m",
        "1h",
        "4h",
        "1d",
        "1w"
      ]
    },
    "instrument": {
      "description": "The strategy's original instrument (its first listed market). Strategies have no home: the level is earned by the best cell, named in best_cell.",
      "type": "string",
      "minLength": 1,
      "maxLength": 24,
      "pattern": "^[A-Za-z0-9^.=\\-]+$"
    },
    "behaviour": {
      "description": "Behaviour archetype classified from the strategy's logic.",
      "type": "string",
      "enum": [
        "breakout",
        "dip",
        "reclaim",
        "momentum",
        "trend",
        "cross",
        "other"
      ]
    },
    "min_level": {
      "description": "Minimum level: 1 = backtest only or better, 2 = cleared bar 1 or better, 3 = survived paper.",
      "type": "integer",
      "minimum": 1,
      "maximum": 3
    },
    "sort": {
      "default": "level",
      "description": "'level' = highest level first (then most bar-1 cells), 'newest' = latest published, 'name' = alphabetical.",
      "type": "string",
      "enum": [
        "level",
        "newest",
        "name"
      ]
    },
    "limit": {
      "default": 20,
      "description": "Rows to return (max 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "default": 0,
      "description": "Rows to skip, for paging.",
      "type": "integer",
      "minimum": 0,
      "maximum": 5000
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "market": {
            "type": [
              "string",
              "null"
            ]
          },
          "timeframe": {
            "type": "string"
          },
          "instrument": {
            "type": [
              "string",
              "null"
            ]
          },
          "indicators": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "behaviour": {
            "type": [
              "string",
              "null"
            ]
          },
          "origin": {
            "type": "string"
          },
          "published_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "level": {
            "type": "object",
            "properties": {
              "level": {
                "type": "integer",
                "minimum": 0,
                "maximum": 3
              },
              "label": {
                "type": "string"
              },
              "rejected": {
                "type": "boolean"
              },
              "reason": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "level",
              "label",
              "rejected",
              "reason"
            ],
            "additionalProperties": false
          },
          "best_cell": {
            "type": "object",
            "properties": {
              "instrument": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "timeframe": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "profit_factor": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "trades": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "max_drawdown_pct": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "net_profit_pct": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "cells_tested": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "cells_graded": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "cells_bar1": {
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "required": [
              "instrument",
              "timeframe",
              "profit_factor",
              "trades",
              "max_drawdown_pct",
              "net_profit_pct",
              "cells_tested",
              "cells_graded",
              "cells_bar1"
            ],
            "additionalProperties": false
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "slug",
          "name",
          "market",
          "timeframe",
          "instrument",
          "indicators",
          "behaviour",
          "origin",
          "published_at",
          "level",
          "best_cell",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "total_matching": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "has_more": {
      "type": "boolean"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "items",
    "total_matching",
    "has_more"
  ],
  "additionalProperties": false
}

{
  "items": [],
  "total_matching": 0,
  "has_more": false
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_strategy

One published strategy: plain-language entry/exit/risk rules, indicators, level and the best cell behind it, its headline backtest (trades, win rate, profit factor, net return, max drawdown, equity summary - no raw curve) and the cross-market matrix of every instrument and timeframe it was tested on (bar-1 cells first). Get the slug from el7_strategies_list. Backtests are historical and in-sample; read the level and cells_bar1 before trusting a headline figure.

strategies · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "pattern": "^[A-Za-z0-9._\\-]+$",
      "description": "Strategy slug as returned by el7_strategies_list (slug)."
    },
    "cells": {
      "default": 10,
      "description": "How many cross-market cells to include (0-50), bar-1 cells first then by profit factor. Cells are every instrument x timeframe the strategy was backtested on, good and bad.",
      "type": "integer",
      "minimum": 0,
      "maximum": 50
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "market": {
      "type": [
        "string",
        "null"
      ]
    },
    "strategy_type": {
      "type": [
        "string",
        "null"
      ]
    },
    "timeframe": {
      "type": "string"
    },
    "instruments": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "indicators": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "behaviour": {
      "type": [
        "string",
        "null"
      ]
    },
    "origin": {
      "type": "string"
    },
    "published_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "level": {
      "type": "object",
      "properties": {
        "level": {
          "type": "integer",
          "minimum": 0,
          "maximum": 3
        },
        "label": {
          "type": "string"
        },
        "rejected": {
          "type": "boolean"
        },
        "reason": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "level",
        "label",
        "rejected",
        "reason"
      ],
      "additionalProperties": false
    },
    "best_cell": {
      "type": "object",
      "properties": {
        "instrument": {
          "type": [
            "string",
            "null"
          ]
        },
        "timeframe": {
          "type": [
            "string",
            "null"
          ]
        },
        "profit_factor": {
          "type": [
            "number",
            "null"
          ]
        },
        "trades": {
          "type": [
            "number",
            "null"
          ]
        },
        "max_drawdown_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "net_profit_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "cells_tested": {
          "type": [
            "number",
            "null"
          ]
        },
        "cells_graded": {
          "type": [
            "number",
            "null"
          ]
        },
        "cells_bar1": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "instrument",
        "timeframe",
        "profit_factor",
        "trades",
        "max_drawdown_pct",
        "net_profit_pct",
        "cells_tested",
        "cells_graded",
        "cells_bar1"
      ],
      "additionalProperties": false
    },
    "rules": {
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "text": {
            "type": "string"
          }
        },
        "required": [
          "kind",
          "label",
          "text"
        ],
        "additionalProperties": false
      }
    },
    "backtest": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "instrument": {
              "type": [
                "string",
                "null"
              ]
            },
            "timeframe": {
              "type": [
                "string",
                "null"
              ]
            },
            "from": {
              "type": [
                "string",
                "null"
              ]
            },
            "to": {
              "type": [
                "string",
                "null"
              ]
            },
            "trades": {
              "type": [
                "number",
                "null"
              ]
            },
            "win_rate_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "profit_factor": {
              "type": [
                "number",
                "null"
              ]
            },
            "net_profit_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "max_drawdown_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "cagr_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "equity_final_return_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "equity_max_drawdown_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "is_pinned_canonical_run": {
              "type": "boolean"
            },
            "is_degenerate": {
              "type": "boolean"
            }
          },
          "required": [
            "instrument",
            "timeframe",
            "from",
            "to",
            "trades",
            "win_rate_pct",
            "profit_factor",
            "net_profit_pct",
            "max_drawdown_pct",
            "cagr_pct",
            "equity_final_return_pct",
            "equity_max_drawdown_pct",
            "is_pinned_canonical_run",
            "is_degenerate"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "cross_market": {
      "type": "object",
      "properties": {
        "cells_total": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "cells_bar1": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "top_cells": {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "instrument": {
                "type": "string"
              },
              "timeframe": {
                "type": "string"
              },
              "net_profit_pct": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "profit_factor": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "max_drawdown_pct": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "trades": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "cost_grade": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "robustness_verdict": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "bar1_passed": {
                "type": [
                  "boolean",
                  "null"
                ]
              }
            },
            "required": [
              "instrument",
              "timeframe",
              "net_profit_pct",
              "profit_factor",
              "max_drawdown_pct",
              "trades",
              "cost_grade",
              "robustness_verdict",
              "bar1_passed"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "cells_total",
        "cells_bar1",
        "top_cells"
      ],
      "additionalProperties": false
    },
    "levels_refreshed_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "slug",
    "name",
    "description",
    "market",
    "strategy_type",
    "timeframe",
    "instruments",
    "indicators",
    "behaviour",
    "origin",
    "published_at",
    "level",
    "best_cell",
    "rules",
    "backtest",
    "cross_market",
    "levels_refreshed_at",
    "url"
  ],
  "additionalProperties": false
}

{
  "slug": "example",
  "name": "example",
  "description": "example",
  "market": "example",
  "strategy_type": "example",
  "timeframe": "example",
  "instruments": [],
  "indicators": [],
  "behaviour": "example",
  "origin": "example",
  "published_at": "2026-10-09T00:00:00.000Z",
  "level": {
    "level": 0,
    "label": "example",
    "rejected": false,
    "reason": "example"
  },
  "best_cell": {
    "instrument": "example",
    "timeframe": "example",
    "profit_factor": 0,
    "trades": 0,
    "max_drawdown_pct": 0,
    "net_profit_pct": 0,
    "cells_tested": 0,
    "cells_graded": 0,
    "cells_bar1": 0
  },
  "rules": [],
  "backtest": {
    "instrument": "example",
    "timeframe": "example",
    "from": "example",
    "to": "example",
    "trades": 0,
    "win_rate_pct": 0,
    "profit_factor": 0,
    "net_profit_pct": 0,
    "max_drawdown_pct": 0,
    "cagr_pct": 0,
    "equity_final_return_pct": 0,
    "equity_max_drawdown_pct": 0,
    "is_pinned_canonical_run": false,
    "is_degenerate": false
  },
  "cross_market": {
    "cells_total": 0,
    "cells_bar1": 0,
    "top_cells": []
  },
  "levels_refreshed_at": "2026-10-09T00:00:00.000Z",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_strategy_baskets

Lists the strategy basket library: portfolios of legs (one strategy across markets, several strategies on one market, or mixed) ranked by level then yearly return over drawdown, with profit factor, drawdown, net return, trades and any out-of-sample re-pick years. Filter by shape, minimum level, or a strategy slug to see the baskets it belongs to. Results are in-sample history. Use el7_strategy_basket with an id for per-market contributions.

strategies · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "shape": {
      "default": "markets",
      "description": "'markets' = one strategy across several markets, 'strategies' = several strategies on one market, 'mixed' = both.",
      "type": "string",
      "enum": [
        "markets",
        "strategies",
        "mixed"
      ]
    },
    "min_level": {
      "description": "Minimum level: 1 = backtest only or better, 2 = held up after the pick.",
      "type": "integer",
      "minimum": 1,
      "maximum": 2
    },
    "strategy_slug": {
      "description": "Only baskets that include this strategy as a leg (slug from el7_strategies_list).",
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "pattern": "^[A-Za-z0-9._\\-]+$"
    },
    "limit": {
      "default": 15,
      "description": "Rows to return (max 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "default": 0,
      "description": "Rows to skip, for paging.",
      "type": "integer",
      "minimum": 0,
      "maximum": 2000
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "shape": {
            "type": "string"
          },
          "level": {
            "type": "integer",
            "minimum": 0,
            "maximum": 2
          },
          "level_label": {
            "type": "string"
          },
          "level_reason": {
            "type": [
              "string",
              "null"
            ]
          },
          "legs_count": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "strategies_count": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "markets_count": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "legs": {
            "maxItems": 20,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "strategy_slug": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "strategy_name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "instrument": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "timeframe": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "weight": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "strategy_slug",
                "strategy_name",
                "instrument",
                "timeframe",
                "weight"
              ],
              "additionalProperties": false
            }
          },
          "timeframe": {
            "type": [
              "string",
              "null"
            ]
          },
          "window_from": {
            "type": [
              "string",
              "null"
            ]
          },
          "window_to": {
            "type": [
              "string",
              "null"
            ]
          },
          "profit_factor": {
            "type": [
              "number",
              "null"
            ]
          },
          "max_drawdown_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "net_profit_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "trades": {
            "type": [
              "number",
              "null"
            ]
          },
          "trades_per_year": {
            "type": [
              "number",
              "null"
            ]
          },
          "equity_final_return_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "equity_max_drawdown_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "repick_status": {
            "type": [
              "string",
              "null"
            ]
          },
          "out_of_sample": {
            "maxItems": 6,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "from": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "to": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "verdict": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "net_profit_pct": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "profit_factor": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "trades": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "max_drawdown_pct": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "from",
                "to",
                "verdict",
                "net_profit_pct",
                "profit_factor",
                "trades",
                "max_drawdown_pct"
              ],
              "additionalProperties": false
            }
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "id",
          "shape",
          "level",
          "level_label",
          "level_reason",
          "legs_count",
          "strategies_count",
          "markets_count",
          "legs",
          "timeframe",
          "window_from",
          "window_to",
          "profit_factor",
          "max_drawdown_pct",
          "net_profit_pct",
          "trades",
          "trades_per_year",
          "equity_final_return_pct",
          "equity_max_drawdown_pct",
          "repick_status",
          "out_of_sample",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "total_matching": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "has_more": {
      "type": "boolean"
    },
    "note": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "items",
    "total_matching",
    "has_more",
    "note"
  ],
  "additionalProperties": false
}

{
  "items": [],
  "total_matching": 0,
  "has_more": false,
  "note": "example"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_strategy_basket

One library basket in full: its legs with strategy names, headline metrics (trades, win rate, profit factor, net return, CAGR, max drawdown, exposure), each market's contribution and the out-of-sample re-pick years. Get the id from el7_strategy_baskets. Summary figures only; no raw equity series.

strategies · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Basket id from el7_strategy_baskets."
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "shape": {
      "type": "string"
    },
    "level": {
      "type": "integer",
      "minimum": 0,
      "maximum": 2
    },
    "level_label": {
      "type": "string"
    },
    "level_reason": {
      "type": [
        "string",
        "null"
      ]
    },
    "legs_count": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "strategies_count": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "markets_count": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "legs": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "strategy_slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "strategy_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "instrument": {
            "type": [
              "string",
              "null"
            ]
          },
          "timeframe": {
            "type": [
              "string",
              "null"
            ]
          },
          "weight": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "strategy_slug",
          "strategy_name",
          "instrument",
          "timeframe",
          "weight"
        ],
        "additionalProperties": false
      }
    },
    "timeframe": {
      "type": [
        "string",
        "null"
      ]
    },
    "window_from": {
      "type": [
        "string",
        "null"
      ]
    },
    "window_to": {
      "type": [
        "string",
        "null"
      ]
    },
    "profit_factor": {
      "type": [
        "number",
        "null"
      ]
    },
    "max_drawdown_pct": {
      "type": [
        "number",
        "null"
      ]
    },
    "net_profit_pct": {
      "type": [
        "number",
        "null"
      ]
    },
    "trades": {
      "type": [
        "number",
        "null"
      ]
    },
    "trades_per_year": {
      "type": [
        "number",
        "null"
      ]
    },
    "equity_final_return_pct": {
      "type": [
        "number",
        "null"
      ]
    },
    "equity_max_drawdown_pct": {
      "type": [
        "number",
        "null"
      ]
    },
    "repick_status": {
      "type": [
        "string",
        "null"
      ]
    },
    "out_of_sample": {
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "from": {
            "type": [
              "string",
              "null"
            ]
          },
          "to": {
            "type": [
              "string",
              "null"
            ]
          },
          "verdict": {
            "type": [
              "string",
              "null"
            ]
          },
          "net_profit_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "profit_factor": {
            "type": [
              "number",
              "null"
            ]
          },
          "trades": {
            "type": [
              "number",
              "null"
            ]
          },
          "max_drawdown_pct": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "from",
          "to",
          "verdict",
          "net_profit_pct",
          "profit_factor",
          "trades",
          "max_drawdown_pct"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "metrics": {
      "type": "object",
      "properties": {
        "total_trades": {
          "type": [
            "number",
            "null"
          ]
        },
        "win_rate_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "profit_factor": {
          "type": [
            "number",
            "null"
          ]
        },
        "net_profit_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "max_drawdown_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "cagr_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "expectancy": {
          "type": [
            "number",
            "null"
          ]
        },
        "exposure_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "annual_volatility_pct": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "total_trades",
        "win_rate_pct",
        "profit_factor",
        "net_profit_pct",
        "max_drawdown_pct",
        "cagr_pct",
        "expectancy",
        "exposure_pct",
        "annual_volatility_pct"
      ],
      "additionalProperties": false
    },
    "per_market": {
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "label": {
            "type": [
              "string",
              "null"
            ]
          },
          "instrument": {
            "type": [
              "string",
              "null"
            ]
          },
          "timeframe": {
            "type": [
              "string",
              "null"
            ]
          },
          "weight": {
            "type": [
              "number",
              "null"
            ]
          },
          "trades": {
            "type": [
              "number",
              "null"
            ]
          },
          "win_rate_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "profit_factor": {
            "type": [
              "number",
              "null"
            ]
          },
          "max_drawdown_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "contribution_pct": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "label",
          "instrument",
          "timeframe",
          "weight",
          "trades",
          "win_rate_pct",
          "profit_factor",
          "max_drawdown_pct",
          "contribution_pct"
        ],
        "additionalProperties": false
      }
    },
    "note": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "id",
    "shape",
    "level",
    "level_label",
    "level_reason",
    "legs_count",
    "strategies_count",
    "markets_count",
    "legs",
    "timeframe",
    "window_from",
    "window_to",
    "profit_factor",
    "max_drawdown_pct",
    "net_profit_pct",
    "trades",
    "trades_per_year",
    "equity_final_return_pct",
    "equity_max_drawdown_pct",
    "repick_status",
    "out_of_sample",
    "url",
    "metrics",
    "per_market",
    "note"
  ],
  "additionalProperties": false
}

{
  "id": "example",
  "shape": "example",
  "level": 0,
  "level_label": "example",
  "level_reason": "example",
  "legs_count": 0,
  "strategies_count": 0,
  "markets_count": 0,
  "legs": [],
  "timeframe": "example",
  "window_from": "example",
  "window_to": "example",
  "profit_factor": 0,
  "max_drawdown_pct": 0,
  "net_profit_pct": 0,
  "trades": 0,
  "trades_per_year": 0,
  "equity_final_return_pct": 0,
  "equity_max_drawdown_pct": 0,
  "repick_status": "example",
  "out_of_sample": [],
  "url": "https://el7.ai/ar/news",
  "metrics": {
    "total_trades": 0,
    "win_rate_pct": 0,
    "profit_factor": 0,
    "net_profit_pct": 0,
    "max_drawdown_pct": 0,
    "cagr_pct": 0,
    "expectancy": 0,
    "exposure_pct": 0,
    "annual_volatility_pct": 0
  },
  "per_market": [],
  "note": "example"
}

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

el7_market_regime

EL7's read of the market's state. With no arguments (or `asset_class`) it returns the composite volatility regime (low/normal/elevated/extreme, 0-100 score built from the VIX score and per-asset-class RSI extremes) plus momentum breadth per asset class: % of instruments above their 50/200-day averages, average RSI, % overbought/oversold, golden/death-cross counts, breadth score and label. With `symbol` it returns that one instrument's trend (uptrend/downtrend/mixed), volatility regime (percentile of 20-day realized vol vs the past year), returns over 1w/1m/3m/6m/12m, distance from the 50/200-day averages and drawdown from the 52-week high, all in %. Derived values only: no prices, no VIX level. Breadth older than 36h is omitted (breadth_stale=true). Use el7_market_seasonality or el7_market_correlations next.

markets · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "asset_class": {
      "description": "Restrict the market-wide view to one asset class. Omit for all six. Cannot be combined with `symbol`.",
      "type": "string",
      "enum": [
        "forex",
        "commodity",
        "index",
        "stock",
        "etf",
        "crypto"
      ]
    },
    "symbol": {
      "description": "A single instrument (XAUUSD, EURUSD, BTCUSD, ^GSPC, AAPL, aliases like GOLD/BTC accepted) for its own trend and volatility regime. Cannot be combined with `asset_class`.",
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9^.=_-]+$"
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "scope": {
      "type": "string",
      "enum": [
        "market",
        "symbol"
      ]
    },
    "market": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "regime": {
              "type": "string",
              "enum": [
                "low",
                "normal",
                "elevated",
                "extreme",
                "unknown"
              ]
            },
            "regime_label": {
              "type": "string"
            },
            "composite_score": {
              "type": [
                "number",
                "null"
              ]
            },
            "vix": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "vol_score": {
                      "type": "number"
                    },
                    "level_bucket": {
                      "type": "string"
                    },
                    "as_of": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "vol_score",
                    "level_bucket",
                    "as_of"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "breadth_stale": {
              "type": "boolean"
            },
            "breadth_refreshed_at": {
              "type": [
                "string",
                "null"
              ]
            },
            "asset_classes": {
              "maxItems": 10,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "asset_class": {
                    "type": "string"
                  },
                  "instruments": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "pct_above_sma50": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "pct_above_sma200": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "avg_rsi": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "pct_overbought": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "pct_oversold": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "pct_bullish": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "golden_cross_count": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "death_cross_count": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "breadth_score": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "breadth_regime": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "breadth_label": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "vol_score": {
                    "type": "number"
                  },
                  "url": {
                    "type": "string",
                    "format": "uri"
                  }
                },
                "required": [
                  "asset_class",
                  "instruments",
                  "pct_above_sma50",
                  "pct_above_sma200",
                  "avg_rsi",
                  "pct_overbought",
                  "pct_oversold",
                  "pct_bullish",
                  "golden_cross_count",
                  "death_cross_count",
                  "breadth_score",
                  "breadth_regime",
                  "breadth_label",
                  "vol_score",
                  "url"
                ],
                "additionalProperties": false
              }
            },
            "url": {
              "type": "string",
              "format": "uri"
            }
          },
          "required": [
            "regime",
            "regime_label",
            "composite_score",
            "vix",
            "breadth_stale",
            "breadth_refreshed_at",
            "asset_classes",
            "url"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "symbol": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "symbol": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "asset_class": {
              "type": [
                "string",
                "null"
              ]
            },
            "trend": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "uptrend",
                    "downtrend",
                    "mixed"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "trend_label": {
              "type": [
                "string",
                "null"
              ]
            },
            "vol_regime": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "low",
                    "normal",
                    "elevated",
                    "extreme"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "vol_regime_label": {
              "type": [
                "string",
                "null"
              ]
            },
            "returns_pct": {
              "type": "object",
              "properties": {
                "d5": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "d21": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "d63": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "d126": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "d252": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "d5",
                "d21",
                "d63",
                "d126",
                "d252"
              ],
              "additionalProperties": false
            },
            "distance_from_sma50_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "distance_from_sma200_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "drawdown_from_52w_high_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "realized_vol_20d_annualized_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "vol_percentile_1y": {
              "type": [
                "number",
                "null"
              ]
            },
            "daily_bars_used": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "url": {
              "type": "string",
              "format": "uri"
            }
          },
          "required": [
            "symbol",
            "name",
            "asset_class",
            "trend",
            "trend_label",
            "vol_regime",
            "vol_regime_label",
            "returns_pct",
            "distance_from_sma50_pct",
            "distance_from_sma200_pct",
            "drawdown_from_52w_high_pct",
            "realized_vol_20d_annualized_pct",
            "vol_percentile_1y",
            "daily_bars_used",
            "url"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "scope",
    "market",
    "symbol"
  ],
  "additionalProperties": false
}

{
  "scope": "market",
  "market": {
    "regime": "low",
    "regime_label": "example",
    "composite_score": 0,
    "vix": {
      "vol_score": 0,
      "level_bucket": "example",
      "as_of": "2026-10-09T00:00:00.000Z"
    },
    "breadth_stale": false,
    "breadth_refreshed_at": "2026-10-09T00:00:00.000Z",
    "asset_classes": [],
    "url": "https://el7.ai/ar/news"
  },
  "symbol": {
    "symbol": "example",
    "name": "example",
    "asset_class": "example",
    "trend": "uptrend",
    "trend_label": "example",
    "vol_regime": "low",
    "vol_regime_label": "example",
    "returns_pct": {
      "d5": 0,
      "d21": 0,
      "d63": 0,
      "d126": 0,
      "d252": 0
    },
    "distance_from_sma50_pct": 0,
    "distance_from_sma200_pct": 0,
    "drawdown_from_52w_high_pct": 0,
    "realized_vol_20d_annualized_pct": 0,
    "vol_percentile_1y": 0,
    "daily_bars_used": 0,
    "url": "https://el7.ai/ar/news"
  }
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_market_seasonality

How an instrument has historically performed in each calendar month: average and median monthly return %, win rate, best/worst month and sample size, over the past N years of completed months, plus its strongest and weakest month and whether each row is the current month. Monthly return = last close of the month vs last close of the previous month (computed inside EL7; no prices returned). Use to answer 'is October usually weak for gold?'. Related: el7_market_regime for the current trend, el7_market_cycle for Fed-cycle behaviour.

markets · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9^.=_-]+$",
      "description": "Instrument symbol (XAUUSD, EURUSD, BTCUSD, ^GSPC, AAPL; aliases like GOLD/BTC accepted)."
    },
    "years": {
      "default": 10,
      "description": "How many years of history to average over (3-20, default 10).",
      "type": "integer",
      "minimum": 3,
      "maximum": 20
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "asset_class": {
      "type": [
        "string",
        "null"
      ]
    },
    "years_requested": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "complete_months_used": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "months": {
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "month": {
            "type": "integer",
            "minimum": 1,
            "maximum": 12
          },
          "month_name": {
            "type": "string"
          },
          "avg_return_pct": {
            "type": "number"
          },
          "median_return_pct": {
            "type": "number"
          },
          "win_rate_pct": {
            "type": "number"
          },
          "best_return_pct": {
            "type": "number"
          },
          "worst_return_pct": {
            "type": "number"
          },
          "sample_size": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "is_current_month": {
            "type": "boolean"
          }
        },
        "required": [
          "month",
          "month_name",
          "avg_return_pct",
          "median_return_pct",
          "win_rate_pct",
          "best_return_pct",
          "worst_return_pct",
          "sample_size",
          "is_current_month"
        ],
        "additionalProperties": false
      }
    },
    "strongest_month": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "month": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "month_name": {
              "type": "string"
            },
            "avg_return_pct": {
              "type": "number"
            }
          },
          "required": [
            "month",
            "month_name",
            "avg_return_pct"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "weakest_month": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "month": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "month_name": {
              "type": "string"
            },
            "avg_return_pct": {
              "type": "number"
            }
          },
          "required": [
            "month",
            "month_name",
            "avg_return_pct"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "method": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "symbol",
    "name",
    "asset_class",
    "years_requested",
    "complete_months_used",
    "months",
    "strongest_month",
    "weakest_month",
    "method",
    "url"
  ],
  "additionalProperties": false
}

{
  "symbol": "example",
  "name": "example",
  "asset_class": "example",
  "years_requested": 0,
  "complete_months_used": 0,
  "months": [],
  "strongest_month": {
    "month": 0,
    "month_name": "example",
    "avg_return_pct": 0
  },
  "weakest_month": {
    "month": 0,
    "month_name": "example",
    "avg_return_pct": 0
  },
  "method": "example",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_market_correlations

Pearson correlation of DAILY RETURNS between instruments over the past 30/90/180/365 days, as a list of pairs sorted from most positive to most negative, with the number of overlapping days, plus the 5 strongest positive and negative pairs. Use to see which assets move together (gold vs dollar, BTC vs equities) or to build diversification. Pairs with fewer than 10 shared days are dropped; symbols with no stored history are listed in symbols_without_data. Returns correlations only, never prices. Related: el7_market_regime, el7_market_seasonality.

markets · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "symbols": {
      "description": "2-12 instrument symbols. Omit for EL7's default cross-asset set (gold, dollar index, crude, BTC, ETH, EURUSD, GBPUSD, USDJPY, S&P 500).",
      "minItems": 2,
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 20,
        "pattern": "^[A-Za-z0-9^.=_-]+$"
      }
    },
    "window_days": {
      "default": 90,
      "description": "Look-back window in calendar days: 30, 90, 180 or 365.",
      "anyOf": [
        {
          "type": "number",
          "const": 30
        },
        {
          "type": "number",
          "const": 90
        },
        {
          "type": "number",
          "const": 180
        },
        {
          "type": "number",
          "const": 365
        }
      ]
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "window_days": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "pairs": {
      "maxItems": 66,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol_a": {
            "type": "string"
          },
          "symbol_b": {
            "type": "string"
          },
          "correlation": {
            "type": "number",
            "minimum": -1,
            "maximum": 1
          },
          "observations": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "symbol_a",
          "symbol_b",
          "correlation",
          "observations"
        ],
        "additionalProperties": false
      }
    },
    "strongest_positive": {
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol_a": {
            "type": "string"
          },
          "symbol_b": {
            "type": "string"
          },
          "correlation": {
            "type": "number",
            "minimum": -1,
            "maximum": 1
          },
          "observations": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "symbol_a",
          "symbol_b",
          "correlation",
          "observations"
        ],
        "additionalProperties": false
      }
    },
    "strongest_negative": {
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol_a": {
            "type": "string"
          },
          "symbol_b": {
            "type": "string"
          },
          "correlation": {
            "type": "number",
            "minimum": -1,
            "maximum": 1
          },
          "observations": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "symbol_a",
          "symbol_b",
          "correlation",
          "observations"
        ],
        "additionalProperties": false
      }
    },
    "symbols_without_data": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "method": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "window_days",
    "pairs",
    "strongest_positive",
    "strongest_negative",
    "symbols_without_data",
    "method",
    "url"
  ],
  "additionalProperties": false
}

{
  "window_days": 0,
  "pairs": [],
  "strongest_positive": [],
  "strongest_negative": [],
  "symbols_without_data": [],
  "method": "example",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_event_reaction

EL7's event-study statistics, in % moves only. mode=indicator: for one event (FOMC decisions, CPI, NFP, GDP, jobless claims, PCE, ECB/BoE/BoJ rates, or any calendar event name) how an asset (default gold) moved over the N days after each release since a date: average, median, win rate, standard deviation, best/worst, and the latest events (one row per release day). mode=surprise: the biggest data surprises by |z-score| and the asset's next-day move, with the average move after positive vs negative surprises. mode=ranking: event types ranked by average |surprise z-score| with the asset's average next-day reaction. No prices are returned. For the readings themselves (actual/forecast) use el7_calendar_event; for the current regime use el7_market_regime.

markets · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "mode": {
      "default": "indicator",
      "description": "indicator: how the asset moved after each release of one event (needs `event`). surprise: the largest data surprises (by |z-score|) and the asset's move the next day (`event` optional filter). ranking: which event types surprise most and how the asset reacts on average.",
      "type": "string",
      "enum": [
        "indicator",
        "surprise",
        "ranking"
      ]
    },
    "event": {
      "description": "Event shortcut (fomc, cpi, nfp, gdp, jobless claims, pce, ecb, boe, boj) or any part of a calendar event name (e.g. 'Retail Sales'). Required for mode=indicator.",
      "type": "string",
      "minLength": 2,
      "maxLength": 80
    },
    "symbol": {
      "default": "XAUUSD",
      "description": "The asset whose reaction to measure (default XAUUSD). Aliases like GOLD/BTC accepted.",
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9^.=_-]+$"
    },
    "country": {
      "default": "US",
      "description": "ISO country of the event (default US). Ignored for fomc.",
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "since": {
      "default": "2015-01-01",
      "description": "Only events on/after this date, YYYY-MM-DD (not earlier than 2000-01-01; default 2015-01-01).",
      "type": "string"
    },
    "window_days": {
      "default": 5,
      "description": "mode=indicator only: calendar days after the event at which the reaction is measured (1-30, default 5).",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    },
    "decision_filter": {
      "description": "mode=indicator with event=fomc only: keep meetings with this decision.",
      "type": "string",
      "enum": [
        "hike",
        "cut",
        "hold"
      ]
    },
    "dissent_only": {
      "default": false,
      "description": "mode=indicator with event=fomc only: keep meetings that had dissenters.",
      "type": "boolean"
    },
    "min_abs_zscore": {
      "default": 0,
      "description": "mode=surprise only: minimum |surprise z-score|.",
      "type": "number",
      "minimum": 0,
      "maximum": 10
    },
    "min_events": {
      "default": 5,
      "description": "mode=ranking only: minimum events per event type.",
      "type": "integer",
      "minimum": 3,
      "maximum": 50
    },
    "limit": {
      "default": 10,
      "description": "Rows to return (1-30, default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "indicator",
        "surprise",
        "ranking"
      ]
    },
    "symbol": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "since": {
      "type": "string"
    },
    "summary": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "observations": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "avg_move_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "median_move_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "win_rate_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "std_dev_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "max_gain_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "max_loss_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "avg_abs_zscore": {
              "type": [
                "number",
                "null"
              ]
            },
            "avg_move_after_positive_surprise_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "avg_move_after_negative_surprise_pct": {
              "type": [
                "number",
                "null"
              ]
            }
          },
          "required": [
            "observations",
            "avg_move_pct",
            "median_move_pct",
            "win_rate_pct",
            "std_dev_pct",
            "max_gain_pct",
            "max_loss_pct",
            "avg_abs_zscore",
            "avg_move_after_positive_surprise_pct",
            "avg_move_after_negative_surprise_pct"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "events": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string"
          },
          "event": {
            "type": "string"
          },
          "move_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "surprise_zscore": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "date",
          "event",
          "move_pct",
          "surprise_zscore"
        ],
        "additionalProperties": false
      }
    },
    "event_types": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "event": {
            "type": "string"
          },
          "event_count": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "avg_abs_zscore": {
            "type": [
              "number",
              "null"
            ]
          },
          "std_dev_zscore": {
            "type": [
              "number",
              "null"
            ]
          },
          "avg_move_pct": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "event",
          "event_count",
          "avg_abs_zscore",
          "std_dev_zscore",
          "avg_move_pct"
        ],
        "additionalProperties": false
      }
    },
    "method": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "mode",
    "symbol",
    "country",
    "since",
    "summary",
    "events",
    "event_types",
    "method",
    "url"
  ],
  "additionalProperties": false
}

{
  "mode": "indicator",
  "symbol": "example",
  "country": "example",
  "since": "example",
  "summary": {
    "observations": 0,
    "avg_move_pct": 0,
    "median_move_pct": 0,
    "win_rate_pct": 0,
    "std_dev_pct": 0,
    "max_gain_pct": 0,
    "max_loss_pct": 0,
    "avg_abs_zscore": 0,
    "avg_move_after_positive_surprise_pct": 0,
    "avg_move_after_negative_surprise_pct": 0
  },
  "events": [],
  "event_types": [],
  "method": "example",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_market_cycle

How an asset (default gold) performed during each Fed (or ECB) rate cycle: hiking, cutting and hold phases with start/end date, policy-rate start/end (%), total change in bps, duration in days and the asset's return % over the cycle, plus averages by cycle type. Use for 'what does gold do in a hiking cycle?'. Returns % moves only, no prices. Historical cycles whose end date is missing in the source are excluded and counted in excluded_open_ended_cycles. Related: el7_event_reaction for single FOMC meetings, el7_market_regime for today's regime.

markets · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "bank": {
      "default": "fed",
      "description": "Central bank whose rate cycles to use (default fed; ECB cycles may be empty).",
      "type": "string",
      "enum": [
        "fed",
        "ecb"
      ]
    },
    "cycle_type": {
      "description": "Only cycles of this type.",
      "type": "string",
      "enum": [
        "hiking",
        "cutting",
        "hold"
      ]
    },
    "symbol": {
      "default": "XAUUSD",
      "description": "Asset whose performance during each cycle is measured (default XAUUSD).",
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9^.=_-]+$"
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "bank": {
      "type": "string",
      "enum": [
        "fed",
        "ecb"
      ]
    },
    "symbol": {
      "type": "string"
    },
    "by_type": {
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cycle_type": {
            "type": "string"
          },
          "cycles": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "avg_asset_return_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "avg_duration_days": {
            "type": [
              "number",
              "null"
            ]
          },
          "avg_rate_change_bps": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "cycle_type",
          "cycles",
          "avg_asset_return_pct",
          "avg_duration_days",
          "avg_rate_change_bps"
        ],
        "additionalProperties": false
      }
    },
    "cycles": {
      "maxItems": 60,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cycle_type": {
            "type": "string"
          },
          "start_date": {
            "type": "string"
          },
          "end_date": {
            "type": "string"
          },
          "is_current": {
            "type": "boolean"
          },
          "start_rate_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "end_rate_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "rate_change_bps": {
            "type": [
              "number",
              "null"
            ]
          },
          "rate_changes": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "duration_days": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "asset_return_pct": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "cycle_type",
          "start_date",
          "end_date",
          "is_current",
          "start_rate_pct",
          "end_rate_pct",
          "rate_change_bps",
          "rate_changes",
          "duration_days",
          "asset_return_pct"
        ],
        "additionalProperties": false
      }
    },
    "excluded_open_ended_cycles": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "bank",
    "symbol",
    "by_type",
    "cycles",
    "excluded_open_ended_cycles",
    "url"
  ],
  "additionalProperties": false
}

{
  "bank": "fed",
  "symbol": "example",
  "by_type": [],
  "cycles": [],
  "excluded_open_ended_cycles": 0,
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_market_brief

EL7's latest published AI market brief for an asset class, exactly as shown at the top of the website's stocks, Saudi stocks, indices, forex, commodities and crypto pages: headline, the written analysis, key takeaways, the overall signal (bullish/bearish/neutral), the session it was written for (e.g. US close) and its date. The text is stored analysis; nothing is generated on request. Use for 'what happened in forex today?'. Related: el7_market_regime for volatility and breadth, el7_market_seasonality for historical patterns.

markets · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "asset_class": {
      "type": "string",
      "enum": [
        "stocks",
        "saudi",
        "indices",
        "forex",
        "commodities",
        "crypto"
      ],
      "description": "Which market's brief: stocks (US), saudi (Tadawul), indices, forex, commodities or crypto."
    },
    "date": {
      "description": "Brief date, YYYY-MM-DD. Omit for the latest published brief.",
      "type": "string"
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "asset_class"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "asset_class": {
      "type": "string"
    },
    "title": {
      "type": [
        "string",
        "null"
      ]
    },
    "text": {
      "type": "string"
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    },
    "key_takeaways": {
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "signal": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "bullish",
            "bearish",
            "neutral"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "analysis_type": {
      "type": "string"
    },
    "session": {
      "type": [
        "string",
        "null"
      ]
    },
    "date": {
      "type": "string"
    },
    "published_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "asset_class",
    "title",
    "text",
    "language",
    "key_takeaways",
    "signal",
    "analysis_type",
    "session",
    "date",
    "published_at",
    "url"
  ],
  "additionalProperties": false
}

{
  "asset_class": "example",
  "title": "example",
  "text": "example",
  "language": "en",
  "key_takeaways": [],
  "signal": "bullish",
  "analysis_type": "example",
  "session": "example",
  "date": "2026-10-09T00:00:00.000Z",
  "published_at": "2026-10-09T00:00:00.000Z",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_stock_profile

EL7's own read of one stock (US or Tadawul). Returns the EL7 overall score and its seven factor axes (valuation, growth, quality, safety, capital return, momentum, sentiment) as 0-100 percentiles against the whole market, the stock's sector and its industry, with sector/industry rank and peer count, plus the change in the overall score vs the previous period. Also returns returns-based technicals in % (12m/6m return, distance from the 52-week high/low and from the 200-day average, RSI, realized volatility), analyst activity counts (upgrades, downgrades and initiations in the last 90 days, and how many houses publish EPS estimates) and a short published company summary when EL7 has one. Also returns EL7 factor badges (Piotroski F-Score 0-9, Altman Z zone, congressional trading counts and insider cluster buying). No price, market cap, price targets or raw financial ratios are returned. Use el7_stock_rank to see where the stock sits in the whole-universe ranking, el7_stock_score_history for its score over time, el7_stock_analysis for EL7's written analysis, el7_sector_overview to compare with peers, el7_screener_run to find similar stocks, el7_earnings_calendar for the next report.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9.^=_-]+$",
      "description": "Stock ticker, e.g. AAPL, NVDA, BRK-B, or a Tadawul symbol such as 2222.SR."
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "sector": {
      "type": [
        "string",
        "null"
      ]
    },
    "industry": {
      "type": [
        "string",
        "null"
      ]
    },
    "exchange": {
      "type": [
        "string",
        "null"
      ]
    },
    "country": {
      "type": [
        "string",
        "null"
      ]
    },
    "summary": {
      "type": [
        "string",
        "null"
      ]
    },
    "scores": {
      "type": "object",
      "properties": {
        "overall": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "score_market": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_sector": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_industry": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "rank_sector": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "sector_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "rank_industry": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "industry_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "period_end": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "score_market",
                "score_sector",
                "score_industry",
                "rank_sector",
                "sector_peers",
                "rank_industry",
                "industry_peers",
                "period_end"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "valuation": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "score_market": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_sector": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_industry": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "rank_sector": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "sector_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "rank_industry": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "industry_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "period_end": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "score_market",
                "score_sector",
                "score_industry",
                "rank_sector",
                "sector_peers",
                "rank_industry",
                "industry_peers",
                "period_end"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "growth": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "score_market": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_sector": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_industry": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "rank_sector": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "sector_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "rank_industry": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "industry_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "period_end": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "score_market",
                "score_sector",
                "score_industry",
                "rank_sector",
                "sector_peers",
                "rank_industry",
                "industry_peers",
                "period_end"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "quality": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "score_market": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_sector": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_industry": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "rank_sector": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "sector_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "rank_industry": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "industry_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "period_end": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "score_market",
                "score_sector",
                "score_industry",
                "rank_sector",
                "sector_peers",
                "rank_industry",
                "industry_peers",
                "period_end"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "safety": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "score_market": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_sector": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_industry": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "rank_sector": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "sector_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "rank_industry": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "industry_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "period_end": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "score_market",
                "score_sector",
                "score_industry",
                "rank_sector",
                "sector_peers",
                "rank_industry",
                "industry_peers",
                "period_end"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "capital_return": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "score_market": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_sector": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_industry": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "rank_sector": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "sector_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "rank_industry": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "industry_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "period_end": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "score_market",
                "score_sector",
                "score_industry",
                "rank_sector",
                "sector_peers",
                "rank_industry",
                "industry_peers",
                "period_end"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "momentum": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "score_market": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_sector": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_industry": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "rank_sector": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "sector_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "rank_industry": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "industry_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "period_end": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "score_market",
                "score_sector",
                "score_industry",
                "rank_sector",
                "sector_peers",
                "rank_industry",
                "industry_peers",
                "period_end"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "sentiment": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "score_market": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_sector": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "score_industry": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "rank_sector": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "sector_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "rank_industry": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "industry_peers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "period_end": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "score_market",
                "score_sector",
                "score_industry",
                "rank_sector",
                "sector_peers",
                "rank_industry",
                "industry_peers",
                "period_end"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "overall",
        "valuation",
        "growth",
        "quality",
        "safety",
        "capital_return",
        "momentum",
        "sentiment"
      ],
      "additionalProperties": false
    },
    "overall_change_vs_prior_period": {
      "type": [
        "number",
        "null"
      ]
    },
    "technicals": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "return_12m_ex_last_month_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "return_6m_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "distance_from_52w_high_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "distance_from_52w_low_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "distance_from_200d_average_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "rsi_14": {
              "type": [
                "number",
                "null"
              ]
            },
            "realized_volatility_1y_pct": {
              "type": [
                "number",
                "null"
              ]
            }
          },
          "required": [
            "return_12m_ex_last_month_pct",
            "return_6m_pct",
            "distance_from_52w_high_pct",
            "distance_from_52w_low_pct",
            "distance_from_200d_average_pct",
            "rsi_14",
            "realized_volatility_1y_pct"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "analysts": {
      "type": "object",
      "properties": {
        "eps_estimate_houses": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "upgrades_90d": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "downgrades_90d": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "initiations_90d": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "other_actions_90d": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "eps_estimate_houses",
        "upgrades_90d",
        "downgrades_90d",
        "initiations_90d",
        "other_actions_90d"
      ],
      "additionalProperties": false
    },
    "factor_badges": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "piotroski_f_score": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "score": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "max_score": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "band": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "score",
                    "max_score",
                    "band"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "altman_z": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "z": {
                      "type": "number"
                    },
                    "zone": {
                      "type": "string",
                      "enum": [
                        "safe",
                        "grey",
                        "distress"
                      ]
                    }
                  },
                  "required": [
                    "z",
                    "zone"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "congress_trading_90d": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "buys": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "sells": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "members": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "net_direction": {
                      "type": "string",
                      "enum": [
                        "buying",
                        "selling",
                        "flat"
                      ]
                    }
                  },
                  "required": [
                    "buys",
                    "sells",
                    "members",
                    "net_direction"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "insider_cluster_buy": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "buyers": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    }
                  },
                  "required": [
                    "buyers"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "piotroski_f_score",
            "altman_z",
            "congress_trading_90d",
            "insider_cluster_buy"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "score_method": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "symbol",
    "name",
    "sector",
    "industry",
    "exchange",
    "country",
    "summary",
    "scores",
    "overall_change_vs_prior_period",
    "technicals",
    "analysts",
    "factor_badges",
    "score_method",
    "url"
  ],
  "additionalProperties": false
}

{
  "symbol": "example",
  "name": "example",
  "sector": "example",
  "industry": "example",
  "exchange": "example",
  "country": "example",
  "summary": "example",
  "scores": {
    "overall": {
      "score_market": 0,
      "score_sector": 0,
      "score_industry": 0,
      "rank_sector": 0,
      "sector_peers": 0,
      "rank_industry": 0,
      "industry_peers": 0,
      "period_end": "example"
    },
    "valuation": {
      "score_market": 0,
      "score_sector": 0,
      "score_industry": 0,
      "rank_sector": 0,
      "sector_peers": 0,
      "rank_industry": 0,
      "industry_peers": 0,
      "period_end": "example"
    },
    "growth": {
      "score_market": 0,
      "score_sector": 0,
      "score_industry": 0,
      "rank_sector": 0,
      "sector_peers": 0,
      "rank_industry": 0,
      "industry_peers": 0,
      "period_end": "example"
    },
    "quality": {
      "score_market": 0,
      "score_sector": 0,
      "score_industry": 0,
      "rank_sector": 0,
      "sector_peers": 0,
      "rank_industry": 0,
      "industry_peers": 0,
      "period_end": "example"
    },
    "safety": {
      "score_market": 0,
      "score_sector": 0,
      "score_industry": 0,
      "rank_sector": 0,
      "sector_peers": 0,
      "rank_industry": 0,
      "industry_peers": 0,
      "period_end": "example"
    },
    "capital_return": {
      "score_market": 0,
      "score_sector": 0,
      "score_industry": 0,
      "rank_sector": 0,
      "sector_peers": 0,
      "rank_industry": 0,
      "industry_peers": 0,
      "period_end": "example"
    },
    "momentum": {
      "score_market": 0,
      "score_sector": 0,
      "score_industry": 0,
      "rank_sector": 0,
      "sector_peers": 0,
      "rank_industry": 0,
      "industry_peers": 0,
      "period_end": "example"
    },
    "sentiment": {
      "score_market": 0,
      "score_sector": 0,
      "score_industry": 0,
      "rank_sector": 0,
      "sector_peers": 0,
      "rank_industry": 0,
      "industry_peers": 0,
      "period_end": "example"
    }
  },
  "overall_change_vs_prior_period": 0,
  "technicals": {
    "return_12m_ex_last_month_pct": 0,
    "return_6m_pct": 0,
    "distance_from_52w_high_pct": 0,
    "distance_from_52w_low_pct": 0,
    "distance_from_200d_average_pct": 0,
    "rsi_14": 0,
    "realized_volatility_1y_pct": 0
  },
  "analysts": {
    "eps_estimate_houses": 0,
    "upgrades_90d": 0,
    "downgrades_90d": 0,
    "initiations_90d": 0,
    "other_actions_90d": 0
  },
  "factor_badges": {
    "piotroski_f_score": {
      "score": 0,
      "max_score": 0,
      "band": "example"
    },
    "altman_z": {
      "z": 0,
      "zone": "safe"
    },
    "congress_trading_90d": {
      "buys": 0,
      "sells": 0,
      "members": 0,
      "net_direction": "buying"
    },
    "insider_cluster_buy": {
      "buyers": 0
    }
  },
  "score_method": "example",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_sector_overview

EL7's sector and industry view. List mode (default) ranks the 11 sectors (or the ~150 industries) by their cap-weighted EL7 score, with the seven factor axes (valuation, growth, quality, safety, capital return, momentum, sentiment) as 0-100 scores, rank, a strong/balanced/weak tier, how many stocks were sampled and scored, and for sectors the 1-day/1-week/1-month/3-month/YTD return % of the proxy sector ETF. Detail mode (`slug`) adds the top-scoring stocks in that sector or industry with their in-scope scores and EL7's stored written narrative for it (Arabic; no English edition is stored). US-listed stocks only: Tadawul has no sector aggregates (use el7_stock_rank with market=sa). Derived scores and returns only: no prices, market caps or medians of raw ratios. Use el7_stock_profile to drill into a stock, el7_market_regime for market-wide breadth, el7_screener_run to screen the universe.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "scope": {
      "default": "sector",
      "description": "sector = the 11 market sectors; industry = the ~150 industries.",
      "type": "string",
      "enum": [
        "sector",
        "industry"
      ]
    },
    "slug": {
      "description": "A sector slug (technology, financial-services, healthcare, ...) or industry slug (software-infrastructure, ...) for the detail view with top stocks. Omit for the ranked list.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "limit": {
      "default": 20,
      "description": "List mode: rows to return (1-50, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "top_stocks": {
      "default": 10,
      "description": "Detail mode: how many top-scoring stocks to list (1-20, default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "scope": {
      "type": "string",
      "enum": [
        "sector",
        "industry"
      ]
    },
    "mode": {
      "type": "string",
      "enum": [
        "list",
        "detail"
      ]
    },
    "items": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "score": {
            "type": [
              "number",
              "null"
            ]
          },
          "rank": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "ranked_of": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "tier": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "strong",
                  "balanced",
                  "weak"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "axes": {
            "type": "object",
            "properties": {
              "valuation": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "growth": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "quality": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "safety": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "capital_return": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "momentum": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "sentiment": {
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "required": [
              "valuation",
              "growth",
              "quality",
              "safety",
              "capital_return",
              "momentum",
              "sentiment"
            ],
            "additionalProperties": false
          },
          "stocks_sampled": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "stocks_scored": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "proxy_etf_returns_pct": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "proxy_etf": {
                    "type": "string"
                  },
                  "d1": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "w1": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "m1": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "m3": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "ytd": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "as_of": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "proxy_etf",
                  "d1",
                  "w1",
                  "m1",
                  "m3",
                  "ytd",
                  "as_of"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "slug",
          "name",
          "score",
          "rank",
          "ranked_of",
          "tier",
          "axes",
          "stocks_sampled",
          "stocks_scored",
          "proxy_etf_returns_pct",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "detail": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "slug": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "score": {
              "type": [
                "number",
                "null"
              ]
            },
            "rank": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "ranked_of": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "tier": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "strong",
                    "balanced",
                    "weak"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "axes": {
              "type": "object",
              "properties": {
                "valuation": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "growth": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "quality": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "safety": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "capital_return": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "momentum": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "sentiment": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "valuation",
                "growth",
                "quality",
                "safety",
                "capital_return",
                "momentum",
                "sentiment"
              ],
              "additionalProperties": false
            },
            "stocks_sampled": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "stocks_scored": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "proxy_etf_returns_pct": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "proxy_etf": {
                      "type": "string"
                    },
                    "d1": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "w1": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "m1": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "m3": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "ytd": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "as_of": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "proxy_etf",
                    "d1",
                    "w1",
                    "m1",
                    "m3",
                    "ytd",
                    "as_of"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "url": {
              "type": "string",
              "format": "uri"
            },
            "top_stocks": {
              "maxItems": 20,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "rank": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "symbol": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "score_in_scope": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "score_market": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "axes_in_scope": {
                    "type": "object",
                    "properties": {
                      "valuation": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "growth": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "quality": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "safety": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "capital_return": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "momentum": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "sentiment": {
                        "type": [
                          "number",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "valuation",
                      "growth",
                      "quality",
                      "safety",
                      "capital_return",
                      "momentum",
                      "sentiment"
                    ],
                    "additionalProperties": false
                  },
                  "url": {
                    "type": "string",
                    "format": "uri"
                  }
                },
                "required": [
                  "rank",
                  "symbol",
                  "name",
                  "score_in_scope",
                  "score_market",
                  "axes_in_scope",
                  "url"
                ],
                "additionalProperties": false
              }
            },
            "top_stocks_universe": {
              "type": "string"
            },
            "narrative": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "language": {
                      "type": "string",
                      "const": "ar"
                    },
                    "generated_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "text",
                    "language",
                    "generated_at"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "slug",
            "name",
            "score",
            "rank",
            "ranked_of",
            "tier",
            "axes",
            "stocks_sampled",
            "stocks_scored",
            "proxy_etf_returns_pct",
            "url",
            "top_stocks",
            "top_stocks_universe",
            "narrative"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "score_method": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "scope",
    "mode",
    "items",
    "detail",
    "score_method"
  ],
  "additionalProperties": false
}

{
  "scope": "sector",
  "mode": "list",
  "items": [],
  "detail": {
    "slug": "example",
    "name": "example",
    "score": 0,
    "rank": 0,
    "ranked_of": 0,
    "tier": "strong",
    "axes": {
      "valuation": 0,
      "growth": 0,
      "quality": 0,
      "safety": 0,
      "capital_return": 0,
      "momentum": 0,
      "sentiment": 0
    },
    "stocks_sampled": 0,
    "stocks_scored": 0,
    "proxy_etf_returns_pct": {
      "proxy_etf": "example",
      "d1": 0,
      "w1": 0,
      "m1": 0,
      "m3": 0,
      "ytd": 0,
      "as_of": "2026-10-09T00:00:00.000Z"
    },
    "url": "https://el7.ai/ar/news",
    "top_stocks": [],
    "top_stocks_universe": "example",
    "narrative": {
      "text": "example",
      "language": "ar",
      "generated_at": "2026-10-09T00:00:00.000Z"
    }
  },
  "score_method": "example"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_screener_presets

Lists EL7's curated stock-screener strategies (EL7 Leaders, Graham value, Buffett quality, Magic Formula, CAN SLIM, dividend growth, momentum, and the founder's own screens) with their criteria spelled out as thresholds (field, min, max, unit: score 0-100, percent or ratio). Use it to pick a preset id, then call el7_screener_run to get the matching stocks with their EL7 scores. Criteria are the screen's own thresholds, not data about any company.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "group": {
      "description": "Only presets from this group (founder, value, quality, growth, income, momentum, or card = the four headline strategy cards).",
      "type": "string",
      "enum": [
        "founder",
        "value",
        "quality",
        "growth",
        "income",
        "momentum",
        "card"
      ]
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "presets": {
      "maxItems": 80,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "group": {
            "type": "string"
          },
          "page_slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "criteria": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "group": {
                  "type": "string",
                  "enum": [
                    "universe",
                    "factor",
                    "fundamental"
                  ]
                },
                "min": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "max": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "unit": {
                  "type": "string",
                  "enum": [
                    "percent",
                    "ratio",
                    "score",
                    "currency",
                    "none"
                  ]
                },
                "value": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "field",
                "label",
                "group",
                "min",
                "max",
                "unit",
                "value"
              ],
              "additionalProperties": false
            }
          },
          "sorted_by": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "id",
          "name",
          "group",
          "page_slug",
          "criteria",
          "sorted_by",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "total": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "note": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "presets",
    "total",
    "note"
  ],
  "additionalProperties": false
}

{
  "presets": [],
  "total": 0,
  "note": "example"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_screener_run

Runs one of EL7's saved screener strategies over the US-listed stock universe and returns the matching stocks ranked by the preset's own sort (usually EL7 score): symbol, company, sector, industry, the EL7 overall score and the seven factor axes (0-100 percentiles at the chosen peer scope), sector rank, plus the total number of matches. No price, market cap or raw ratio is returned even when the preset filters on them. Get preset ids from el7_screener_presets; drill into a result with el7_stock_profile.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "preset": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "A preset id (e.g. el7Leaders, cheapQuality, magicFormula) or its page slug (e.g. el7-leaders, graham-value) from el7_screener_presets."
    },
    "scope": {
      "default": "market",
      "description": "Peer group the EL7 factor thresholds are measured against: whole market (default), the stock's sector or its industry.",
      "type": "string",
      "enum": [
        "market",
        "sector",
        "industry"
      ]
    },
    "limit": {
      "default": 20,
      "description": "Rows to return (1-50, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "preset"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "preset": {
      "type": "string"
    },
    "scope": {
      "type": "string",
      "enum": [
        "market",
        "sector",
        "industry"
      ]
    },
    "total_matches": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "returned": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "criteria": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "group": {
            "type": "string",
            "enum": [
              "universe",
              "factor",
              "fundamental"
            ]
          },
          "min": {
            "type": [
              "number",
              "null"
            ]
          },
          "max": {
            "type": [
              "number",
              "null"
            ]
          },
          "unit": {
            "type": "string",
            "enum": [
              "percent",
              "ratio",
              "score",
              "currency",
              "none"
            ]
          },
          "value": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "field",
          "label",
          "group",
          "min",
          "max",
          "unit",
          "value"
        ],
        "additionalProperties": false
      }
    },
    "results": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "sector": {
            "type": [
              "string",
              "null"
            ]
          },
          "industry": {
            "type": [
              "string",
              "null"
            ]
          },
          "el7_score": {
            "type": [
              "number",
              "null"
            ]
          },
          "axes": {
            "type": "object",
            "properties": {
              "valuation": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "growth": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "quality": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "safety": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "capital_return": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "momentum": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "sentiment": {
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "required": [
              "valuation",
              "growth",
              "quality",
              "safety",
              "capital_return",
              "momentum",
              "sentiment"
            ],
            "additionalProperties": false
          },
          "sector_rank": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "sector_peers": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "symbol",
          "name",
          "sector",
          "industry",
          "el7_score",
          "axes",
          "sector_rank",
          "sector_peers",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "preset",
    "scope",
    "total_matches",
    "returned",
    "criteria",
    "results",
    "url"
  ],
  "additionalProperties": false
}

{
  "preset": "example",
  "scope": "market",
  "total_matches": 0,
  "returned": 0,
  "criteria": [],
  "results": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_etf_flows

Which ETFs are gaining or losing money. Returns the biggest net inflows and net outflows over 1d/1w/1m/3m/1y, in USD and as a % of the fund's assets, computed by EL7 from daily share-count changes (creations/redemptions), with fund name, issuer and category. Funds whose summed flow exceeds 50% of assets are dropped as bad source data. Optionally filter by category or issuer. No fund prices or NAVs are returned. Use el7_etf_profile for one fund's flow history, grades and holdings.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "period": {
      "default": "1w",
      "description": "Window ending at the latest snapshot day: 1d, 1w, 1m, 3m or 1y.",
      "type": "string",
      "enum": [
        "1d",
        "1w",
        "1m",
        "3m",
        "1y"
      ]
    },
    "limit": {
      "default": 10,
      "description": "Rows per side (1-30, default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    },
    "category": {
      "description": "ETF category filter, e.g. Equity, Commodity, Fixed Income (case-insensitive exact match).",
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "issuer": {
      "description": "Issuer name contains, e.g. iShares, SPDR, Vanguard.",
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "enum": [
        "1d",
        "1w",
        "1m",
        "3m",
        "1y"
      ]
    },
    "window_start": {
      "type": [
        "string",
        "null"
      ]
    },
    "window_end": {
      "type": [
        "string",
        "null"
      ]
    },
    "top_inflows": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "issuer": {
            "type": [
              "string",
              "null"
            ]
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "net_flow_usd": {
            "type": "number"
          },
          "net_flow_pct_of_assets": {
            "type": [
              "number",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "symbol",
          "name",
          "issuer",
          "category",
          "net_flow_usd",
          "net_flow_pct_of_assets",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "top_outflows": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "issuer": {
            "type": [
              "string",
              "null"
            ]
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "net_flow_usd": {
            "type": "number"
          },
          "net_flow_pct_of_assets": {
            "type": [
              "number",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "symbol",
          "name",
          "issuer",
          "category",
          "net_flow_usd",
          "net_flow_pct_of_assets",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "funds_measured": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "method": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "period",
    "window_start",
    "window_end",
    "top_inflows",
    "top_outflows",
    "funds_measured",
    "method"
  ],
  "additionalProperties": false
}

{
  "period": "1d",
  "window_start": "example",
  "window_end": "example",
  "top_inflows": [],
  "top_outflows": [],
  "funds_measured": 0,
  "method": "example"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_etf_profile

EL7's view of one ETF: issuer and category; EL7 letter grades (overall, liquidity, cost, performance, volatility); return statistics in % (1m/3m/YTD/1y/3y/5y), volatility, Sharpe ratio, maximum drawdown and beta; EL7-computed net flows in USD over 1d/1w/1m/3m/YTD/1y; the change in share count (%) of the fund's largest holdings vs about a month earlier. No fund price, NAV, AUM, holding weights or sector weights are returned. Performance statistics carry their own computed_at stamp. Use el7_etf_flows to compare flows across funds.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9.^=_-]+$",
      "description": "ETF ticker, e.g. SPY, GLD, QQQ, VOO."
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "issuer": {
      "type": [
        "string",
        "null"
      ]
    },
    "category": {
      "type": [
        "string",
        "null"
      ]
    },
    "asset_focus": {
      "type": [
        "string",
        "null"
      ]
    },
    "holdings_count": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "inception_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "grades": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "overall": {
              "type": [
                "string",
                "null"
              ]
            },
            "liquidity": {
              "type": [
                "string",
                "null"
              ]
            },
            "cost": {
              "type": [
                "string",
                "null"
              ]
            },
            "performance": {
              "type": [
                "string",
                "null"
              ]
            },
            "volatility": {
              "type": [
                "string",
                "null"
              ]
            },
            "computed_at": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "overall",
            "liquidity",
            "cost",
            "performance",
            "volatility",
            "computed_at"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "performance": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "return_1m_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "return_3m_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "return_ytd_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "return_1y_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "return_3y_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "return_5y_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "volatility_1y_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "sharpe_ratio": {
              "type": [
                "number",
                "null"
              ]
            },
            "max_drawdown_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "beta": {
              "type": [
                "number",
                "null"
              ]
            },
            "computed_at": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "return_1m_pct",
            "return_3m_pct",
            "return_ytd_pct",
            "return_1y_pct",
            "return_3y_pct",
            "return_5y_pct",
            "volatility_1y_pct",
            "sharpe_ratio",
            "max_drawdown_pct",
            "beta",
            "computed_at"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "flows": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "d1_usd": {
              "type": [
                "number",
                "null"
              ]
            },
            "w1_usd": {
              "type": [
                "number",
                "null"
              ]
            },
            "m1_usd": {
              "type": [
                "number",
                "null"
              ]
            },
            "m3_usd": {
              "type": [
                "number",
                "null"
              ]
            },
            "ytd_usd": {
              "type": [
                "number",
                "null"
              ]
            },
            "y1_usd": {
              "type": [
                "number",
                "null"
              ]
            },
            "as_of": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "d1_usd",
            "w1_usd",
            "m1_usd",
            "m3_usd",
            "ytd_usd",
            "y1_usd",
            "as_of"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "holdings_changes": {
      "maxItems": 15,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "shares_change_pct": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "symbol",
          "name",
          "shares_change_pct"
        ],
        "additionalProperties": false
      }
    },
    "holdings_as_of": {
      "type": [
        "string",
        "null"
      ]
    },
    "holdings_compared_with": {
      "type": [
        "string",
        "null"
      ]
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "symbol",
    "name",
    "issuer",
    "category",
    "asset_focus",
    "holdings_count",
    "inception_date",
    "grades",
    "performance",
    "flows",
    "holdings_changes",
    "holdings_as_of",
    "holdings_compared_with",
    "url"
  ],
  "additionalProperties": false
}

{
  "symbol": "example",
  "name": "example",
  "issuer": "example",
  "category": "example",
  "asset_focus": "example",
  "holdings_count": 0,
  "inception_date": "2026-10-09T00:00:00.000Z",
  "grades": {
    "overall": "example",
    "liquidity": "example",
    "cost": "example",
    "performance": "example",
    "volatility": "example",
    "computed_at": "2026-10-09T00:00:00.000Z"
  },
  "performance": {
    "return_1m_pct": 0,
    "return_3m_pct": 0,
    "return_ytd_pct": 0,
    "return_1y_pct": 0,
    "return_3y_pct": 0,
    "return_5y_pct": 0,
    "volatility_1y_pct": 0,
    "sharpe_ratio": 0,
    "max_drawdown_pct": 0,
    "beta": 0,
    "computed_at": "2026-10-09T00:00:00.000Z"
  },
  "flows": {
    "d1_usd": 0,
    "w1_usd": 0,
    "m1_usd": 0,
    "m3_usd": 0,
    "ytd_usd": 0,
    "y1_usd": 0,
    "as_of": "2026-10-09T00:00:00.000Z"
  },
  "holdings_changes": [],
  "holdings_as_of": "2026-10-09T00:00:00.000Z",
  "holdings_compared_with": "example",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_analyst_firms

Wall Street analyst firms ranked by EL7's track-record score. For each firm: how many rating actions it has published, how many stocks it covers, its last-90-day mix of upgrades/downgrades/holds/initiations, its average stated target premium in %, and EL7's accuracy measures (hit rate, average return after calls, composite score, 1-5 star tier, percentile, price-target hit rate, direction win rate). Pass `slug` for one firm's detail: type, country, 24-month activity history, sector mix and per-sector hit rates. These are counts and rates computed by EL7 from rating actions; no prices are returned. Use el7_analyst_consensus for stocks where several firms recently aligned, el7_stock_profile for one stock's consensus.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "slug": {
      "description": "A firm slug (e.g. goldman-sachs) for the detail view with 24-month history. Omit for the ranked list.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "sort": {
      "default": "accuracy",
      "description": "List order: accuracy (EL7 composite track-record score) or activity (rating actions in the last 90 days).",
      "type": "string",
      "enum": [
        "accuracy",
        "activity"
      ]
    },
    "limit": {
      "default": 20,
      "description": "List mode: rows to return (1-50, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "list",
        "detail"
      ]
    },
    "firms": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "total_actions": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "symbols_covered": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "actions_90d": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "last_action": {
            "type": [
              "string",
              "null"
            ]
          },
          "pct_upgrades_90d": {
            "type": [
              "number",
              "null"
            ]
          },
          "pct_downgrades_90d": {
            "type": [
              "number",
              "null"
            ]
          },
          "pct_holds_90d": {
            "type": [
              "number",
              "null"
            ]
          },
          "pct_initiations_90d": {
            "type": [
              "number",
              "null"
            ]
          },
          "avg_target_premium_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "accuracy": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "settled_calls": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "hit_rate_pct": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "avg_return_pct": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "composite_score": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "star_tier": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "percentile_rank": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "target_hit_rate_pct": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "target_calls": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "direction_win_rate_pct": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "direction_calls": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "settled_calls",
                  "hit_rate_pct",
                  "avg_return_pct",
                  "composite_score",
                  "star_tier",
                  "percentile_rank",
                  "target_hit_rate_pct",
                  "target_calls",
                  "direction_win_rate_pct",
                  "direction_calls"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "slug",
          "name",
          "total_actions",
          "symbols_covered",
          "actions_90d",
          "last_action",
          "pct_upgrades_90d",
          "pct_downgrades_90d",
          "pct_holds_90d",
          "pct_initiations_90d",
          "avg_target_premium_pct",
          "accuracy",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "detail": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "slug": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "total_actions": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "symbols_covered": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "actions_90d": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "last_action": {
              "type": [
                "string",
                "null"
              ]
            },
            "pct_upgrades_90d": {
              "type": [
                "number",
                "null"
              ]
            },
            "pct_downgrades_90d": {
              "type": [
                "number",
                "null"
              ]
            },
            "pct_holds_90d": {
              "type": [
                "number",
                "null"
              ]
            },
            "pct_initiations_90d": {
              "type": [
                "number",
                "null"
              ]
            },
            "avg_target_premium_pct": {
              "type": [
                "number",
                "null"
              ]
            },
            "accuracy": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "settled_calls": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "hit_rate_pct": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "avg_return_pct": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "composite_score": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "star_tier": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "percentile_rank": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "target_hit_rate_pct": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "target_calls": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "direction_win_rate_pct": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "direction_calls": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "settled_calls",
                    "hit_rate_pct",
                    "avg_return_pct",
                    "composite_score",
                    "star_tier",
                    "percentile_rank",
                    "target_hit_rate_pct",
                    "target_calls",
                    "direction_win_rate_pct",
                    "direction_calls"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "url": {
              "type": "string",
              "format": "uri"
            },
            "firm_type": {
              "type": [
                "string",
                "null"
              ]
            },
            "country": {
              "type": [
                "string",
                "null"
              ]
            },
            "hq_city": {
              "type": [
                "string",
                "null"
              ]
            },
            "founded_year": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "actions_30d": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "actions_365d": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "sector_breakdown": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "number"
              }
            },
            "sector_hit_rates_pct": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "number"
              }
            },
            "monthly": {
              "maxItems": 24,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "month": {
                    "type": "string"
                  },
                  "actions": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "upgrades": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "downgrades": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "holds": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "initiations": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "avg_target_premium_pct": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "month",
                  "actions",
                  "upgrades",
                  "downgrades",
                  "holds",
                  "initiations",
                  "avg_target_premium_pct"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "slug",
            "name",
            "total_actions",
            "symbols_covered",
            "actions_90d",
            "last_action",
            "pct_upgrades_90d",
            "pct_downgrades_90d",
            "pct_holds_90d",
            "pct_initiations_90d",
            "avg_target_premium_pct",
            "accuracy",
            "url",
            "firm_type",
            "country",
            "hq_city",
            "founded_year",
            "actions_30d",
            "actions_365d",
            "sector_breakdown",
            "sector_hit_rates_pct",
            "monthly"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "method": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "mode",
    "firms",
    "detail",
    "method"
  ],
  "additionalProperties": false
}

{
  "mode": "list",
  "firms": [],
  "detail": {
    "slug": "example",
    "name": "example",
    "total_actions": 0,
    "symbols_covered": 0,
    "actions_90d": 0,
    "last_action": "example",
    "pct_upgrades_90d": 0,
    "pct_downgrades_90d": 0,
    "pct_holds_90d": 0,
    "pct_initiations_90d": 0,
    "avg_target_premium_pct": 0,
    "accuracy": {
      "settled_calls": 0,
      "hit_rate_pct": 0,
      "avg_return_pct": 0,
      "composite_score": 0,
      "star_tier": 0,
      "percentile_rank": 0,
      "target_hit_rate_pct": 0,
      "target_calls": 0,
      "direction_win_rate_pct": 0,
      "direction_calls": 0
    },
    "url": "https://el7.ai/ar/news",
    "firm_type": "example",
    "country": "example",
    "hq_city": "example",
    "founded_year": 0,
    "actions_30d": 0,
    "actions_365d": 0,
    "sector_breakdown": {},
    "sector_hit_rates_pct": {},
    "monthly": []
  },
  "method": "example"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_analyst_consensus

EL7's analyst-consensus detector: stocks where three or more independent firms published rating moves in the same direction within a 7-day window. Returns the stock, the direction (bullish/bearish), how many firms aligned, the window and the average target premium in %. Newest first. Use it to spot where Wall Street is converging, then el7_stock_profile for the stock's EL7 score and analyst counts or el7_analyst_firms for the firms' track records.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "direction": {
      "description": "Only bullish (upgrades/raised targets) or bearish alignments.",
      "type": "string",
      "enum": [
        "bullish",
        "bearish"
      ]
    },
    "days": {
      "default": 30,
      "description": "Look back this many days from today (1-90, default 30).",
      "type": "integer",
      "minimum": 1,
      "maximum": 90
    },
    "symbol": {
      "description": "Only this stock.",
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9.^=_-]+$"
    },
    "limit": {
      "default": 20,
      "description": "Rows to return (1-50, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "events": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "direction": {
            "type": "string",
            "enum": [
              "bullish",
              "bearish"
            ]
          },
          "firms": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "window_start": {
            "type": "string"
          },
          "window_end": {
            "type": "string"
          },
          "avg_target_premium_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "symbol",
          "name",
          "direction",
          "firms",
          "window_start",
          "window_end",
          "avg_target_premium_pct",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "method": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "events",
    "method"
  ],
  "additionalProperties": false
}

{
  "events": [],
  "method": "example"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_earnings_calendar

US-listed companies' earnings dates for a window (default: the next 7 days), ordered by date then size: report date, before-open/after-close timing, whether the date is confirmed or estimated, status (upcoming, reported, or pending results), whether EPS beat/missed/met consensus with the surprise in % (EPS and revenue) and the company's current beat streak, plus the number of reporters per day. Filter by company, sector, timing, status or beat streak. Reported/consensus EPS and revenue values themselves are not returned, only the surprise percentages. Use el7_stock_profile for the company's EL7 score, el7_calendar_events for macro releases.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "from": {
      "description": "Window start, YYYY-MM-DD. Default: today.",
      "type": "string"
    },
    "to": {
      "description": "Window end, YYYY-MM-DD (inclusive). Default: 7 days after `from`. Max 31 days from `from` (or 800 with `symbol`).",
      "type": "string"
    },
    "symbol": {
      "description": "Only this company (then the window may be up to 800 days, which gives its recent and upcoming reports).",
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9.^=_-]+$"
    },
    "sector": {
      "description": "A sector slug (technology) or sector name (Technology).",
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "report_time": {
      "description": "bmo = before market open, amc = after market close, during = market hours.",
      "type": "string",
      "enum": [
        "bmo",
        "amc",
        "during"
      ]
    },
    "status": {
      "description": "upcoming = future date; reported = results are in; pending = the date passed within 3 days and results are not in yet.",
      "type": "string",
      "enum": [
        "upcoming",
        "reported",
        "pending"
      ]
    },
    "min_beat_streak": {
      "description": "Only companies that beat estimates at least this many quarters in a row.",
      "type": "integer",
      "minimum": 1,
      "maximum": 40
    },
    "limit": {
      "default": 30,
      "description": "Rows to return (1-50, default 30).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "default": 0,
      "description": "Rows to skip (for paging).",
      "type": "integer",
      "minimum": 0,
      "maximum": 5000
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "from": {
      "type": "string"
    },
    "to": {
      "type": "string"
    },
    "total": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "returned": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "has_more": {
      "type": "boolean"
    },
    "events": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "sector": {
            "type": [
              "string",
              "null"
            ]
          },
          "date": {
            "type": "string"
          },
          "report_time": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "bmo",
                  "amc",
                  "during"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "date_confidence": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "confirmed",
                  "estimated"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "upcoming",
              "reported",
              "pending"
            ]
          },
          "eps_result": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "beat",
                  "miss",
                  "in_line"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "eps_surprise_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "revenue_surprise_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "beat_streak": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "symbol",
          "name",
          "sector",
          "date",
          "report_time",
          "date_confidence",
          "status",
          "eps_result",
          "eps_surprise_pct",
          "revenue_surprise_pct",
          "beat_streak",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "day_counts": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "integer",
        "minimum": -9007199254740991,
        "maximum": 9007199254740991
      }
    },
    "method": {
      "type": "string"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "from",
    "to",
    "total",
    "returned",
    "has_more",
    "events",
    "day_counts",
    "method"
  ],
  "additionalProperties": false
}

{
  "from": "example",
  "to": "example",
  "total": 0,
  "returned": 0,
  "has_more": false,
  "events": [],
  "day_counts": {},
  "method": "example"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_stock_rank

Ranks the whole EL7 stock universe (US-listed, Saudi Tadawul, or both) by the EL7 overall score or any one of the seven factor axes (valuation, growth, quality, safety, capital return, momentum, sentiment), using each stock's latest reported period. Filter by sector or industry and by a minimum/maximum score, sort best-first or worst-first, and page with offset. Each row has the symbol, company name (Arabic with lang=ar), market, sector, industry, rank, the chosen score, the overall score and all seven axes (0-100 percentiles) and a link to the stock page. Scores and ranks only: no price, market cap or raw ratio. Use el7_stock_profile to drill into a symbol, el7_score_movers for what changed lately, el7_screener_run for rule-based screens.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "factor": {
      "default": "overall",
      "description": "EL7 score to use: overall (the blended EL7 score) or one axis: valuation, growth, quality, safety, capital_return, momentum, sentiment.",
      "type": "string",
      "enum": [
        "overall",
        "valuation",
        "growth",
        "quality",
        "safety",
        "capital_return",
        "momentum",
        "sentiment"
      ]
    },
    "market": {
      "default": "us",
      "description": "us = NASDAQ/NYSE/AMEX stocks, sa = Saudi Tadawul stocks, all = both.",
      "type": "string",
      "enum": [
        "us",
        "sa",
        "all"
      ]
    },
    "sector": {
      "description": "Sector slug or name, e.g. technology, energy, financial-services (same sectors as el7_sector_overview).",
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "industry": {
      "description": "Industry name exactly as the site shows it in English, e.g. 'Software - Infrastructure', 'Banks - Regional' (case-insensitive).",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "min_score": {
      "description": "Only stocks whose chosen score is at least this (0-100).",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "max_score": {
      "description": "Only stocks whose chosen score is at most this (0-100).",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "order": {
      "default": "desc",
      "description": "desc = best score first (default), asc = worst first. Rank 1 is always the best score.",
      "type": "string",
      "enum": [
        "desc",
        "asc"
      ]
    },
    "limit": {
      "default": 20,
      "description": "Rows to return (1-50, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "default": 0,
      "description": "Rows to skip, for paging (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 20000
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "factor": {
      "type": "string",
      "enum": [
        "overall",
        "valuation",
        "growth",
        "quality",
        "safety",
        "capital_return",
        "momentum",
        "sentiment"
      ]
    },
    "market": {
      "type": "string",
      "enum": [
        "us",
        "sa",
        "all"
      ]
    },
    "order": {
      "type": "string",
      "enum": [
        "desc",
        "asc"
      ]
    },
    "total_ranked": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "offset": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "returned": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "results": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "symbol": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "market": {
            "type": "string",
            "enum": [
              "us",
              "sa"
            ]
          },
          "sector": {
            "type": [
              "string",
              "null"
            ]
          },
          "industry": {
            "type": [
              "string",
              "null"
            ]
          },
          "score": {
            "type": [
              "number",
              "null"
            ]
          },
          "overall": {
            "type": [
              "number",
              "null"
            ]
          },
          "axes": {
            "type": "object",
            "properties": {
              "valuation": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "growth": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "quality": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "safety": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "capital_return": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "momentum": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "sentiment": {
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "required": [
              "valuation",
              "growth",
              "quality",
              "safety",
              "capital_return",
              "momentum",
              "sentiment"
            ],
            "additionalProperties": false
          },
          "period_end": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "rank",
          "symbol",
          "name",
          "market",
          "sector",
          "industry",
          "score",
          "overall",
          "axes",
          "period_end",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "score_method": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "factor",
    "market",
    "order",
    "total_ranked",
    "offset",
    "returned",
    "results",
    "score_method",
    "url"
  ],
  "additionalProperties": false
}

{
  "factor": "overall",
  "market": "us",
  "order": "desc",
  "total_ranked": 0,
  "offset": 0,
  "returned": 0,
  "results": [],
  "score_method": "example",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_score_movers

Finds the stocks whose EL7 score (overall or one factor axis) changed the most between their two most recent reported periods, either the biggest gains (direction=up) or the biggest drops (direction=down), for US stocks, Saudi Tadawul stocks or both, optionally within one sector. Each row gives the previous score, the new score, the change in score points and both period-end dates. Scores are 0-100 market percentiles; no prices. Use el7_stock_score_history for one stock's full trail, el7_stock_profile for detail, el7_stock_rank for the current leaderboard.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "factor": {
      "default": "overall",
      "description": "EL7 score to use: overall (the blended EL7 score) or one axis: valuation, growth, quality, safety, capital_return, momentum, sentiment.",
      "type": "string",
      "enum": [
        "overall",
        "valuation",
        "growth",
        "quality",
        "safety",
        "capital_return",
        "momentum",
        "sentiment"
      ]
    },
    "direction": {
      "default": "up",
      "description": "up = biggest score gains, down = biggest score drops.",
      "type": "string",
      "enum": [
        "up",
        "down"
      ]
    },
    "market": {
      "default": "us",
      "description": "us = NASDAQ/NYSE/AMEX stocks, sa = Saudi Tadawul stocks, all = both.",
      "type": "string",
      "enum": [
        "us",
        "sa",
        "all"
      ]
    },
    "sector": {
      "description": "Sector slug or name, e.g. technology, energy, financial-services (same sectors as el7_sector_overview).",
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "limit": {
      "default": 20,
      "description": "Rows to return (1-50, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "factor": {
      "type": "string",
      "enum": [
        "overall",
        "valuation",
        "growth",
        "quality",
        "safety",
        "capital_return",
        "momentum",
        "sentiment"
      ]
    },
    "direction": {
      "type": "string",
      "enum": [
        "up",
        "down"
      ]
    },
    "market": {
      "type": "string",
      "enum": [
        "us",
        "sa",
        "all"
      ]
    },
    "returned": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "results": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "market": {
            "type": "string",
            "enum": [
              "us",
              "sa"
            ]
          },
          "sector": {
            "type": [
              "string",
              "null"
            ]
          },
          "industry": {
            "type": [
              "string",
              "null"
            ]
          },
          "previous_score": {
            "type": [
              "number",
              "null"
            ]
          },
          "new_score": {
            "type": [
              "number",
              "null"
            ]
          },
          "change": {
            "type": [
              "number",
              "null"
            ]
          },
          "previous_period_end": {
            "type": [
              "string",
              "null"
            ]
          },
          "new_period_end": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "symbol",
          "name",
          "market",
          "sector",
          "industry",
          "previous_score",
          "new_score",
          "change",
          "previous_period_end",
          "new_period_end",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "note": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "factor",
    "direction",
    "market",
    "returned",
    "results",
    "note",
    "url"
  ],
  "additionalProperties": false
}

{
  "factor": "overall",
  "direction": "up",
  "market": "us",
  "returned": 0,
  "results": [],
  "note": "example",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_stock_score_history

The history of one stock's EL7 score (overall or one factor axis) period by period, oldest first: the 0-100 percentile against the whole market, its sector or its industry, plus the rank and number of peers for sector/industry scope, and the change from the first to the last point returned. Mirrors the factor-trend chart on the stock page. Scores only, no prices. Use el7_stock_profile for the latest snapshot, el7_score_movers to find the stocks whose score moved most.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9.^=_-]+$",
      "description": "Stock ticker, e.g. AAPL, NVDA, or a Tadawul symbol such as 2222.SR."
    },
    "factor": {
      "default": "overall",
      "description": "EL7 score to use: overall (the blended EL7 score) or one axis: valuation, growth, quality, safety, capital_return, momentum, sentiment.",
      "type": "string",
      "enum": [
        "overall",
        "valuation",
        "growth",
        "quality",
        "safety",
        "capital_return",
        "momentum",
        "sentiment"
      ]
    },
    "scope": {
      "default": "market",
      "description": "Peer group the percentile is measured against: whole market (default), the stock's sector, or its industry. Sector/industry scopes also return the rank and peer count.",
      "type": "string",
      "enum": [
        "market",
        "sector",
        "industry"
      ]
    },
    "from": {
      "description": "Only periods ending on or after this date, YYYY-MM-DD. Default: all stored history.",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Most recent periods to return (1-60, default 20); the series is returned oldest first.",
      "type": "integer",
      "minimum": 1,
      "maximum": 60
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string"
    },
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "factor": {
      "type": "string",
      "enum": [
        "overall",
        "valuation",
        "growth",
        "quality",
        "safety",
        "capital_return",
        "momentum",
        "sentiment"
      ]
    },
    "scope": {
      "type": "string",
      "enum": [
        "market",
        "sector",
        "industry"
      ]
    },
    "returned": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "change_first_to_last": {
      "type": [
        "number",
        "null"
      ]
    },
    "series": {
      "maxItems": 60,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "period_end": {
            "type": "string"
          },
          "percentile": {
            "type": [
              "number",
              "null"
            ]
          },
          "rank": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "peers": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "period_end",
          "percentile",
          "rank",
          "peers"
        ],
        "additionalProperties": false
      }
    },
    "score_method": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "symbol",
    "name",
    "factor",
    "scope",
    "returned",
    "change_first_to_last",
    "series",
    "score_method",
    "url"
  ],
  "additionalProperties": false
}

{
  "symbol": "example",
  "name": "example",
  "factor": "overall",
  "scope": "market",
  "returned": 0,
  "change_first_to_last": 0,
  "series": [],
  "score_method": "example",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_stock_analysis

The analysis EL7 has already written and published for one stock (US or Tadawul), exactly as shown on the stock page: business overview, drivers, the buying case and selling case, a valuation read, what changed since the previous analysis, dated triggers that would change the view, and a ticker-specific FAQ, with its generation date and the filing it is based on. Served in the requested language (Arabic with lang=ar) when stored. Nothing is generated at call time; if a stock has no stored analysis the call says so. Use el7_stock_profile for the numeric EL7 scores, el7_stock_score_history for how they moved.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9.^=_-]+$",
      "description": "Stock ticker, e.g. AAPL, NVDA, or a Tadawul symbol such as 2222.SR."
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string"
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    },
    "requested_language_available": {
      "type": "boolean"
    },
    "generated_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "based_on_period_end": {
      "type": [
        "string",
        "null"
      ]
    },
    "based_on_filing_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "overview": {
      "maxItems": 8,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "drivers": {
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "buying_case": {
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "selling_case": {
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "valuation": {
      "type": [
        "string",
        "null"
      ]
    },
    "analyst_consensus_label": {
      "type": [
        "string",
        "null"
      ]
    },
    "what_changed": {
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "triggers": {
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "event": {
            "type": "string"
          },
          "when": {
            "type": "string"
          },
          "if_positive": {
            "type": [
              "string",
              "null"
            ]
          },
          "if_negative": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "event",
          "when",
          "if_positive",
          "if_negative"
        ],
        "additionalProperties": false
      }
    },
    "faq": {
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "question": {
            "type": "string"
          },
          "answer": {
            "type": "string"
          }
        },
        "required": [
          "question",
          "answer"
        ],
        "additionalProperties": false
      }
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "symbol",
    "language",
    "requested_language_available",
    "generated_at",
    "based_on_period_end",
    "based_on_filing_date",
    "overview",
    "drivers",
    "buying_case",
    "selling_case",
    "valuation",
    "analyst_consensus_label",
    "what_changed",
    "triggers",
    "faq",
    "url"
  ],
  "additionalProperties": false
}

{
  "symbol": "example",
  "language": "en",
  "requested_language_available": false,
  "generated_at": "2026-10-09T00:00:00.000Z",
  "based_on_period_end": "example",
  "based_on_filing_date": "2026-10-09T00:00:00.000Z",
  "overview": [],
  "drivers": [],
  "buying_case": [],
  "selling_case": [],
  "valuation": "example",
  "analyst_consensus_label": "example",
  "what_changed": [],
  "triggers": [],
  "faq": [],
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_earnings_history

A company's past earnings reports, newest first: fiscal period, report date, timing (before open / after close), whether EPS and revenue beat, missed or met consensus with the surprise in %, the current beat streak, and how the stock moved 1 and 5 trading days after each report (%). Mirrors the history table on the website's earnings page for the company. Reported and consensus EPS/revenue values and prices are not returned, only percentages. Use for 'does NVDA usually beat, and how does it trade after earnings?'. Related: el7_earnings_calendar for the next report date, el7_earnings_brief for EL7's written analysis of a report.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9.^=_-]+$",
      "description": "Stock ticker, e.g. NVDA, AAPL, BRK-B."
    },
    "quarters": {
      "default": 8,
      "description": "How many past reports to return, newest first (1-12, default 8).",
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "beat_streak": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "eps_beats": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "eps_misses": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "eps_in_line": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "avg_price_reaction_1d_pct": {
      "type": [
        "number",
        "null"
      ]
    },
    "reports": {
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "fiscal_period": {
            "type": [
              "string",
              "null"
            ]
          },
          "report_date": {
            "type": "string"
          },
          "report_time": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "bmo",
                  "amc",
                  "during"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "eps_result": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "beat",
                  "miss",
                  "in_line"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "eps_surprise_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "eps_basis_flag": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "gaap_likely",
                  "currency"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "revenue_result": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "beat",
                  "miss",
                  "in_line"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "revenue_surprise_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "price_reaction_1d_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "price_reaction_5d_pct": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "fiscal_period",
          "report_date",
          "report_time",
          "eps_result",
          "eps_surprise_pct",
          "eps_basis_flag",
          "revenue_result",
          "revenue_surprise_pct",
          "price_reaction_1d_pct",
          "price_reaction_5d_pct"
        ],
        "additionalProperties": false
      }
    },
    "method": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "symbol",
    "name",
    "beat_streak",
    "eps_beats",
    "eps_misses",
    "eps_in_line",
    "avg_price_reaction_1d_pct",
    "reports",
    "method",
    "url"
  ],
  "additionalProperties": false
}

{
  "symbol": "example",
  "name": "example",
  "beat_streak": 0,
  "eps_beats": 0,
  "eps_misses": 0,
  "eps_in_line": 0,
  "avg_price_reaction_1d_pct": 0,
  "reports": [],
  "method": "example",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_earnings_brief

EL7's own written analysis around a company's earnings report, exactly as stored for the website's earnings page: the pre-earnings brief (what to watch), the post-earnings summary (what happened) and the earnings-call summary. Returns the text in the requested language (falls back to the other language if only that one exists) with its report date and generation time. Pre-earnings briefs expire shortly after the report, so they are listed under missing_types once expired. Nothing is generated on request, and raw call transcripts are never returned. Related: el7_earnings_history for beats/misses and price reaction, el7_earnings_calendar for dates.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9.^=_-]+$",
      "description": "Stock ticker, e.g. NVDA, MU."
    },
    "type": {
      "default": "all",
      "description": "pre = EL7's pre-earnings brief, post = post-earnings summary, transcript = earnings-call summary, all = every stored one (default).",
      "type": "string",
      "enum": [
        "pre",
        "post",
        "transcript",
        "all"
      ]
    },
    "fiscal_date": {
      "description": "The report date (YYYY-MM-DD) to read. Omit for the latest stored one of each type.",
      "type": "string"
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string"
    },
    "briefs": {
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "pre",
              "post",
              "transcript"
            ]
          },
          "fiscal_date": {
            "type": "string"
          },
          "language": {
            "type": "string",
            "enum": [
              "en",
              "ar"
            ]
          },
          "text": {
            "type": "string"
          },
          "generated_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "expires_at": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "type",
          "fiscal_date",
          "language",
          "text",
          "generated_at",
          "expires_at"
        ],
        "additionalProperties": false
      }
    },
    "missing_types": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "pre",
          "post",
          "transcript"
        ]
      }
    },
    "note": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "symbol",
    "briefs",
    "missing_types",
    "note",
    "url"
  ],
  "additionalProperties": false
}

{
  "symbol": "example",
  "briefs": [],
  "missing_types": [],
  "note": "example",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_earnings_season

How the US earnings season is going: companies reported vs expected, how many beat, missed or met EPS consensus, the beat rate, the average (outlier-trimmed) EPS surprise %, and the same beat/miss counts per sector. Mirrors the season banner on the website's earnings calendar. Defaults to the current season, or the previous complete one in the first weeks of a new season. Use for 'how is earnings season going?'. Related: el7_earnings_calendar for who reports next, el7_earnings_history for one company.

stocks · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "season": {
      "description": "Reporting season as a calendar quarter of the REPORT date, e.g. 'Q3 2026'. Omit for the current season (the previous one while the current season has fewer than 200 reporters).",
      "type": "string",
      "pattern": "^Q[1-4] \\d{4}$"
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "season": {
      "type": "string"
    },
    "companies_reported": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "companies_expected": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "share_reported_pct": {
      "type": [
        "number",
        "null"
      ]
    },
    "beat": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "miss": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "in_line": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "beat_rate_pct": {
      "type": [
        "number",
        "null"
      ]
    },
    "avg_eps_surprise_pct": {
      "type": [
        "number",
        "null"
      ]
    },
    "sectors": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "sector": {
            "type": "string"
          },
          "reported": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "beat": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "miss": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "in_line": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "beat_rate_pct": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "sector",
          "reported",
          "beat",
          "miss",
          "in_line",
          "beat_rate_pct"
        ],
        "additionalProperties": false
      }
    },
    "computed_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "fallback_to_previous_season": {
      "type": "boolean"
    },
    "method": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "season",
    "companies_reported",
    "companies_expected",
    "share_reported_pct",
    "beat",
    "miss",
    "in_line",
    "beat_rate_pct",
    "avg_eps_surprise_pct",
    "sectors",
    "computed_at",
    "fallback_to_previous_season",
    "method",
    "url"
  ],
  "additionalProperties": false
}

{
  "season": "example",
  "companies_reported": 0,
  "companies_expected": 0,
  "share_reported_pct": 0,
  "beat": 0,
  "miss": 0,
  "in_line": 0,
  "beat_rate_pct": 0,
  "avg_eps_surprise_pct": 0,
  "sectors": [],
  "computed_at": "2026-10-09T00:00:00.000Z",
  "fallback_to_previous_season": false,
  "method": "example",
  "url": "https://el7.ai/ar/news"
}

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

el7_ai_search

Semantic search across EL7's archive: news stories, central-bank statements, minutes, press conferences, speeches and reports for the Fed, ECB, BoE, BoJ, BoC, RBA, RBNZ and SNB, weekly COT snapshots and prediction markets. Returns the most relevant passages with their source and date. Use it for open questions ("what did the ECB say about wage growth?"); then use the matching el7_cb_*, el7_news_*, el7_cot_* or el7_prediction tool for the full document or current numbers. Paid members only.

ai · product

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 3,
      "maxLength": 300,
      "description": "What to look for, in Arabic or English. A question or topic works best."
    },
    "sources": {
      "description": "Limit the search to these EL7 collections. Omit to search all of them.",
      "minItems": 1,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "news",
          "central_banks",
          "cot",
          "predictions"
        ]
      }
    },
    "from": {
      "description": "Earliest document date, YYYY-MM-DD.",
      "type": "string"
    },
    "to": {
      "description": "Latest document date, YYYY-MM-DD.",
      "type": "string"
    },
    "limit": {
      "default": 6,
      "description": "Passages to return (1-10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "lang": {
      "description": "Output language: 'en' (default) or 'ar' for EL7's stored Arabic text.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source_type": {
            "type": "string"
          },
          "source_group": {
            "type": "string"
          },
          "source_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "document_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "text": {
            "type": "string"
          },
          "score": {
            "type": [
              "number",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "source_type",
          "source_group",
          "source_id",
          "document_date",
          "text",
          "score",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "sources_searched": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "items",
    "sources_searched"
  ],
  "additionalProperties": false
}

{
  "items": [],
  "sources_searched": []
}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

get_news_context

Legacy alias of el7_news_search: search published EL7 news stories by keyword and meaning. Prefer el7_news_search.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "query": {
      "type": "string",
      "description": "News search query"
    },
    "category": {
      "description": "Filter by category: central_banks, forex, commodities, stocks, crypto, bonds, macro, geopolitics",
      "type": "string"
    },
    "instruments": {
      "description": "Accepted for compatibility; not used as a filter",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "limit": {
      "description": "Max results (default 10, max 25)",
      "type": "number"
    }
  },
  "required": [
    "query"
  ]
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_economic_context

Legacy alias of el7_calendar_events: upcoming economic releases (CPI, NFP, GDP …) with forecasts, previous values, dates and times. Prefer el7_calendar_events.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "event_name": {
      "description": "Accepted for compatibility; not used as a filter",
      "type": "string"
    },
    "country": {
      "description": "Country code (e.g. 'US', 'EU', 'GB', 'JP')",
      "type": "string"
    },
    "impact": {
      "description": "Filter by impact level",
      "type": "string",
      "enum": [
        "high",
        "medium",
        "low"
      ]
    },
    "days_ahead": {
      "description": "Look ahead N days (default 7, max 30)",
      "type": "number"
    }
  }
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

search_knowledge_base

Semantic search across EL7.AI's knowledge base for historical documents: Fed statements, BLS reports, news, central bank decisions, gold/oil/COT analysis. NOT for upcoming events or calendar — use get_economic_context for that.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "query": {
      "type": "string",
      "description": "Natural language search query"
    },
    "source_types": {
      "description": "Filter to specific source types: fomc_statement, bls_analysis, economic_calendar, news_story, ecb_decision, boe_decision, boj_decision, gold_daily_snapshot, oil_daily_snapshot, cot_weekly_snapshot, econ_intelligence",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "limit": {
      "description": "Max results (default 5, max 20)",
      "type": "number"
    }
  },
  "required": [
    "query"
  ]
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_market_snapshot

Get current market snapshot for instruments including latest price, features, and intelligence enrichments.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "tickers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Instrument tickers (e.g. ['BTCUSD', 'XAUUSD'])"
    },
    "include_intelligence": {
      "description": "Include MIPL intelligence payload (default true)",
      "type": "boolean"
    }
  },
  "required": [
    "tickers"
  ]
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_central_bank_context

Get central bank monetary policy decisions and tone analysis. Covers Fed, ECB, BOE, BOJ.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "banks": {
      "description": "Which central banks (default: all)",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "fed",
          "ecb",
          "boe",
          "boj"
        ]
      }
    },
    "query": {
      "description": "Optional query to filter decisions",
      "type": "string"
    },
    "limit": {
      "description": "Max results per bank",
      "type": "number"
    }
  }
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

cross_domain_query

Auto-detects relevant data domains and searches across them. Use for multi-topic questions (e.g. 'how did gold react to CPI surprise?'). For simple calendar/events queries, use get_economic_context instead. For simple price queries, use get_market_snapshot instead.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "query": {
      "type": "string",
      "description": "Cross-domain natural language query"
    },
    "max_tokens": {
      "description": "Max context tokens (default 4000)",
      "type": "number"
    }
  },
  "required": [
    "query"
  ]
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_historical_prices

Get historical OHLCV price bars for any instrument. Supports date range (from_date/to_date) or event window (around_date ± window_days). Use for backtesting, charting, or looking up prices on specific dates.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Instrument ticker (e.g. 'XAUUSD', 'BTCUSD', 'DXY')"
    },
    "interval": {
      "description": "Bar interval (default '1d')",
      "type": "string",
      "enum": [
        "1m",
        "15m",
        "30m",
        "4h",
        "1d"
      ]
    },
    "from_date": {
      "description": "Start date (ISO format, e.g. '2025-01-01')",
      "type": "string"
    },
    "to_date": {
      "description": "End date (ISO format)",
      "type": "string"
    },
    "around_date": {
      "description": "Center date for event window lookup (e.g. '2025-03-18'). Returns bars within ±window_days.",
      "type": "string"
    },
    "window_days": {
      "description": "Days before/after around_date (default 5)",
      "type": "number"
    },
    "limit": {
      "description": "Max bars to return (default 50, max 200)",
      "type": "number"
    }
  },
  "required": [
    "ticker"
  ]
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_event_price_reaction

Statistical analysis of how an asset reacts to specific events. Computes avg % change, win rate, std dev, max gain/loss across all historical occurrences. Supports FOMC meetings and calendar events (CPI, NFP, GDP, etc.).

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "event_type": {
      "type": "string",
      "description": "Event type: 'fomc' for Fed meetings, 'ecb' for ECB rate decisions, 'boe' for BOE rate decisions, 'boj' for BOJ rate decisions, or calendar event name like 'CPI', 'NFP', 'GDP', 'Jobless Claims'"
    },
    "ticker": {
      "description": "Instrument ticker (default 'XAUUSD')",
      "type": "string"
    },
    "decision_filter": {
      "description": "For FOMC: filter by 'hike', 'cut', or 'hold'",
      "type": "string"
    },
    "country": {
      "description": "Country code for calendar events (default 'US')",
      "type": "string"
    },
    "reaction_window_days": {
      "description": "Days after event to measure reaction (default 5)",
      "type": "number"
    },
    "since": {
      "description": "Start date for analysis (default '2015-01-01')",
      "type": "string"
    },
    "dissent_only": {
      "description": "For FOMC: filter to only meetings with dissenting votes (default false)",
      "type": "boolean"
    }
  },
  "required": [
    "event_type"
  ]
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_cycle_analysis

Analyze asset performance during central bank rate cycles (hiking, cutting, hold). Returns per-cycle price returns, durations, and aggregate statistics by cycle type.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "central_bank": {
      "description": "Central bank (default 'fed')",
      "type": "string",
      "enum": [
        "fed",
        "ecb"
      ]
    },
    "cycle_type": {
      "description": "Filter to specific cycle type (default: all)",
      "type": "string",
      "enum": [
        "hiking",
        "cutting",
        "hold"
      ]
    },
    "ticker": {
      "description": "Instrument ticker (default 'XAUUSD')",
      "type": "string"
    }
  }
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_cot_positioning

Get CFTC Commitments of Traders positioning data. Returns net speculative position, z-scores, percentile, trend direction, and week-over-week changes. Supports gold, crude oil, S&P 500, currencies, and more.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "market": {
      "type": "string",
      "description": "Market name (e.g. 'gold', 'crude oil', 'S&P 500', 'euro', 'yen') or CFTC code"
    },
    "weeks": {
      "description": "Number of weeks of history (default 4, max 208 for ~4 years)",
      "type": "number"
    },
    "as_of_date": {
      "description": "Get positioning as of a specific date (ISO format, e.g. '2022-03-16'). Returns data up to this date. Useful for comparing cycle start vs end.",
      "type": "string"
    }
  },
  "required": [
    "market"
  ]
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_surprise_analysis

Rank economic data surprises by z-score magnitude and show the corresponding asset price reaction. Find the biggest CPI misses, NFP shocks, etc. and how markets reacted each time.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "event_name": {
      "description": "Event name filter (e.g. 'CPI', 'NFP', 'GDP'). NULL for all events.",
      "type": "string"
    },
    "country": {
      "description": "Country code (default 'US')",
      "type": "string"
    },
    "ticker": {
      "description": "Instrument to measure price reaction (default 'XAUUSD')",
      "type": "string"
    },
    "min_surprise_zscore": {
      "description": "Minimum absolute z-score threshold (default 0)",
      "type": "number"
    },
    "tickers": {
      "description": "Multiple tickers for cross-asset reaction (e.g. ['XAUUSD', 'DXY']). When provided, shows each ticker's reaction per event.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "limit": {
      "description": "Max events to return (default 20)",
      "type": "number"
    },
    "since": {
      "description": "Start date (default '2015-01-01')",
      "type": "string"
    }
  }
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_surprise_by_event_type

Rank economic event types by their average absolute surprise z-score. Shows which event types (CPI, NFP, GDP, etc.) produce the biggest data surprises, with price reaction stats for each.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "country": {
      "description": "Country code (default 'US')",
      "type": "string"
    },
    "ticker": {
      "description": "Instrument to measure price reaction (default 'XAUUSD')",
      "type": "string"
    },
    "since": {
      "description": "Start date (default '2020-01-01')",
      "type": "string"
    },
    "min_events": {
      "description": "Minimum events per type to include (default 5)",
      "type": "number"
    },
    "limit": {
      "description": "Top N event types (default 10)",
      "type": "number"
    }
  }
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_central_bank_tone_ranking

Rank Fed, ECB, BOE, and BOJ by their most recent tone score. Shows which central bank is currently most hawkish vs dovish based on quantified tone analysis.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_economic_surprise_index

Economic Surprise Index (ESI) — weighted average of recent economic data surprises per country. Positive ESI means data consistently beating forecasts (economy stronger than expected). Shows 30-day and 90-day rolling ESI, beat/miss rates, and regime classification.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "country": {
      "description": "Country code filter (e.g. 'US', 'EU', 'GB', 'JP'). Omit for all countries.",
      "type": "string"
    }
  }
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_market_breadth

Market momentum breadth — percentage of instruments above SMA50/200, RSI distribution, trend distribution, and golden/death cross counts. Broken down by asset class. Use to gauge whether broad market is in bullish or bearish regime.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "asset_class": {
      "description": "Filter by asset class (e.g. 'forex', 'crypto', 'commodity', 'stock', 'index'). Omit for all.",
      "type": "string"
    }
  }
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_gold_conditions

Composite gold conditions index (0-100). Aggregates real yields, DXY, COT positioning, breakeven inflation, VIX/GVZ, and ETF flows into a single bullish/bearish score. Use for gold outlook analysis.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_cross_asset_correlations

NxN cross-asset return correlation matrix. Default: top 10 instruments (gold, DXY, oil, BTC, ETH, EUR, GBP, JPY, 10Y, SPX) over 90-day window. Shows strongest positive and negative correlations. Use for portfolio diversification analysis.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "window_days": {
      "description": "Lookback window in days: 30, 90, 180, or 365 (default 90)",
      "type": "number"
    },
    "tickers": {
      "description": "Custom tickers to correlate (default: top 10 instruments)",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_vol_regime

Market-wide volatility regime classification. Aggregates VIX and per-asset-class RSI extremes into a composite score. Regimes: low, normal, elevated, extreme. Use to gauge overall market risk conditions.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_price_seasonality

Monthly price seasonality statistics for any instrument. Shows average return, win rate, best/worst month from up to 10 years of history. Use for seasonal trading patterns.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Instrument ticker (e.g. 'XAUUSD', 'BTCUSD', 'SPX')"
    }
  },
  "required": [
    "ticker"
  ]
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_yield_curve

US Treasury yield curve (3M-30Y), spreads (2s10s, 3m10y), regime, and Fed Funds rate. Use for rate analysis and recession signals.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "date": {
      "description": "YYYY-MM-DD for historical. Omit for latest.",
      "type": "string"
    }
  }
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}

get_statement_diff

Sentence-level diff between consecutive central bank statements with tone changes. Supports Fed and ECB.

legacy · admin_only_legacy

Input schema and example

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "bank": {
      "description": "Central bank (default: fed)",
      "type": "string",
      "enum": [
        "fed",
        "ecb"
      ]
    },
    "document_type": {
      "type": "string",
      "enum": [
        "statement",
        "minutes",
        "press_conference"
      ]
    },
    "meeting_date": {
      "description": "YYYY-MM-DD. Omit for latest.",
      "type": "string"
    }
  }
}

Output schema and synthetic example

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "as_of": {
      "description": "Source freshness: the newest source timestamp behind this result, or null when none is verified. Never request time.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": {
    "$ref": "#/$defs/__schema0"
  },
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}

{}

Annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}