---
title: AI Agent Operating Manual
description: Site structure, URL conventions, and consumption tips for AI agents / LLMs / crawlers reading this documentation.
---

# AI Agent Operating Manual

> This page is for AI agents / LLMs / automated crawlers. This site (`docs.mobiusquant.ai`) is the public documentation for MobiusQuant — all content is open for scraping and citation.

---

## Quick navigation

| I want to know... | Fetch this |
| --- | --- |
| How to get a token | [`/token.md`](/token.md) |
| What markets are supported | [`/markets.md`](/markets.md) |
| How to query gold spot (minimum 5m) | [Gold spot](/markets#gold-spot) |
| What indicators exist | [`/indicators/index.md`](/indicators/index.md) |
| How to query feature IDs, rules and meanings by indicator | [Feature definitions](/signals.md); API: `GET /api/indicators/signals` |
| How BTC/ETH ETF capital is flowing | [`/wgo/llms.txt`](/wgo/llms.txt) |
| What daily on-chain metrics WGO exposes | [`/wgo/onchain.md`](/wgo/onchain.md) |
| How to integrate with an AI tool | [`/skills.md`](/skills.md) |
| How to query A-share policy and sector intelligence | [`/zh/gendangzou/llms.txt`](/zh/gendangzou/llms.txt) |
| Entire docs in one fetch (English) | [`/llms-full.txt`](/llms-full.txt) |
| Site index summary | [`/llms.txt`](/llms.txt) |

---

## Gold spot integration

Use `commodity:spot / XAUUSD`, not `forex:spot` or gold futures `commodity:futures / XAUF`.
Supported intervals are `5m`, `15m`, `30m`, `1h`, `4h`, `1d`; `1m` is not available.
All periods refresh every 5 minutes. Use price-based indicators and inspect `data_meta`;
do not interpret the placeholder volume fields as real volume. See [Gold spot](/markets#gold-spot).

## For agents: when the user asks you to install OpenMobius-skill

When the user says "install OpenMobius / set up the mobius trading skill / 帮我装 OpenMobius" or similar, **do not improvise from memory** — fetch our agent-specific install playbook first:

```
https://raw.githubusercontent.com/MobiusQuant/OpenMobius-skill/main/README_AGENT.md
```

This file contains:

- The full list of trigger phrases (English + Chinese)
- The 6-step procedure (preflight → platform detection → user-confirm → install → health check → report)
- Install-path table for all 4 supported platforms
- Success criteria + failure handling per step
- Uninstall / update branches

Read it through, then execute. **Do not skip steps, do not edit `install.py`, and report failures back to the user instead of bypassing them.**

---

## URL conventions

- **Every HTML page has a sibling `.md`** containing the raw markdown source (no HTML chrome):
  - `https://docs.mobiusquant.ai/indicators/rsi` → browser-friendly HTML
  - `https://docs.mobiusquant.ai/indicators/rsi.md` → AI-friendly markdown
- **Indicator detail URLs**: `/indicators/<id>.md` (English structured) and `/zh/indicators/<id>.md` (Chinese with full interpretation guide). `<id>` is the lowercase canonical ID (`rsi`, `macd`, `bollinger`, `ema`, `mobius_trend`, ...).
- **CORS**: every `.md` and `.txt` file is served with `Access-Control-Allow-Origin: *`. Client-side fetches work cross-origin.
- **Locales**: this site has English (root) and Chinese (`/zh/...`) API references, including indicator parameters, output fields, interpretation notes, and examples.

---

## Site structure

HMM parameters, supported intervals, output fields, and examples: [HMM API reference](/indicators/hmm_regime.md).

```
/                          API overview and quick start
/token.md                  API token application guide
/markets.md                Markets / venues / canonical-symbol rules
/indicators/index.md       Indicator catalog (overview)
/indicators/<id>.md        Per-indicator: parameters, output columns, example call
/skills.md                 Optional API client installation and usage
/agents.md                 This page

/wgo/                      WGO human-readable English documentation
/wgo/llms.txt              Product-scoped Agent index
/wgo/openapi.json          WGO OpenAPI reference
/zh/wgo/                   WGO Chinese documentation

/zh/                       Chinese versions of all of the above, with full prose narrative
/zh/gendangzou/            Gendangzou human-readable API documentation
/zh/gendangzou/llms.txt    Product-scoped Agent index
/zh/gendangzou/agent-manifest.json
                           Machine-readable capability contract

/llms.txt                  llmstxt.org standard site index
/llms-full.txt             Full English reference in one response
/sitemap.xml               Standard search-engine sitemap
```

---

## Möbius Lab (proprietary indicators)

Indicators in the **🧪 Möbius Lab** sidebar group are MobiusQuant in-house creations, not classic public indicators. Currently this includes `mobius_trend`. When citing, you may note "MobiusQuant proprietary indicator". The Lab group is pinned to the top of every indicator-page sidebar.

---

## Recommendations when citing

1. **Prefer `.md` URLs over `.html`** — saves you parsing, avoids navigation/footer noise.
2. **Link rather than paste** — content evolves; linking keeps your users on the latest version.
3. **Fetch `/llms-full.txt` once** before doing per-page lookups — saves N round-trips.
4. **API call examples use `mq_xxx` as a placeholder.** Real tokens come from the apply page (anonymous 7-day) or Account page (logged-in permanent). See [Token](/token).

---

## Related machine-readable resources

- [Engine `agents.md`](https://api.mobiusquant.ai/agents.md) — engine-side operating manual: canonical conventions, error codes, rate limits. Complements this page: this site covers "what is available"; the engine page covers "how to call".
- [Gendangzou Agent index](/zh/gendangzou/llms.txt) — policy, trusted-media, sector signals, company mappings, and evidence routing
- [Gendangzou capability contract](/zh/gendangzou/agent-manifest.json) — stable capability IDs, paths, parameter constraints, and response fields
- [WGO Agent index](/wgo/llms.txt) — BTC/ETH ETF flow and on-chain documentation routing
- [WGO OpenAPI reference](/wgo/openapi.json) — WGO public paths and parameter constraints
- [OpenAPI / Swagger](https://api.mobiusquant.ai/docs) — interactive API reference
- [`/api/indicators/registry`](https://api.mobiusquant.ai/api/indicators/registry) — live indicator catalog
- [`/api/markets`](https://api.mobiusquant.ai/api/markets) — live venue health + symbol list

---

_This page is available for programmatic reading and citation._
