> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Builder Daily Activity

> Return an inclusive daily time series plus recent market and category composition for one Builder.

Use this endpoint for one Builder's daily attributed volume, fills, active traders, trader-paid fees, and buy/sell mix. Recent windows also include the top markets and categories by attributed volume.

## Request

```http theme={null}
GET /v3/builders/{code}/activity/daily
```

### Path parameter

| Parameter | Type | Description |
| - | - | - |
| `code` | string | Builder code (with or without `0x`) or exact public Builder name. Hex digits, the prefix, and names are case-insensitive; names must be URL-encoded. |

### Query parameters

| Parameter | Type | Default | Description |
| - | - | - | - |
| `start_date` | date | 29 UTC days before today | First inclusive UTC date in `YYYY-MM-DD` format |
| `end_date` | date | Today in UTC | Last inclusive UTC date in `YYYY-MM-DD` format |
| `top_limit` | integer | `10` | Top markets and categories to return, from 1 through 20 |

The inclusive range may contain at most 366 days and may begin no earlier than `2020-01-01`. When a request reaches today but the newest completed daily bucket is one or two days behind, the service shifts both dates backward by the same amount. Always treat the returned `start_date` and `end_date` as authoritative.

Top-market and top-category composition is included only for windows of 31 days or fewer. Longer history requests preserve the same response shape and return empty `top_markets` and `top_categories` arrays.

## Example

```bash theme={null}
curl -H "x-api-key: $POLYNODE_API_KEY" \
  "https://api.polynode.dev/v3/builders/BetMoar/activity/daily?start_date=2026-08-01&end_date=2026-08-30&top_limit=5"
```

## Response shape

```json theme={null}
{
  "start_date": "2026-08-01",
  "end_date": "2026-08-30",
  "coverage_start_date": "2026-04-03",
  "coverage_end_date": "2026-08-30",
  "volume_scope": "clob_v2_onchain",
  "volume_semantics": "outcome_share_par_notional",
  "fee_semantics": "Trader-paid fees attributed to fills. These are not builder rebates.",
  "series": [
    {
      "builder_code": "0xceebf77a833b30520287ddd9478ff51abbdffa30aa90a8d655dba0e8a79ce0c1",
      "builder_name": "BetMoar",
      "builder_logo": "https://example.com/builder.png",
      "builder_verified": true,
      "is_other": false,
      "days": [
        {
          "date": "2026-08-01",
          "volume_e6": "248501250000",
          "volume": "248501.25",
          "trades": 821,
          "active_traders": 194,
          "trader_paid_fees_e6": "184200000",
          "trader_paid_fees": "184.2",
          "buy_volume_e6": "148500000000",
          "buy_volume": "148500",
          "sell_volume_e6": "100001250000",
          "sell_volume": "100001.25"
        }
      ],
      "top_markets": [],
      "top_categories": []
    }
  ]
}
```

`days` contains one row for every requested UTC date, including explicit zero-valued days. Buy and sell volume use the same outcome-share par-notional basis and add to total volume. `active_traders` is the distinct attributed trader count for that Builder and day.

Each `top_markets` and `top_categories` row includes `rank`, volume, fills, trader-paid fees, and buy/sell volume. Market rows also include nullable `condition_id`, title, slug, image, and category.

## Errors

| Status | Error | Meaning |
| - | - | - |
| `400` | `invalid_builder`, `invalid_date`, `invalid_date_range`, `date_range_too_large`, or `invalid_top_limit` | A path or query value is invalid |
| `401` | authentication error | The API key is missing or invalid |
| `402` | payment required | The key's plan does not include paid V3 REST data |
| `404` | `builder_not_found` | No Builder matches a supplied public name |
| `409` | `ambiguous_builder_name` | More than one Builder uses the supplied name; use a code from the Builder directory |
| `429` | rate limit exceeded | The account's shared V3 REST request limit was exceeded |
| `503` | `temporarily_unavailable` | Coverage is incomplete or a required bounded query is unavailable; no partial series is returned |

## Related endpoints

| Endpoint | Description |
| - | - |
| [`GET /v3/builders/activity/daily`](https://docs.polynode.dev/data/builders/activity-comparison) | Compare selected Builder daily series |
| [`GET /v3/builders/{code}/leaderboard`](https://docs.polynode.dev/data/builders/trader-leaderboard) | Rank the Builder's active trader cohort |
| [`GET /v3/builders/{code}/trades`](https://docs.polynode.dev/data/builders/trades) | Paginate the underlying attributed fills |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.