{"openapi":"3.1.0","info":{"title":"CLARIA 질문 API","version":"0.0.0","description":"\nCLARIA AI 에이전트를 통해서 생성된 질문을 조회할 수 있습니다.\n\n**라우트**\n- `GET /api/questions`: 생성된 질문 조회\n- `GET /api/youtube/channels`: 모니터링 중인 YouTube 채널 조회\n- `GET /api/kalshi/events`: Kalshi 이벤트 및 마켓 정보 조회\n\n**⚠️ 주의**\n- 문의사항 남겨주세요\n"},"components":{"schemas":{},"parameters":{}},"paths":{"/api/youtube/channels":{"get":{"tags":["Youtube Channels"],"summary":"유튜브 채널 목록 조회","description":"모니터링하는 유튜브 채널 목록을 반환합니다.","operationId":"get_YoutubeChannelsEndpoint","responses":{"200":{"description":"유튜브 채널 목록","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"요청 성공 여부"},"results":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"채널 이름","example":"연예 뒤통령 이진호"},"category":{"type":"string","description":"채널 카테고리","example":"K-POP·연예"},"channelId":{"type":"string","description":"채널 ID","example":"UCbp1HhKUDmeI6enMXUxtgrg"}},"required":["name","category","channelId"]}}},"required":["success","results"]}}}},"500":{"description":"내부 서버 오류","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"요청 성공 여부"},"errors":{"type":"array","items":{"type":"string","description":"오류 메시지 배열"}}},"required":["success","errors"]}}}}}}},"/api/questions":{"get":{"tags":["Questions"],"summary":"질문 목록 조회","description":"생성된 질문 목록을 반환합니다.","operationId":"get_ListQuestionsEndpoint","parameters":[{"schema":{"type":"integer","description":"가져올 페이지 번호입니다.","example":1},"required":false,"description":"가져올 페이지 번호입니다.","name":"page","in":"query"},{"schema":{"type":"integer","description":"페이지당 검색할 항목 수입니다.","example":10},"required":false,"description":"페이지당 검색할 항목 수입니다.","name":"perPage","in":"query"},{"schema":{"type":"string","description":"필터링할 채널 ID (','로 구분)","example":"UCSCoziKHqjqbox3Fv3Pb4BA,UC2249x_kG5c12e0f_XN3o5Q"},"required":false,"description":"필터링할 채널 ID (','로 구분)","name":"channel_ids","in":"query"},{"schema":{"type":"string","description":"필터링할 비디오 ID (','로 구분)","example":"iSPWaOEjMww,another_video_id"},"required":false,"description":"필터링할 비디오 ID (','로 구분)","name":"video_ids","in":"query"},{"schema":{"type":"string","description":"질문 내용 필터링","example":"Pirate Software"},"required":false,"description":"질문 내용 필터링","name":"question","in":"query"},{"schema":{"type":"string","description":"필터링할 키워드 (','로 구분)","example":"Stop Killing Games,Jason Hall"},"required":false,"description":"필터링할 키워드 (','로 구분)","name":"keywords","in":"query"}],"responses":{"200":{"description":"A paginated list of questions","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"요청 성공 여부를 나타냅니다.","example":true},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","description":"질문 ID","example":16},"channel_id":{"type":"string","description":"채널 ID","example":"UCSCoziKHqjqbox3Fv3Pb4BA"},"video_id":{"type":"string","description":"비디오 ID","example":"iSPWaOEjMww"},"question":{"type":"string","description":"질문 내용","example":"2026년까지 'Pirate Software' 제이슨 홀은 'Stop Killing Games' 이니셔티브에 대한 자신의 초기 비판적 입장을 철회하고, 해당 운동을 공개적으로 지지할 것인가?"},"keywords":{"type":"string","description":"키워드의 JSON 문자열(','로 나뉨)","example":"[\"Pirate Software\",\"Stop Killing Games\",\"Jason Hall\",\"Offbrand Games\"]"},"created_at":{"type":"string","description":"생성 타임스탬프","example":"2025-07-09 08:35:14"},"updated_at":{"type":"string","description":"마지막 업데이트 타임스탬프","example":"2025-07-09 08:35:14"},"deleted_at":{"type":["string","null"],"description":"삭제 타임스탬프"}},"required":["id","channel_id","video_id","question","keywords","created_at","updated_at","deleted_at"]}},"result_info":{"type":"object","properties":{"page":{"type":"integer","description":"현재 페이지 번호입니다.","example":1},"per_page":{"type":"integer","description":"페이지당 항목 수입니다.","example":10},"total_count":{"type":"integer","description":"총 질문 수입니다.","example":100}},"required":["page","per_page","total_count"]}},"required":["success","results","result_info"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"요청 성공 여부를 나타냅니다."},"errors":{"type":"array","items":{"type":"string","description":"오류 메시지 목록입니다."}}},"required":["success","errors"]}}}}}}},"/api/kalshi/events":{"get":{"tags":["Kalshi"],"summary":"Kalshi 이벤트 목록 조회","description":"\n조건에 맞는 Kalshi 이벤트와 마켓 정보를 반환합니다.\n\n**사전정보**\n- **이벤트**: Kalshi에서 가장 먼저 보이는 \"일론머스크가 화성갈까?\"와 같은 대질문을 가진 항목\n- **마켓**: 이벤트에 대해서 yes/no 답으로 귀결될 항목, 예: \"2029년 3월에 간다\" 등\n   - Kalshi 에서 **Rule Summary**는 각 마켓마다 primary, secondary, early_close_condition로 제공됨.\n    - 본 API의 `rule`로 합쳐서 제공\n   - Kalshi에서 이벤트는 마감시한이 없음. 그래서 마켓 중 가장 임박한 마감기한으로 사용함\n    - 본 API의 `closest_market_close_time`를 마감기한으로 제공\n\n**조건**\n- 현재 열려있고\n- 백만달러 이상\n- 마감기한이 현재 이후\n- 포함 카테고리\n  - Culture\n    - Social\n    - Entertainment\n    - Politics\n    - Elections\n    - World\n  - Companies\n    - Transportation\n  - Financials\n    - Economics\n  - Crypto\n  - Science and Technology\n    - Climate and Weather\n    - Health\n- 제외 카테고리\n  - Sports\n","operationId":"get_ListKalshiEventsEndpoint","responses":{"200":{"description":"조건에 맞는 Kalshi 이벤트 목록","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"요청 성공 여부를 나타냅니다.","example":true},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"이벤트 ID","example":"PRES"},"title":{"type":"string","description":"이벤트 제목","example":"2024 US Presidential Election"},"category":{"type":"string","description":"이벤트 카테고리","example":"Politics"},"thumbnail":{"type":["string","null"],"description":"이벤트 썸네일 URL","example":"https://kalshi-app.s3.amazonaws.com/media/election-2024.png"},"closest_market_close_time":{"type":"string","description":"현재 기준 가장 가까운 마켓 마감 시각 (ISO 8601)","example":"2024-11-05T23:59:59Z"},"total_volume":{"type":"integer","description":"이벤트 총 거래량","example":2500000},"markets":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"마켓 제목","example":"Will the Republican candidate win the 2024 US Presidential Election?"},"rule":{"type":"string","description":"주요 규칙","example":"This market will resolve to Yes if the Republican nominee wins the 2024 US Presidential Election."},"close_time":{"type":"string","description":"마켓 마감 시각 (ISO 8601)","example":"2024-11-05T23:59:59Z"},"ticker":{"type":"string","description":"마켓 티커","example":"PRES-24"},"volume":{"type":"integer","description":"마켓 거래량","example":500000}},"required":["title","rule","close_time","ticker","volume"]}}},"required":["id","title","category","thumbnail","closest_market_close_time","total_volume","markets"]}},"result_info":{"type":"object","properties":{"total_count":{"type":"integer","description":"필터링된 총 이벤트 수","example":15}},"required":["total_count"]}},"required":["success","results","result_info"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"요청 성공 여부를 나타냅니다."},"errors":{"type":"array","items":{"type":"string","description":"오류 메시지 목록입니다."}}},"required":["success","errors"]}}}}}}}},"webhooks":{}}