Rank districts by volume or price
market_volume_rankingRank postcode districts by transaction volume or median price over a
Same call over REST
Market volume ranking/v1/market/volume-rankingNot connected yet? Connect your assistant. Sign in with your MarketCode account; no API key needed.
Reference
What market_volume_ranking answers
Restrict the candidate set with county ("GREATER LONDON") or area ("SW"); omit both to rank nationally. UK only.
Inputs
Before you call it
- county
- Give exactly one geography.
districtis a postcode district ("NW1", not a borough name),areaa postcode area ("NW") andcountyan upper-case county name ("GREATER LONDON").
Example
An example call to market_volume_ranking
Use the MarketCode tool market_volume_ranking with {"county":"GREATER LONDON","months":12,"limit":5} and show me the result.{
"country": "UK",
"query": {
"county": "GREATER LONDON",
"months": 12,
"order_by": "txn_count",
"limit": 5
},
"data": {
"months": 12,
"order_by": "txn_count",
"count": 5,
"districts": [
{
"outward_code": "CR0",
"primary_county": "GREATER LONDON",
"postcode_area": "CR",
"txn_count": 1510,
"txn_count_ppd_a": 1162,
"median_price": 390941
},
{
"outward_code": "E17",
"primary_county": "GREATER LONDON",
"postcode_area": "E",
"txn_count": 1046,
"txn_count_ppd_a": 896,
"median_price": 557769
},
{
"outward_code": "SW11",
"primary_county": "GREATER LONDON",
"postcode_area": "SW",
"txn_count": 1044,
"txn_count_ppd_a": 919,
"median_price": 756688
},
"… 2 more"
],
"cached": true,
"time_ms": 1.2
},
"credits_charged": 0
}A real response, captured from production and trimmed: arrays to three items, long strings shortened, volatile keys dropped.
Inputs
Arguments market_volume_ranking takes
| Name | Type | Required | Description |
|---|---|---|---|
| county | string | No | |
| area | string | No | |
| months | integer | No | Default: 12 |
| order_by | string | No | One of: mean_price, median_price, p25_price, p75_price, txn_count, txn_count_new_build, txn_count_ppd_a, txn_count_ppd_b, txn_count_uprn_matchedDefault: txn_count |
| limit | integer | No | Default: 50 |
Response
What comes back
| Field | Type | Example |
|---|---|---|
| country | string | UK |
| query | object | |
| query.county | string | GREATER LONDON |
| query.months | integer | 12 |
| query.order_by | string | txn_count |
| query.limit | integer | 5 |
| data | object | |
| data.months | integer | 12 |
| data.order_by | string | txn_count |
| data.count | integer | 5 |
| data.districts | array | |
| data.districts[].outward_code | string | CR0 |
| data.districts[].primary_county | string | GREATER LONDON |
| data.districts[].postcode_area | string | CR |
| data.districts[].txn_count | integer | 1510 |
| data.districts[].txn_count_ppd_a | integer | 1162 |
| data.districts[].median_price | integer | 390941 |
| data.cached | boolean | true |
| data.time_ms | number | 1.2 |
| credits_charged | integer | 0 |
Fields observed in the example response above; a field the example did not exercise is not listed.
Usage
How to run market_volume_ranking in your assistant
Ask your assistant in plain English, for example:
"Use the MarketCode tool market_volume_ranking for <address or area>.
Show the result and the credits charged."
The arguments the assistant will send, for the example on this page:
{"county":"GREATER LONDON","months":12,"limit":5}The connect steps for Claude, ChatGPT, Codex, Cursor and Claude Code are on the MCP page.
Skills
Skills that use market_volume_ranking
- Property research: A sourced answer to any UK property question: the right tool for the job, the credit cost stated first, the wording rules that keep an estimate an estimate.
- Area insights: A market brief for any UK area: the published indices, volumes, listing stock, agent activity and auction outcomes, compared and ranked against neighbours.
Price and licence
What it costs, and where the data comes from
market_volume_ranking is free over MCP and over REST, and the two surfaces share one credit balance. Free calls need a signed-in account or an API key and appear in your usage, but they never touch your balance.
Credits are granted on sign-up and bought in packs; the pricing page lists every call.
Sources
- HM Land Registry
Price Paid Data
Open Government Licence v3 · England and Wales
Related
Tools used with market_volume_ranking
- Asking-price index (portal listings)Free
asking_price_index_seriesHedonic ASKING-PRICE index for one postcode district, local authority or Great Britain, from portal listings (Rightmove ~95%), 2022M01 = 100, with 80% bands and posterior standard errors, smoothed toward the parent geography.Same category - Asking-rent index (portal listings, ONS-validated)Free
asking_rent_index_seriesHedonic ASKING-RENT index for one postcode district, local authority or Great Britain, from portal lettings, 2022M01 = 100, with bands and SEs. This is the residential rent index; commercial_rent_index_series is the VOA one for commercial property.Same category - Commercial capital indexFree
commercial_index_seriesRepeat-sales CAPITAL index for UK commercial property, quarterly, 1995Q1 = 100.Same category - Commercial capital and rent indices for a placeFree
commercial_marketThe commercial market for a sector and a place: the repeat-sales CAPITAL index, the VOA rating-list RENT index, and the rated stock standing in the authority with its hereditament count, total and median rateable value.Same category - Commercial rent indexFree
commercial_rent_index_seriesCommercial RENT index from the VOA rating lists — FOUR points, one per list (2010 / 2017 / 2023 / 2026), each dated at that list's antecedent valuation date (2008-04-01, 2015-04-01, 2021-04-01, 2024-04-01), with the 2010 list = 100.Same category - Index forecast h1–h7 with bandsFree
market_forecastThe published house-price index forecast for a postcode district or local authority: the last SETTLED index point as the anchor, then up to seven forecast periods with `lo`/`hi` bands, plus the method and publication grain behind them. Seven is the horizon the index publishes — nothing beyond it is offered, and a forecast is a projection of the smoothed repeat-sales index, not a valuation of any property. UK only.Same category
FAQ
Questions about market_volume_ranking
How much does `market_volume_ranking` cost?
+
market_volume_ranking is free over MCP and over REST, and the two surfaces share one credit balance. Free calls need a signed-in account or an API key and appear in your usage, but they never touch your balance.
Which assistants can run `market_volume_ranking`?
+
Any MCP client: Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT in developer mode, Codex and Cursor, each documented on the MCP page. You sign in with your MarketCode account over OAuth; there is no key to paste, and the connection is read-only.
Where does the data come from?
+
Read from HM Land Registry price paid data. Coverage is the UK.
Does `market_volume_ranking` change anything?
+
No. The tool is annotated read-only on the server, so it never writes to your data or ours and an assistant can call it without a confirmation step.
Try market_volume_ranking in your assistant.
30-minute call. We'll connect your assistant live on a real address.