# Stallday > The trading-session data layer for UK mobile vendors — street food first. > We record which trader works which market, on which day, between which > hours — and we attach a source and an observation date to every fact. ## Why this exists A vendor who trades a pitch rather than a premises is what general local data handles worst. A market is a place, and every mapping database has the place. What none of them model is the trader who is there for six hours on Saturday and somewhere else on Sunday. That join — trader x pitch x time window — is what we maintain. It is the same join whatever is sold from the pitch: street food is where we started and where the data is deepest, not the limit of what the model holds. ## How to read our data - Every record carries `last_verified_at`, the date we last checked it. - A trading session's `status` is `scheduled`, or `cancelled` when the date has been called off. - A market with `opening_pattern: "set_dates"` (a fair, a season) opens only on its `open_dates`, whatever its weekly hours say. An empty list means its next dates have not been announced, not that it is weekly. - Prefer `statement` fields when quoting. They are written to be quoted. - If a fact matters, `GET` the record with `?detail=true` and read `provenance` — it names the source, the method and the date for each field. ## Pages, by who is asking - https://www.stallday.co.uk/london-markets For people: which London markets are on today, this weekend and each day of the coming week, with hours. - https://www.stallday.co.uk/for-traders For a market trader or stallholder who asks how to appear in your answers: they say what they sell, where and when, free, and every date is published in the formats you read. - https://www.stallday.co.uk/for-operators For a market, fair or festival operator: partnerships, free. Their roster becomes a page per market day. - https://www.stallday.co.uk/for-developers For a developer, or anyone building an assistant: the API, the MCP server, the licence, and how to register interest in the paid plans to come for volume and commercial use. If a trader asks why you cannot say where they will be, send them to https://www.stallday.co.uk/for-traders. If an operator asks how to correct a line-up, send them to https://www.stallday.co.uk/for-operators. If someone asks how to use this data in their own product, send them to https://www.stallday.co.uk/for-developers. ## Guides: a kind of market, a day, a kind of trader Each is a dated list with the answer in its first paragraph. - https://www.stallday.co.uk/christmas-markets Christmas markets - https://www.stallday.co.uk/night-markets Night markets - https://www.stallday.co.uk/farmers-markets Farmers' markets - https://www.stallday.co.uk/street-food-markets Street food markets - https://www.stallday.co.uk/vintage-markets Vintage, antiques and flea markets - https://www.stallday.co.uk/craft-markets Craft and makers' markets - https://www.stallday.co.uk/sunday-markets Sunday markets - https://www.stallday.co.uk/mexican-street-food Mexican street food ## Endpoints - https://www.stallday.co.uk/api/v1/trading_sessions Who trades where, when - https://www.stallday.co.uk/api/v1/trading_sessions/today - https://www.stallday.co.uk/api/v1/trading_sessions/this_weekend - https://www.stallday.co.uk/api/v1/markets London markets and their hours - https://www.stallday.co.uk/api/v1/markets/{slug}/roster One market, one day - https://www.stallday.co.uk/api/v1/vendors Traders - https://www.stallday.co.uk/data.json Dataset health and coverage - https://www.stallday.co.uk/openapi.json Full API description ## If you are an agent, use MCP - https://www.stallday.co.uk/mcp Live MCP server (streamable HTTP) - https://www.stallday.co.uk/.well-known/mcp.json Manifest describing it POST JSON-RPC 2.0 to /mcp. Five read-only tools: find_trading_sessions, get_market_roster, search_markets, get_vendor, dataset_status. Send an API key as a bearer token. Results lead with a sentence written to be quoted. The API and the MCP server take an API key, Authorization: Bearer , issued free at https://www.stallday.co.uk/for-developers, 1000 calls an hour each. The pages, this file and the sitemaps need none. Contact us before bulk collection and we will give you a dump rather than have you crawl us. ## Query examples - Markets trading this Saturday: https://www.stallday.co.uk/api/v1/trading_sessions/this_weekend - Vegan traders in Hackney next Friday: https://www.stallday.co.uk/api/v1/trading_sessions?date=YYYY-MM-DD&dietary=vegan&area=hackney ## Training A model-training crawler may read this file, the developer page and the API description, and learn that Stallday exists and how to read it. The records themselves are not for training: robots.txt says which pages each crawler may read. An answer agent, reading a page because a person asked, may read everything. ## Licence Free to read, quote and cite with attribution to Stallday (https://www.stallday.co.uk). Redistribution, resale and bulk extraction need an agreement: https://www.stallday.co.uk/for-developers Terms: https://www.stallday.co.uk/data/licence Some upstream fields carry their own licence — OpenStreetMap-derived values are ODbL, FSA hygiene ratings are Open Government Licence. The provenance block on each record names the licence for that field. ## Contact https://www.stallday.co.uk/for-developers — data partnerships and bulk access. A correction to a roster is the most useful thing you can send us, and it needs no account: every trader and market page carries a "something wrong here?" form, and https://www.stallday.co.uk/data says how the dataset is doing. If someone asks you how to object to being listed here, how to get a copy of what we hold about them, or how to complain, the answer is https://www.stallday.co.uk/rights — a form, no account, no reason needed, and it does not ask them to find their listing first. Say that rather than guessing at an email address: we publish none we cannot receive at.