Polymarket
Prediction-market discovery and market data.
Polymarket 지갑 활동 조회
예측 시장 활동을 조회합니다. condition-ID 값으로 시장을 필터링하고, 시간 범위는 start와 end, 페이지네이션은 limit와 offset을 사용하세요. 추가 선택자로 eventId, type, side, sortBy, sortDirection이 있습니다. 성공 응답은 활동 레코드의 최상위 배열입니다.
가격 참고
- 과금 기준: 성공한 요청당 고정 원가 기준.
- 참고 요청 추정치: USD 0.012.
참고용 메타데이터일 뿐이며, 계정 견적 또는 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: integerend최솟값:0
활동 기간의 상한 타임스탬프(에포크 초)입니다. 기본값(현재 시각)을 사용하려면 생략하세요.
end보다 최신인 행은 제외됩니다. - 유형: array integer[]event
Id 최솟값:1이벤트 ID를 쉼표로 구분한 목록입니다. market과 상호 배타적입니다.
- 유형: booleanexclude
Deposits Withdrawals 입금 및 출금 레코드를 제외합니다.
type에서 해당 레코드를 요청하더라도 기본값true가 적용되므로, 입금과 출금을 얻으려면false를 전달해야 합니다. - 유형: integerlimit최솟값:0최댓값:500
페이지 크기입니다. 최대값을 초과하는 값은 500으로 제한됩니다.
- 유형: array string[]market
조건 ID를 쉼표로 구분한 목록입니다. eventId와 상호 배타적입니다.
- 유형: integeroffset최솟값:0최댓값:5000
페이지네이션의 시작 인덱스입니다. 상한을 넘는 요청은 400으로 거부되며(자동으로 제한되지 않음), offset 5000보다 깊은 이력을 읽으려면
start/end기간 안에서 페이지를 나누세요. 각 기간에는 자체 offset 예산이 있습니다. - 유형: string 열거형side값
- B
U Y - S
E L L
- 유형: string 열거형sort
By 값- T
I M E S T A M P - T
O K E N S - C
A S H
- 유형: string 열거형sort
Direction DESC(기본값)는 최신 행을 먼저 반환하고,ASC는 가장 오래된 행을 먼저 반환합니다. 두 정렬 모두 안정적이므로 동일한 쿼리는 어떤limit/offset에서도 같은 행을 반환하며, 페이지가 빈틈이나 중복 없이 이어집니다.값- A
S C - D
E S C
- 유형: integerstart최솟값:0
활동 기간의 하한 타임스탬프(에포크 초)입니다. 기본 기간(최근 약 3년)을 사용하려면 생략하거나
0을 전달하고, 전체 이력을 가져오려면 양수 에포크(예:1)를 전달하세요.sortDirection=ASC인 경우start를 생략하면 이미 계정 이력의 시작부터 읽습니다(기본 기간 없음). - 유형: array string[] 열거형type
포함할 활동 유형을 쉼표로 구분한 목록입니다. DEPOSIT 및 WITHDRAWAL 레코드는
excludeDepositsWithdrawals=false도 필요로 합니다.값- T
R A D E - S
P L I T - M
E R G E - R
E D E E M - R
E W A R D
- 유형: stringuser필수
사용자 프로필 주소(0x 접두사, 16진수 40자)
- 유형: array object[] · Response65D835437A58_Activity[]200
성공
- asset유형: string
이 행이 참조하는 토큰 ID.
REDEEM행에서는 해당 행이 정산하는 토큰으로 채워집니다. 행이 특정 토큰과 관련이 없으면 비어 있습니다. - bio유형: string
- condition유형: string · Response65D835437A58_Hash64
Id 0x로 시작하는 64자리 16진수 문자열
- event유형: string
Slug - icon유형: string
마켓 아트워크. 마켓에 자체 아이콘이 없으면 마켓 이미지, 그다음 상위 이벤트의 아이콘과 이미지로 대체됩니다.
CONVERSION행에서는 비어 있습니다. - is유형: boolean
Combo 이 행이 조합형(다중 마켓) 포지션의 일부이면 true입니다. 플래그만 해당하며 조합 세부 정보는 여기에 포함되지 않습니다. 행의 conditionId는 조합의 combo_condition_id와 같으며, 이를 /v1/activity/combos 또는 /v1/positions/combos에 market_id로 전달해 레그와 세부 정보를 가져올 수 있습니다. 조합이 아닌 행에서는 생략됩니다.
- name유형: string
- outcome유형: string
- outcome유형: integer
Index 마켓의
outcomes배열에서 이 행 결과의 0부터 시작하는 인덱스이므로outcome은 항상outcomes[outcomeIndex]와 같습니다.REDEEM행에서는 행이 정산하는 결과를 식별하며 마켓의 우승 결과가 아닙니다.999는 결과를 확인할 수 없음을 의미하며, 이 경우outcome은 비어 있습니다. - price유형: number
- profile유형: string
Image - profile유형: string
Image Optimized - proxy유형: string · Response65D835437A58_Address
Wallet 사용자 프로필 주소(0x 접두사, 16진수 40자)
- pseudonym유형: string
- side유형: string 열거형값
- B
U Y - S
E L L
- size유형: number
이 행의 토큰 수량입니다.
REDEEM행에서는 이 행의 결과에 대해 소각된 토큰 수이므로 마켓의 양쪽을 상환하면 결합된 단일 행 대신 결과별로 한 행이 반환됩니다. - slug유형: string
- timestamp유형: integer 형식: int64
Signed 64-bit integers (long type).
- title유형: string
- transaction유형: string
Hash - type유형: string 열거형값
- T
R A D E - S
P L I T - M
E R G E - R
E D E E M - R
E W A R D
- usdc유형: number
Size 이 행의 USDC 수량입니다.
REDEEM행에서는 이 행의 결과에 대한 지급액이며 패배한 결과의 경우0입니다. 한 번의 상환에 속한 행들을 합하면 총 지급액이 됩니다.
application/json - 400
요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
- 401
유효한 Felo API 키가 필요합니다.
- 402
청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
- 403
이 계정에는 이 작업을 수행할 권한이 없습니다.
- 429
요청 또는 지출 한도에 도달했습니다.
- 502
서비스가 요청을 완료할 수 없습니다.
- 503
API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
- 504
요청을 처리하는 동안 서비스 시간이 초과되었습니다.
- default
오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.
application/json
curl 'https://openapi.felo.ai/v1/beta/polymarket/activity?user=0x56687bf447db6ffa42ffe2204a05edaa20f55839' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
[
{
"proxyWallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
"timestamp": 1,
"conditionId": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917",
"type": "TRADE",
"size": 1,
"usdcSize": 1,
"transactionHash": "string",
"price": 1,
"asset": "string",
"side": "BUY",
"outcomeIndex": 1,
"title": "string",
"slug": "string",
"icon": "string",
"eventSlug": "string",
"outcome": "string",
"name": "string",
"pseudonym": "string",
"bio": "string",
"profileImage": "string",
"profileImageOptimized": "string",
"isCombo": true
}
]