seoul-apt-signal

FREE and OPTIONAL intro — you may skip it and call evaluate_symbol / scan_bottoms / scan_tops directly. Intro & subscription funnel for the Seoul apartment 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": "District for the \"sample\" phase. The free sample serves only this market’s showcase (강남구); anything else is answered by the paid evaluate_symbol (x402)."
    }
  }
}

Return the bottom/top verdict for one Seoul district apartment market (25 districts). Accepts Korean (강남구, 강남) or romanized (Gangnam, Nowon, Mapo …) names. 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. Price = volume-weighted median per pyeong (KRW 10k) from official MOLIT closed transactions. 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": "District, e.g. Gangnam, 강남구, Nowon"
    }
  },
  "required": [
    "symbol"
  ]
}

Scan all 25 Seoul districts and return those currently at a bottom (strongest buy), ranked most-bottom first, with price-per-pyeong. 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 25)"
    }
  }
}

Scan all 25 Seoul districts and return those currently at a top (overheated, 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 25)"
    }
  }
}

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 acting 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"
  ]
}