# Arkham Polymarket PnL Chart

> Arkham Polymarket PnL Chart is a paid API for AI agents from api.arkm.com, paid per call via x402, $0.6/call, status unknown (last checked 2026-09-14).

Returns a time-series chart of cumulative PnL, fees, position value, and USDC flow for a given Polymarket wallet address over a specified time range and interval.

## Facts

- Endpoint: POST https://api.arkm.com/x402/polymarket/pnl/chart
- Price: $0.6/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-polymarket-pnl-chart-b5ecd95e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j1M_hgUeWImcC94bkJFRR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability arkham-polymarket-pnl-chart-b5ecd95e -d '<json body>'
```

Example prompt: Pull the Polymarket PnL chart for wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 over the last 30 days at 4-hour intervals and show me how their cumulative profit and USDC flow have trended.

## When to prefer this

Use this endpoint when you need granular time-series PnL performance data for a specific Polymarket wallet address, especially when cumulative position sizing and USDC flow history over custom time windows matter. Prefer this over general wallet analytics when the focus is specifically on Polymarket prediction market trading performance rather than broader on-chain activity.

## Known failure modes

- Invalid or unrecognized wallet address returns empty or error response
- Insufficient USDC balance for x402 pay-per-request payment causes request rejection
- Invalid time interval or malformed date range returns error
- Wallet address with no Polymarket activity returns empty points array
- Rate limiting or payment processing failure from x402 layer

## How this service works

Get Arkham Polymarket PnL chart. $0.60 per call.

## Output

Returns a JSON object containing an array of time-bucketed data points, each with cumulative PnL, cumulative fees, cumulative position value, and cumulative USDC flow. Also includes the wallet address queried, the interval used, and the start and end timestamps of the chart window.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "period": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Time period: 24h, 7d, 30d, all. Presets auto-shrink to the wallet's available history; all is portfolio-only. Default:…"
  },
  "endTime": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Optional Unix timestamp in seconds for end of range. For conditionID requests, preset windows derived from endTime must…"
  },
  "startTime": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Optional Unix timestamp in seconds for start of range. Not supported with period=all. Condition-level custom ranges mus…"
  },
  "conditionID": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Optional. Market condition ID (0x-prefixed bytes32 hex). Aggregates across all outcome tokens. Omit for portfolio-level…"
  },
  "userAddress": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Polymarket trade address (0x + 40 hex chars)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "points": [
   {
    "bucket": "2026-06-21T16:00:00Z",
    "cumulativePnl": "1202005.2290561295",
    "cumulativeFees": "0",
    "cumulativePosition": "81139973.2305291295",
    "cumulativeUsdcFlow": "-79937968.001473"
   },
   {
    "bucket": "2026-06-21T20:00:00Z",
    "cumulativePnl": "1196436.8781641535",
    "cumulativeFees": "0",
    "cumulativePosition": "81135956.3163611535",
    "cumulativeUsdcFlow": "-79939519.438197"
   },
   {
    "bucket": "2026-06-22T00:00:00Z",
    "cumulativePnl": "1187960.280146319",
    "cumulativeFees": "0",
    "cumulativePosition": "81127882.209258319",
    "cumulativeUsdcFlow": "-79939921.929112"
   }
  ],
  "endTime": "2026-07-21T18:13:19.658980453Z",
  "interval": "4h",
  "startTime": "2026-06-21T18:13:19.658980453Z",
  "userAddress": "0xBDDF61Af533fF524D27154e589d2D7A81510C684"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-polymarket-pnl-chart-b5ecd95e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arkm.com](https://www.zero.xyz/host/api.arkm.com/llms.txt)