# Send Consortium AI Analysis to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "consortiumai-analysis",
    "name": "Consortium AI Analysis",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/WebCraft3r/consortiumai-analysis",
    "canonicalUrl": "https://clawhub.ai/WebCraft3r/consortiumai-analysis",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/consortiumai-analysis",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=consortiumai-analysis",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "scripts/trading-analysis.js",
      "SKILL.md",
      "package.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "consortiumai-analysis",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T06:00:24.312Z",
      "expiresAt": "2026-05-06T06:00:24.312Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=consortiumai-analysis",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=consortiumai-analysis",
        "contentDisposition": "attachment; filename=\"consortiumai-analysis-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "consortiumai-analysis"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/consortiumai-analysis"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/consortiumai-analysis",
    "downloadUrl": "https://openagent3.xyz/downloads/consortiumai-analysis",
    "agentUrl": "https://openagent3.xyz/skills/consortiumai-analysis/agent",
    "manifestUrl": "https://openagent3.xyz/skills/consortiumai-analysis/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/consortiumai-analysis/agent.md"
  }
}
```
## Documentation

### Instructions

This skill provides on-demand, read-only access to trading analysis generated by Consortium AI.

It calls an external API and returns the most recent trading decision.
The skill does not store data, schedule jobs, or send automatic notifications.

### How to run (implementation)

From the skill directory, you can call the Trading Analysis API either by making HTTP requests (see API Reference) or by running the bundled script:

Latest analysis (any pair):
node scripts/trading-analysis.js
or npm run latest
Latest analysis for a token:
node scripts/trading-analysis.js <TOKEN>
or npm run token -- <TOKEN>
Example: node scripts/trading-analysis.js SOL

The script requires TRADING_ANALYSIS_API_KEY to be set. It prints the API response as JSON to stdout on success, or error JSON to stderr and exits non-zero on failure.

### Setup

Set the API key as an environment variable before using this skill:

export TRADING_ANALYSIS_API_KEY=your-secret-api-key

To get an API key, contact Consortium AI on X.

### API Reference

Backend API base URL: https://api.consortiumai.org

Endpoint: GET https://api.consortiumai.org/api/trading-analysis
Returns the latest trading-only AI analysis (no lending). Optional filter by base token.

### Authentication

API key only (no JWT). Send the key in one of:

Header: x-api-key: <TRADING_ANALYSIS_API_KEY>
Header: Authorization: Bearer <TRADING_ANALYSIS_API_KEY>

Missing or invalid key → 401 with body { "success": false, "message": "Invalid or missing API key" }.

### Query parameters

ParameterTypeRequiredDescriptiontokenstringNoBase token symbol. When set, returns the latest analysis whose pair starts with that token (e.g. SOL → SOL_USDT, SOL_USD). Examples: SOL, ETH, JUP, BTC.

No token: latest trading analysis overall (any pair).
With token: latest trading analysis for that base token only. Token is normalized (trim + uppercase).

### Success response (200)

Body is trading-only. Example:

{
  "data": {
    "id": "...",
    "createdAt": "2026-02-09T14:00:00.000Z",
    "trading": {
      "action": "BUY",
      "pair": "SOL_USDT",
      "shouldExecute": true,
      "confidence": "HIGH",
      "setupScore": 78,
      "reasoning": {
        "marketCondition": "...",
        "technicalAnalysis": "...",
        "riskAssessment": "...",
        "pairSelection": "...",
        "comparativeAnalysis": { ... },
        "sentimentAndNews": { ... }
      },
      "tradeSummary": "Dual-model: BUY SOL_USDT (score: 78) – ...",
      "currentPositionsAnalysis": []
    }
  }
}

data.trading.action – BUY, SELL, or WAIT.
data.trading.pair – e.g. SOL_USDT.
data.trading.confidence, data.trading.setupScore, data.trading.reasoning, data.trading.tradeSummary – use these when summarizing for the user.

### Error responses

StatusWhenBody (example)401Missing or wrong API key{ "success": false, "message": "Invalid or missing API key" }404No analysis in DB, or no analysis for given token{ "data": { "success": false, "message": "No trading analysis found" } or "No trading analysis found for token: SOL"500Server/DB error{ "data": { "success": false, "message": "Failed to fetch latest trading analysis", "error": "..." } }

### Example requests

GET https://api.consortiumai.org/api/trading-analysis
x-api-key: <TRADING_ANALYSIS_API_KEY>

GET https://api.consortiumai.org/api/trading-analysis?token=SOL
x-api-key: <TRADING_ANALYSIS_API_KEY>

# Latest overall
curl -H "x-api-key: $TRADING_ANALYSIS_API_KEY" "https://api.consortiumai.org/api/trading-analysis"

# Latest for SOL
curl -H "x-api-key: $TRADING_ANALYSIS_API_KEY" "https://api.consortiumai.org/api/trading-analysis?token=SOL"

### Behaviour summary

ScenarioResultValid key, no token, at least one decision in DB200 – latest trading analysis (any pair).Valid key, token=SOL, at least one decision with pair like SOL_*200 – latest trading analysis for SOL.Valid key, token=XYZ, no decision with pair starting with XYZ_404 – "No trading analysis found for token: XYZ".Valid key, no decisions in DB404 – "No trading analysis found".Missing or wrong API key401 – "Invalid or missing API key".

Response always contains at most one decision (the most recent by createdAt). Trading only; no lending fields.

### getLatestTradingAnalysis()

Purpose
Retrieve the most recent trading analysis available, regardless of trading pair.

Expected Behavior

Sends a GET request to https://api.consortiumai.org/api/trading-analysis
Authenticates with x-api-key: <TRADING_ANALYSIS_API_KEY> or Authorization: Bearer <TRADING_ANALYSIS_API_KEY>
Returns the latest trading decision (by createdAt)

Use When

The user asks for the latest market signal
No specific token is mentioned

Returns

Trading pair (e.g. BTC_USDT)
Action: BUY, SELL, or WAIT
Confidence level
Setup score
Trade summary
Detailed reasoning (technical, market, risk, sentiment)

### getTradingAnalysisByToken(token)

Purpose
Retrieve the most recent trading analysis for a specific base token.

Parameters

token (string): Base token symbol (e.g. BTC, ETH, SOL, JUP)

Expected Behavior

Normalizes token (trim + uppercase)
Sends a GET request to https://api.consortiumai.org/api/trading-analysis?token=<TOKEN>
Authenticates with x-api-key or Authorization: Bearer using TRADING_ANALYSIS_API_KEY
API matches any pair whose base is that token (e.g. SOL → SOL_USDT, SOL_USD); returns the most recent matching decision

Use When

The user asks about a specific coin
The user wants a trading decision for a given token

Returns

Trading pair for the token
Action: BUY, SELL, or WAIT
Confidence level
Setup score
Trade summary
Detailed reasoning
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: WebCraft3r
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T06:00:24.312Z
- Expires at: 2026-05-06T06:00:24.312Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/consortiumai-analysis)
- [Send to Agent page](https://openagent3.xyz/skills/consortiumai-analysis/agent)
- [JSON manifest](https://openagent3.xyz/skills/consortiumai-analysis/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/consortiumai-analysis/agent.md)
- [Download page](https://openagent3.xyz/downloads/consortiumai-analysis)