# Furstock OpenAPI

> 퍼스톡(furstock.trade)은 캐릭터를 주식처럼 상장해 가상 화폐로 거래하는 모의투자 서비스입니다. OpenAPI로 사용자는 자기 계정의 시세 조회·시장가/지정가 주문·잔고·보유종목·주문 이력·커뮤니티 활동을 프로그램으로 할 수 있습니다. Furstock is a Korean paper-trading exchange of fictional characters; this REST API (OAuth2 client credentials) lets a user's own bot or custom client do everything the web app does on their account.

- REST base URL: https://api.furstock.trade
- Auth: user issues an API key at https://furstock.trade/profile?tab=api, exchanges it at POST https://api.furstock.trade/oauth2/token (client_credentials) for a 1-hour Bearer token
- Machine-readable spec (source of truth): https://api.furstock.trade/openapi.json
- Realtime prices: wss://ws.furstock.trade/socket (Phoenix Channels, topic stock:{symbol})
- Agent skill with workflow and guardrails: https://furstock.trade/skills/furstock-openapi/SKILL.md

## Docs (Korean markdown)

- [시작하기](https://furstock.trade/skills/furstock-openapi/references/overview.md): 퍼스톡 OpenAPI 개요와 5분 퀵스타트
- [인증](https://furstock.trade/skills/furstock-openapi/references/authentication.md): API 키 발급, access token 교환, 폐기, 권한 범위
- [공통 규칙](https://furstock.trade/skills/furstock-openapi/references/conventions.md): 요청·응답 형식, 오류 코드, 요청 한도, 멱등성, 시장 규칙
- [종목·시세](https://furstock.trade/skills/furstock-openapi/references/market.md): 종목 목록·검색, 현재가, 호가, 캔들, 체결, 실시간 순위
- [계좌](https://furstock.trade/skills/furstock-openapi/references/account.md): 잔고, 보유종목, 프로필
- [주문](https://furstock.trade/skills/furstock-openapi/references/orders.md): 시장가·지정가 매수/매도, 주문 이력, 매매 대기열, 취소
- [커뮤니티·소셜](https://furstock.trade/skills/furstock-openapi/references/community.md): 종목토론, 관심종목, 종목 그룹, 뉴스, 갤러리, 상장 신청
- [실시간 시세](https://furstock.trade/skills/furstock-openapi/references/realtime.md): WebSocket(Phoenix Channels)으로 시세 구독
- [트레이더봇 만들기](https://furstock.trade/skills/furstock-openapi/references/bot-guide.md): TypeScript·Python 예제로 첫 봇 만들기

## Optional

- [Full docs in one file](https://furstock.trade/llms-full.txt): every page above concatenated
- [Swagger UI](https://api.furstock.trade/docs): interactive reference
- [OpenAPI YAML](https://api.furstock.trade/openapi.yaml)