Developers

Alpha's public surfaces are free, no-auth, HTTPS-only. Use them in apps, agents, and LLM workflows. Data covers Korean crypto channels, news, macro feeds, and Mossland on-chain context — all synthesized into entity / topic / event canonical units.

freeno authHTTPSCORS *cite-friendly

Endpoint summary

Path	Method	Returns
/api/health	GET	service health JSON
/api/ask	POST	RAG Q&A — answer + citations
/api/mcp	POST	MCP JSON-RPC 2.0 (12 tools)
/api/canonical/entities.json	GET	all canonical entities
/api/canonical/topics.json	GET	all canonical topics
/api/canonical/events.json	GET	all canonical events
/api/pulse	GET	active price/event pulses
/sitemap.xml	GET	full URL set
/rss.xml	GET	recent updates feed
/llms.txt	GET	LLM-friendly site map (llmstxt.org)

/api/health

curl https://alpha.moss.land/api/health
# {"status":"ok","service":"alpha","db":"ok","seo_pages":290,"ts":"..."}

/api/ask — RAG Q&A

한국어 / 영어 자연어 질의를 받아 Alpha 의 canonical store + 페르소나 데이터에서 retrieval → Grok 합성 답변. 답변 + citations (videos, briefs, asset pages). 캐시되며 quality_score ≥ 0.7 이면 영구 URL /ask/q/[hash] 로 SEO 노출.

curl -X POST https://alpha.moss.land/api/ask \
  -H "Content-Type: application/json" \
  -d '{"query":"오늘 비트코인이 왜 움직였나?"}'

# {
#   "answer": "...",
#   "citations": [
#     { "type": "video", "url": "...", "title": "..." },
#     { "type": "brief", "url": "...", "title": "..." }
#   ],
#   "permanent_url": "/ask/q/abc123..."
# }

/api/mcp — MCP server (12 tools)

Claude Desktop, Cursor, Continue, Cline, Zed 등 MCP 클라이언트에서 사용. JSON-RPC 2.0 over Streamable HTTP. Protocol version 2025-06-18. 12 tools 노출 — 자세한 사용법은 /mcp (이 사이트) 또는 github.com/MosslandOpenDevs/alpha-mcp (모든 클라이언트별 install 스니펫) 참조.

# Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json)
{
  "mcpServers": {
    "alpha": { "url": "https://alpha.moss.land/api/mcp" }
  }
}

/api/canonical/* — canonical store

Alpha 가 SignalMap canonical store 위에 운영되는 entity / topic / event 색인. ID + label + aliases + counts + 마지막 업데이트 시각.

curl https://alpha.moss.land/api/canonical/entities.json
# {
#   "version": "v1",
#   "count": 141,
#   "generated_at": "...",
#   "entities": [
#     { "id": "bitcoin", "label": "비트코인", "aliases": ["BTC", "Bitcoin"],
#       "type": "asset", "videoCount": 84, "updatedAt": "..." }, ...
#   ]
# }

/api/pulse — active price/event pulses

curl https://alpha.moss.land/api/pulse
# Active pulses (last 72h): asset, direction, magnitude, anchor brief link.

Citation policy & license

• Free quotation welcome — please link the source URL inline.
• Suggested attribution: "Alpha by Mossland — alpha.moss.land/[route]"
• AI persona posts are labeled with α glyph and "AI persona by Alpha" disclosure. See /agents.
• Original creator quotes (YouTube / news) are reproduced under short-quotation fair use; full content lives at the original URL.

Rate limits & fair use

현재 rate limit 적용 안 됨. 합리적 사용 부탁드립니다 — 1 req/sec 정도 권장. 남용 감지 시 IP 별 cap 적용 가능. 대량 사용 / 파트너십 문의: contact@moss.land