bobashopcashier/kalshi-cli
AI 에이전트가 Kalshi 예측시장 데이터를 안전하게 읽고 거래하도록 만든 Go 명령줄 도구
kalshi-cli는 예측시장 플랫폼 Kalshi의 거래 API를 감싸서, AI 에이전트나 스크립트가 시장 정보를 조회하고 거래할 때 응답 형식이 안정적으로 유지되도록 보장하는 Go 언어 명령줄 도구다. Kalshi가 API 응답 구조를 예고 없이 바꾸면 조용히 잘못된 데이터를 넘기는 대신 즉시 에러를 내고 어느 부분이 바뀌었는지 알려준다. 48개 테스트 케이스로 구성된 회귀 테스트에서 이 도구는 주입된 32개의 API 파손 사례를 모두 감지한 반면, 검증 없는 일반 JSON 디코더는 하나도 감지하지 못했다.
무엇을 하는 레포인가
- Kalshi Trade API v2를 감싸 포지션, 실현 손익, 체결 내역, 캔들스틱(시세 차트) 데이터를 고정소수점 숫자와 버전이 명시된 JSON 형식으로 제공한다
- API 응답의 필드나 형식이 바뀌면 'UPSTREAM_SCHEMA_MISMATCH' 오류를 내며 즉시 멈추고, 바뀐 JSON 경로를 정확히 알려준다
- 거래(쓰기) 명령은 기본적으로 거부되며 명시적 확인 절차를 거쳐야 실행되는 '거버넌스' 방식을 쓴다
- 페이지네이션과 출력 크기에 상한을 둬 응답이 무한정 커지지 않도록 제한한다
- 자체 검색 기능은 Kalshi가 제공하지 않는 전문 검색 대신 대소문자 구분 없는 단순 문자열 매칭으로 시장 목록을 훑는 방식이며, 관련도 순 정렬이 아니라 원래 순서를 유지한다
왜 중요한가
AI 에이전트가 실시간 금융 데이터를 다룰 때 API가 조용히 바뀌어 잘못된 판단을 내리는 위험을 막아준다는 점에서, 자동화 거래나 리서치 파이프라인을 구축하는 개발자에게 실질적인 안전장치가 된다. 또한 필드 선택 기능으로 응답 크기를 80% 가까이 줄여 AI 모델에 넘기는 컨텍스트 비용도 낮출 수 있다.
이 레포의 용어
- 스키마 검증 · 받은 데이터의 구조와 형식이 약속된 대로인지 확인하는 절차
- 고정소수점(fixed-point) · 소수점 위치를 고정해 반올림 오차 없이 정확히 표현하는 숫자 형식
- 페이지네이션 · 많은 데이터를 여러 페이지로 나눠 순차적으로 가져오는 방식
- 캔들스틱 · 일정 시간 단위로 시가·고가·저가·종가를 나타내는 시세 차트 데이터
- deny-by-default · 명시적으로 허용하지 않는 한 기본적으로 모든 요청을 거부하는 보안 원칙
레포 원문 소개 (영문)
Go command-line client for Kalshi Trade API v2 with versioned, schema-validated JSON output.
GitHub에서 보기주목받는 레포
- vorssaint/vorssaint-utils메뉴바 아이콘 하나로 유료 맥 앱 열 개 값을 대신하는 오픈소스 도구
- Alishahryar1/free-claude-code코딩 AI 에이전트를 무료 모델 49곳에 자유롭게 연결해주는 로컬 프록시
- freestylefly/awesome-gpt-image-2GPT-Image2로 원하는 이미지를 정확히 뽑아내는 프롬프트 설계도 532개를 모아놓은 저장소
- block/buzz사람과 AI 에이전트가 같은 채팅방에서 함께 일하는 오픈소스 협업 플랫폼
- NousResearch/hermes-agentNous Research가 만든, 쓰면 쓸수록 스스로 똑똑해지는 AI 에이전트 Hermes
- virgiliojr94/book-to-skill기술서 PDF를 AI 에이전트가 언제든 펼쳐볼 수 있는 '스킬'로 바꿔주는 도구
- VoltAgent/awesome-agent-skillsAI 코딩 도구가 특정 작업을 '전문가처럼' 하도록 도와주는 매뉴얼 1000개 이상을 한곳에 모았다
- anthropics/claude-plugins-community누구나 만든 Claude 확장 기능을 한곳에 모아 설치하게 해주는 저장소