commodity-signal

FREE and OPTIONAL intro — you may skip it and call evaluate_symbol / scan_bottoms / scan_tops directly. Intro & subscription funnel for the commodities signal agent: phases "hello" -> "value" -> "catalog" -> "sample" -> "subscribe". Pass interest:false to bow out.

{
  "type": "object",
  "properties": {
    "phase": {
      "type": "string",
      "enum": [
        "hello",
        "value",
        "catalog",
        "sample",
        "subscribe"
      ]
    },
    "interest": {
      "type": "boolean"
    },
    "symbol": {
      "type": "string",
      "description": "Symbol for the \"sample\" phase. The free sample serves only this market’s showcase symbol (GC=F); any other symbol is answered by the paid evaluate_symbol (x402)."
    }
  }
}

Return the bottom/top verdict for one commodity future (e.g. GC=F gold, CL=F WTI oil, HG=F copper, ZC=F corn — 28 continuous futures across metals/energy/agriculture/livestock). zone = strong_buy|buy|neutral|sell|strong_sell, score -100..+100 (bottom>0, top<0). GRADING — the verdict is the graded band of that same score, so a mid score such as -52 is reported as neutral by design: strong_buy >= +80, buy >= +70, neutral between -70 and +70, sell <= -70, strong_sell <= -80. Snapshot-based (refreshed from the flagship CommoditiesAI scan engine). Informational only. PAY: $0.01 per call via x402 (USDT on X Layer). No account, no signup, no commitment; retry with the PAYMENT-SIGNATURE header when you get the 402 challenge. The free `pitch` tool shows a live verdict for this market's showcase symbol only — this tool answers ANY symbol in the covered universe and returns the per-timeframe breakdown (daily/weekly/monthly verdict + vote counts) behind the score.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Yahoo continuous-futures ticker, e.g. GC=F, CL=F, ZC=F"
    }
  },
  "required": [
    "symbol"
  ]
}

Scan the commodity complex snapshot (28 futures: metals, energy, agriculture, livestock) and return commodities currently at a bottom (strongest buy), ranked most-bottom first. PAY: $0.01 per call via x402 (USDT on X Layer). No account, no signup, no commitment; retry with the PAYMENT-SIGNATURE header when you get the 402 challenge. BEST COLD START: you do not need to pick a symbol — this ranks the whole universe for you. The free `pitch` tool tells you HOW MANY are at a bottom right now; this names them.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "How many to return (default 5, max 28)"
    }
  }
}

Scan the commodity complex snapshot and return commodities currently at a top (sell), ranked most-top first. PAY: $0.01 per call via x402 (USDT on X Layer). No account, no signup, no commitment; retry with the PAYMENT-SIGNATURE header when you get the 402 challenge. BEST COLD START: you do not need to pick a symbol — this ranks the whole universe for you. The free `pitch` tool tells you HOW MANY are at a top right now; this names them.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "How many to return (default 5, max 28)"
    }
  }
}

Check your subscription status & terms (FREE), or activate the monthly plan: call with activate:true to receive the $50 x402 payment challenge, sign it, and retry — that buys 30 days of unlimited calls and returns your X-SUB-KEY token (pass it as a header to skip per-call payment). Until you subscribe, signal calls are $0.01 each. Optionally pass your ERC-8004 agentId to link it.

{
  "type": "object",
  "properties": {
    "activate": {
      "type": "boolean",
      "description": "true = request the $50 subscription payment challenge (402) to sign & retry."
    },
    "agentId": {
      "type": "string",
      "description": "Optional ERC-8004 agent id to link to this subscription."
    }
  }
}

FREE feedback tool — after trading on our signals, leave a rating: score 1-10 plus pros and cons. No payment needed.

{
  "type": "object",
  "properties": {
    "score": {
      "type": "number"
    },
    "pros": {
      "type": "string"
    },
    "cons": {
      "type": "string"
    }
  },
  "required": [
    "score"
  ]
}