이벤트 ID와 결과 토큰 ID는 다릅니다
이벤트는 여러 시장을 묶고, 시장은 구체적인 질문을 나타내며, 각 결과에는 별도의 토큰 식별자가 있습니다. 이 관계를 명시적으로 보관하세요. 번역되거나 축약된 제목은 주문 대상 식별자로 충분하지 않습니다.
시장 탐색, 상세 데이터, 호가와 인증 거래는 최신 공식 문서를 기준으로 구현하세요. API와 SDK 규약은 바뀝니다. 이 안내는 구조를 설명하며 과거 클라이언트의 서명 코드를 검증 없이 제공하지 않습니다.
다섯 단계로 책임을 나누세요
전송 전에 작업 의도의 고유 식별자를 영구 저장하세요. 규칙 버전과 발동 관찰을 결과 주문에 연결하기 위한 애플리케이션 설계입니다. 모든 API가 멱등성 키를 받는다는 의미는 아닙니다.
- 탐색: 정확한 시장·결과·규칙·상태와 적용 거래 제약 확인.
- 관찰: 최신 상태를 읽고 데이터 시각과 연결 상태를 추적하며 갱신 처리.
- 판단: 기록된 동일 입력에 규칙 버전을 적용해 작업 제안 또는 보류 이유 생성.
- 승인: 이용 자격, 서명 권한, 승인 범위, 예산과 주문 조건 점검.
- 대조: 의도한 작업을 실제 미체결 주문·체결·포지션과 비교해 잔여 예산 갱신.
응답 시간 초과는 실패 확정이 아닙니다
주문과 거래 기록을 확인하기 전에는 같은 의도를 자동 재전송하지 마세요. 첫 요청이 이미 접수됐을 수 있습니다. 무조건 재시도하면 노출이 두 배가 될 수 있으므로 미확정 상태를 프로세스 재시작 후에도 보존해야 합니다.
가상의 10개 주문 중 3개가 체결됐다면 3개 포지션과 7개 미체결 잔량의 예산을 따로 반영합니다. 나머지를 취소해도 이미 체결된 3개는 사라지지 않습니다. 취소 결과를 확인하고 최신 상태를 읽은 뒤 다음 판단으로 넘어가세요.
개발자를 위한 복구 점검표
인증정보 없이 모의 서비스와 기록된 입력으로 시험하세요. 읽기 전용 시제품으로 식별자 연결을 검증할 수 있습니다. 실제 거래 연동은 현재 API 규약과 인증 구조를 별도로 확인해야 합니다.
- 거절: 이유를 기록하고 원인 조건을 수정하며 무한 재시도 금지.
- 연결 끊김: 최신 데이터가 필요한 판단을 멈추고 재연결 후 상태 재구성.
- 요청 제한: 현재 공식 정책에 따라 대기 시간을 늘리고 여러 작업자의 동시 재시도 방지.
- 전송 미확정: 명시적인 미해결 상태로 남기고 대조 후 재시도 판단.
- 재시작: 주문·포지션·권한·예약 예산을 복원한 다음 실행 허용.
- 권한 철회: 새 서명을 중단하고 기존 미체결 주문은 별도로 검토.
데이터 읽기와 비밀정보를 분리하세요
편의를 이유로 관찰 모듈에 서명 권한을 주지 마세요. 비밀정보를 로그, 브라우저 코드, 저장소나 진단 화면에 포함하지 않아야 합니다. 비수탁이라는 이름에 의존하지 말고 권한 만료와 철회 동작을 확인하세요.
SharkRule은 사용자의 규칙과 권한에 기반한 소프트웨어입니다. 이 글은 SharkRule 자체 API 문서가 아니며 개발자 API나 SDK 제공을 약속하지 않습니다. 제품 지원 기능은 사전 이용 안내를 통해 확인하세요.
자금 보관·권한·이용 자격
비수탁은 자금이 사용자 통제 지갑에 남는다는 뜻이며 거래 권한, 스마트 계약 위험이나 손실 가능성이 사라진다는 뜻은 아닙니다. SharkRule은 Polymarket과 독립된 소프트웨어로 제휴나 보증을 암시하지 않습니다. 이 자료는 소프트웨어 교육용이며 금융·투자 조언이 아닙니다. 거래 이용 자격에는 Polymarket의 현재 지역 제한이 적용됩니다.
현재 지역 제한 확인하기자주 묻는 질문
시장 데이터 탐색에도 거래 인증정보가 필요한가요?
관찰과 인증 거래는 서로 다릅니다. 각 공식 엔드포인트의 요구사항을 확인하고 읽기 전용 시제품에는 주문 서명 권한을 주지 마세요.
실패한 요청은 모두 재시도해도 되나요?
아니요. 응답이 없더라도 주문은 접수됐을 수 있습니다. 상태를 대조한 뒤 중복 생성 여부를 판단하세요.
주문 전송은 거래 완료와 같은가요?
아니요. 전송, 접수, 일부 또는 전체 체결과 정산은 다른 상태입니다.