Traded APItraded.co ↗
Access commercial real estate deals, broker leaderboards, hotel transactions, VC rounds, and awards from Traded.co via 9 structured API endpoints.
What is the Traded API?
The Traded.co API exposes 9 endpoints covering commercial real estate transactions, broker leaderboards, venture capital deals, news, and awards. The get_deals endpoint returns paginated deal cards filterable by state, asset type, transaction type, date range, and price range — each record including address, sale price, loan amount, broker profiles, and property metadata. Companion endpoints handle hotel-specific deals, full deal detail, VC funding rounds, and ranked broker categories.
// select an endpoint above
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace traded-co-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Traded.co SDK — commercial real estate deals, leaderboards, and VC activity."""
from parse_apis.traded_co_api import Traded, AssetType, TransactionType, Market, State, DealNotFound
client = Traded()
# List multifamily sale deals in Florida with typed enum filters.
for deal in client.dealsummaries.list(state=State.FLORIDA, asset_type=AssetType.MULTIFAMILY, transaction_type=TransactionType.SALE, limit=3):
print(deal.title, deal.sale_price, deal.transaction_type)
# Drill into the first deal's full detail via the link navigation.
summary = client.dealsummaries.list_hotel(state=State.NATIONAL, limit=1).first()
if summary:
full_deal = summary.details()
print(full_deal.article_title, full_deal.asset_type)
for prop in full_deal.properties[:2]:
print(prop.display_address, prop.city, prop.state)
# Fetch broker leaderboards for the national market.
board = client.leaderboards.get(state=Market.NATIONAL)
for broker in board.unicorn[:3]:
print(broker.name, broker.deals_count, broker.total_volume)
# Get latest news articles.
for article in client.articles.list(limit=3):
print(article.title, article.published_at)
# Typed error handling when a deal slug doesn't exist.
try:
missing = client.deals.get(slug="nonexistent-deal-slug-12345")
print(missing.title)
except DealNotFound as exc:
print(f"Deal not found: {exc.slug}")
print("exercised: dealsummaries.list / list_hotel / .details / leaderboards.get / articles.list / deals.get (error)")
About the Traded API
Deal Data
The get_deals endpoint returns a count plus an array of deal summaries. Each summary carries id, slug, link, title, address, salePrice, loanAmount, transactionType, properties, and profiles. Filters include state (lowercase slug like 'new-york' or 'national'), asset_type ('multifamily', 'office', 'retail', 'industrial', 'hotel', 'mixed-use'), transaction_type ('sale', 'loan', 'lease'), date_range, and price_range. get_deal_detail and get_deal_by_link expand a single deal into full detail: buyers, sellers, lenders, brokers (with count and profileDealCompanies), profiles, assetType, and articleTitle. Pass the slug plus the path segments state, asset_type, and transaction_type to get_deal_detail, or pass the raw link field (e.g. 'deals/new-york/office/sale/example-deal-slug') to get_deal_by_link.
Brokers, Leaderboards, and Awards
get_leaderboards returns a leaderBoardResolver object with named category arrays: bigBoxers, builders, dealJunkie, hotDeals, leaseShark, loanShark, officeIanados, rentRollers, risingTalent, unicorn, and whales. Pagination is controlled via page and limit parameters; the state filter uses title-case values like 'New York' or 'National'. get_awards surfaces the same category structure (whales, unicorn, builders, hotDeals, bigBoxers, loanShark, dealJunkie, leaseShark, rentRollers, risingTalent) drawn from the awards page rather than the live leaderboard feed.
VC Deals and News
get_vc_deals returns a deals array of VC transaction objects (fields: id, articleTitle, caption, publishedAt, slug, totalDeals) alongside articlesData for VC interview and article blogs and proptechData for proptech blog content. get_news returns a data array of CRE news articles, each with id, title, slug, author, status, publishedAt, image, and tags. Neither news endpoint accepts filter parameters in the current spec. get_hotel_deals is a convenience wrapper around the deal feed restricted to asset_type: hotel, returning the same count and deals shape as get_deals.
The Traded API is a managed, monitored endpoint for traded.co — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when traded.co changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official traded.co API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track recent multifamily or office sales in a specific state using
get_dealswithasset_typeandstatefilters - Pull full buyer, seller, broker, and lender details for a known deal via
get_deal_by_linkusing thelinkfield from a listing - Build a broker performance dashboard by fetching ranked leaderboard categories from
get_leaderboardsfiltered to a target market - Monitor hotel transaction volume across all markets with
get_hotel_deals - Aggregate proptech funding rounds and VC deal metadata using
get_vc_deals - Surface CRE award winners by category (whales, unicorn, risingTalent) from
get_awardsfor industry recognition tracking - Feed a CRE news digest with structured article objects from
get_newsincluding publication date, author, and tags
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Traded.co offer an official developer API?+
How do leaderboard categories differ between `get_leaderboards` and `get_awards`?+
get_leaderboards is paginated and accepts a state filter (title-case, e.g. 'New York'), returning live ranked broker data across categories like whales, dealJunkie, and risingTalent. get_awards returns the same category names but pulls from the awards page — it takes no filter parameters, so it always returns the full national awards dataset.Can I filter news articles or VC deals by date, tag, or market?+
get_news and get_vc_deals return their full datasets without filter parameters. Both endpoints do include publishedAt and tags fields in responses, so client-side filtering is possible. You can fork this API on Parse and revise it to add server-side filter parameters for those endpoints.What deal path information do I need to call `get_deal_detail`?+
get_deal_detail requires the slug field and optionally accepts state, asset_type, and transaction_type slugs to construct the deal path. All three path segments are returned as part of the link field in get_deals results, so you can also pass the full link directly to get_deal_by_link instead.Does the API expose individual broker profile pages or historical broker deal history?+
profiles arrays within deal responses and as ranked entries within leaderboard and award categories — there is no standalone broker-profile endpoint. You can fork this API on Parse and revise it to add a dedicated broker profile endpoint using the profile slugs already present in deal responses.