> For the complete documentation index, see [llms.txt](https://docs.pearprotocol.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pearprotocol.io/api-integration/api-specification/public-stats.md).

# Public Stats

## Get fee and volume stats for addresses

> Returns total external\_fee\_paid, builder\_fee\_paid, and volume (size \* price) for PEAR fills, per address. Supports comma-separated addresses and optional startFrom filter.

```json
{"openapi":"3.0.0","info":{"title":"Pear Protocol Trading API","version":"1.0.0"},"servers":[{"url":"https://hl-v2.pearprotocol.io","description":"Production (Mainnet)"}],"paths":{"/public-stats/address":{"get":{"description":"Returns total external_fee_paid, builder_fee_paid, and volume (size * price) for PEAR fills, per address. Supports comma-separated addresses and optional startFrom filter.","operationId":"PublicStatsController_getAddressStats","parameters":[{"name":"addresses","required":true,"in":"query","description":"Comma-separated list of addresses","schema":{"type":"string"}},{"name":"startFrom","required":false,"in":"query","description":"ISO timestamp to filter fills from (inclusive)","schema":{"type":"string"}}],"responses":{"200":{"description":"Address stats retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressStatsResponseDto"}}}}},"summary":"Get fee and volume stats for addresses","tags":["Public Stats"]}}},"components":{"schemas":{"AddressStatsResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AddressStatsItemDto"}}},"required":["data"]},"AddressStatsItemDto":{"type":"object","properties":{"address":{"type":"string","description":"Wallet address"},"totalExternalFeePaid":{"type":"number","description":"Total external fees paid (USD)"},"totalBuilderFeePaid":{"type":"number","description":"Total builder fees paid (USD)"},"totalVolume":{"type":"number","description":"Total volume (size * price) in USD"}},"required":["address","totalExternalFeePaid","totalBuilderFeePaid","totalVolume"]}}}}
```