---
title: "A fill of an entity you follow (sent to your endpoint)"
method: POST
path: "fill"
tags: ["Push"]
---

# A fill of an entity you follow (sent to your endpoint)

`POST fill` (webhook)

We POST each fill of a subscription with the webhook channel to your registered endpoint. Verify `x-pmw-signature` = hex HMAC-SHA256(endpoint secret, raw body) before parsing. Answer 2xx only after storing it; anything else (or no answer within 5 s) is retried, 3 attempts in total. At-least-once: deduplicate on `data.eventId`.

## Headers

- `x-pmw-signature` string, required

## Payload

- object
  - `type` 'fill', required
  - `data` PushedFill, required: One fill of an entity you subscribe to, as GET /v1/account/fills returns it (and the stream carries it).
    - `eventId` string, required: `chain:block:blockHash:txHash:logIndex`; stable across retries and replays. Deduplicate on it.
    - `chain` integer, required: 137 (Polygon).
    - `entityId` string, required: The subscribed entity (0x address).
    - `wallet` string, required: The address inside the entity that traded (0x).
    - `ts` string, required: Block time, UTC, `YYYY-MM-DD HH:MM:SS`.
    - `block` integer, required
    - `blockHash` string, required
    - `txHash` string, required
    - `logIndex` integer, required
    - `exchange` string, required: Which exchange contract matched it, e.g. pm_ctf_v2.
    - `side` 'BUY' | 'SELL', required
    - `role` 'maker' | 'taker', required
    - `tokenId` string, required: Polymarket outcome token id (uint256 as a decimal string).
    - `price` string, required: Decimal string, e.g. "0.570000".
    - `shares` string, required: Integer string, 1e-6 share units ("3200000000" = 3,200 shares).
    - `usdc` string, required: Integer string, 1e-6 USDC units ("1824000000" = $1,824).
    - `fee` string, required: Integer string, 1e-6 USDC units.
    - `tDetect` string, date-time, required: When we saw the fill.
    - `tPush` string, date-time, required: When we sent it.
    - `marketTitle` string: Market question; absent when not yet known.
    - `conditionId` string: Market condition id; absent when not yet known.

## Acknowledgement `200`

Stored; no retry.

---

[API](https://skmtc.dev/pmwallets/apis/pmwallets-api.md) · [All operations](https://skmtc.dev/pmwallets/apis/pmwallets-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pmwallets/apis/pmwallets-api/revisions/d5023fb40430?raw)