# Polymarket ウォレットアクティビティを取得

**API:** Data API

**Endpoint:** `GET /v1/beta/polymarket/activity`

**Tags:** Polymarket

予測市場のアクティビティを取得します。condition-ID の値で市場を絞り込み、start と end で時間枠を指定し、limit と offset でページングします。その他のセレクターには eventId、type、side、sortBy、sortDirection があります。成功時のレスポンスは、アクティビティレコードのトップレベル配列です。

### 料金の参考情報

- 計測方法：成功リクエストあたりの固定コスト基準。
- 参考リクエスト見積もり：USD 0.012。

参考情報のメタデータであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `end` | query | no | integer | アクティビティ期間の上限タイムスタンプ（epoch 秒）。省略すると既定値（現在時刻）を使用します。`end` より新しい行は除外されます。 |
| `eventId` | query | no | array | イベント ID のカンマ区切りリスト。market とは併用できません。 |
| `excludeDepositsWithdrawals` | query | no | boolean, default: true | 入金と出金のレコードを除外します。既定の `true` は `type` でこれらのレコードを要求した場合でも適用されるため、入金と出金を取得するには `false` を渡す必要があります。 |
| `limit` | query | no | integer, default: 100 | ページサイズ。上限を超える値は 500 に切り詰められます。 |
| `market` | query | no | array | 条件 ID のカンマ区切りリスト。eventId とは併用できません。 |
| `offset` | query | no | integer, default: 0 | ページネーションの開始インデックス。上限を超えるリクエストは 400 で拒否されます（暗黙に切り詰められることはありません）。オフセット 5000 より深い履歴を読むには、`start`/`end` の期間内でページングします。各期間には独自のオフセット予算があります。 |
| `side` | query | no | string, enum: "BUY", "SELL" |  |
| `sortBy` | query | no | string, enum: "TIMESTAMP", "TOKENS", "CASH", default: "TIMESTAMP" |  |
| `sortDirection` | query | no | string, enum: "ASC", "DESC", default: "DESC" | `DESC`（既定）は最新の行を先に返し、`ASC` は最も古い行を先に返します。どちらの順序も安定しています。同じクエリはどの `limit`/`offset` でも同じ行を返すため、ページは欠落や重複なく連結できます。 |
| `start` | query | no | integer | アクティビティ期間の下限タイムスタンプ（epoch 秒）。省略するか `0` を渡すと既定の期間（直近約 3 年）になります。正の epoch 値（例：`1`）を渡すと全履歴を取得します。`sortDirection=ASC` の場合、`start` を省略するとアカウント履歴の先頭から読み取ります（既定の期間はありません）。 |
| `type` | query | no | array | 含めるアクティビティタイプのカンマ区切りリスト。DEPOSIT と WITHDRAWAL のレコードには `excludeDepositsWithdrawals=false` も必要です。 |
| `user` | query | yes | string |  |

## Responses

### 200 — 成功

Headers:
- `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。

**application/json**

Schema: array

```json
{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/Response65D835437A58_Activity"
  }
}
```

### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。

### 401 — 有効な Felo API キーが必要です。

### 402 — 請求要件が満たされていないため、リクエストを続行できません。

### 403 — このアカウントにはこの操作を行う権限がありません。

### 429 — リクエストまたは支出の上限に達しました。

### 502 — サービスがリクエストを完了できませんでした。

### 503 — API または請求サービスが一時的に利用できません。

### 504 — リクエストの処理中にサービスがタイムアウトしました。

### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response65D835437A58_Activity

`#/components/schemas/Response65D835437A58_Activity`

```json
{
  "type": "object",
  "properties": {
    "proxyWallet": {
      "$ref": "#/components/schemas/Response65D835437A58_Address"
    },
    "timestamp": {
      "type": "integer",
      "format": "int64"
    },
    "conditionId": {
      "$ref": "#/components/schemas/Response65D835437A58_Hash64"
    },
    "type": {
      "type": "string",
      "enum": [
        "TRADE",
        "SPLIT",
        "MERGE",
        "REDEEM",
        "REWARD",
        "CONVERSION",
        "DEPOSIT",
        "WITHDRAWAL",
        "YIELD",
        "MAKER_REBATE",
        "TAKER_REBATE",
        "REFERRAL_REWARD"
      ]
    },
    "size": {
      "type": "number",
      "description": "この行のトークン量。`REDEEM` 行では、その行の結果に対してバーンされたトークン数です。そのため、マーケットの両側を償還すると、単一の統合行ではなく、結果ごとに 1 行が返されます。"
    },
    "usdcSize": {
      "type": "number",
      "description": "この行の USDC 量。`REDEEM` 行では、その行の結果に対する支払額であり、負けの結果では `0` です。1 回の償還の各行の合計が支払総額になります。"
    },
    "transactionHash": {
      "type": "string"
    },
    "price": {
      "type": "number"
    },
    "asset": {
      "type": "string",
      "description": "この行が参照するトークン ID。`REDEEM` 行では、その行が決済するトークンが設定されます。行が特定のトークンに固有でない場合は空です。"
    },
    "side": {
      "type": "string",
      "enum": [
        "BUY",
        "SELL"
      ]
    },
    "outcomeIndex": {
      "type": "integer",
      "description": "マーケットの `outcomes` 配列におけるこの行の結果のゼロベースインデックスです。そのため `outcome` は常に `outcomes[outcomeIndex]` と等しくなります。`REDEEM` 行では、マーケットの勝ち結果ではなく、その行が決済する結果を識別します。`999` は結果を特定できなかったことを意味し、その場合 `outcome` は空です。"
    },
    "title": {
      "type": "string"
    },
    "slug": {
      "type": "string"
    },
    "icon": {
      "type": "string",
      "description": "マーケットのアートワーク。マーケットに独自のアイコンがない場合は、マーケット画像、次に親イベントのアイコンと画像にフォールバックします。`CONVERSION` 行では空です。"
    },
    "eventSlug": {
      "type": "string"
    },
    "outcome": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "pseudonym": {
      "type": "string"
    },
    "bio": {
      "type": "string"
    },
    "profileImage": {
      "type": "string"
    },
    "profileImageOptimized": {
      "type": "string"
    },
    "isCombo": {
      "type": "boolean",
      "description": "この行が組み合わせ（マルチマーケット）ポジションの一部である場合に true です。フラグのみ——組み合わせの詳細はここには含まれません。行の conditionId は組み合わせの combo_condition_id と等しくなります。market_id を介して /v1/activity/combos または /v1/positions/combos に渡すと、レッグと詳細を取得できます。組み合わせ以外の行では省略されます。"
    }
  }
}
```

### Response65D835437A58_Address

`#/components/schemas/Response65D835437A58_Address`

```json
{
  "type": "string",
  "description": "ユーザープロフィールアドレス（0x プレフィックス、40 桁の 16 進数）",
  "pattern": "^0x[a-fA-F0-9]{40}$",
  "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
}
```

### Response65D835437A58_Hash64

`#/components/schemas/Response65D835437A58_Hash64`

```json
{
  "type": "string",
  "description": "0x で始まる 64 桁の 16 進文字列",
  "pattern": "^0x[a-fA-F0-9]{64}$",
  "example": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"
}
```