Market volume ranking
POST /v1/market/volume-rankingRank postcode districts by transaction volume or median price over a
Same call over MCP
Rank districts by volume or pricemarket_volume_rankingAuthenticate with an API key from the API & MCP Hub. The same call is available as an MCP tool at the same price.
Reference
What POST /v1/market/volume-ranking returns
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").
Request
Calling POST /v1/market/volume-ranking
curl -X POST "https://api.marketcode.ai/v1/market/volume-ranking" \
-H "Authorization: Bearer $MARKETCODE_API_KEY"
-H "Content-Type: application/json" \
-d '{"county":"GREATER LONDON","months":12,"limit":5}'Send your API key as a Bearer token. Every response carries credits_charged and credits_remaining.
Inputs
Parameters
This endpoint takes no path or query parameters.
Request body
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| county | Body | string | No | e.g. "GREATER LONDON" |
| area | Body | string | No | e.g. "SW" |
| months | Body | integer | No | Default: 12 |
| order_by | Body | string | No | Default: txn_count |
| limit | Body | integer | No | Default: 50 |
Response
What POST /v1/market/volume-ranking returns for a real request
curl -X POST "https://api.marketcode.ai/v1/market/volume-ranking" \
-H "Authorization: Bearer $MARKETCODE_API_KEY"
-H "Content-Type: application/json" \
-d '{"county":"GREATER LONDON","months":12,"limit":5}'{
"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.
Response
Response fields
| 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.
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
Endpoints 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.
How do I authenticate?
+
Send your API key as a Bearer token in the Authorization header. Keys are created in the API & MCP Hub, shown once and revocable. Every response carries the credits charged and your remaining balance.
Is there an MCP version?
+
Yes. The market_volume_ranking tool on the MarketCode MCP server is the same call at the same price, signed in with OAuth rather than a key, so Claude, ChatGPT, Codex and Cursor can run it in a conversation.
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 on a real address.
30-minute call. We'll provision a key and walk through the endpoint on your use case.