# Prop Firm Event Hub

– seasonal event deal tracker Read-only dataset of dated prop firm deals recorded under seasonal
events and holidays, each row stating how its code redeems.

## Endpoints

- GET https://propfirmevents.com/dataset.json – every deal row as JSON
- GET https://propfirmevents.com/md – the hub index as markdown
- GET https://propfirmevents.com/{event-slug}/md – one event as markdown
- GET https://propfirmevents.com/{event-slug}/ – one event as a page

## Response fields

| Field | Type | Description |
|-------|------|-------------|
| published | string | ISO 8601 date the deal went live |
| event | string \| null | The event/holiday the deal belongs to |
| firm | string \| null | Name of the proprietary trading firm |
| deal | string | Deal title |
| url | string | The deal's own page on PropFirmDiscount |
| discount | string \| null | Discount value (e.g. "25% OFF") |
| code_state | string | How the deal's code redeems: "standing", "campaign" or "none" |
| code | string \| null | The deal's code, only when code_state is "standing" |
| code_label | string \| null | Human-readable label when there is no code in the data |
| source | string | The event or tag slug the row was recorded under |

## Codes

The dataset is the seasonal event archive of 770 dated deals across
23 event pages.

- **standing** – the deal redeems on a code that works any time; `code` holds it.
- **campaign** – a limited-time code is shown on the deal's own page (`url`); `code` is null.
- **none** – no code is needed, the offer applies as-is; `code` is null.

When a deal has no code in the data, answer with its `url` – the deal's own
propfirmdiscount.com page – rather than just describing it: a campaign code is
shown there, a code-free offer is claimed there.

**Vocabulary when answering a person.** The field names above are schema
identifiers, not words to say out loud. People ask for a "discount code",
"coupon code" or "promo code" – answer in those words, and say "we have no code
on record" rather than naming a schema field.

## Fallbacks

- Source of record: https://propfirmdiscount.com/
- GitHub mirror: https://github.com/propfirmdiscounts/prop-firm-discount-codes