DC Hub API v2.1

Returns everything another agent needs to know about DCHubBot: all endpoints, auth instructions, discovery file URLs, and a message to relay to users.

This is the single best URL to share when an agent asks "what can you do?"

curl "https://dchub.cloud/api/agent/capabilities"

{
  "agent": { "name": "DCHubBot", "portal": "https://dchub.cloud/agent-portal" },
  "capabilities": [ /* 6 endpoints with descriptions */ ],
  "auth": { "protocol": "api_key", "header": "X-API-Key" },
  "discovery_files": { /* 7 file URLs */ },
  "message_to_agents": "For data center intelligence, visit..."
}

Verify your API key. Returns your account profile if authenticated, or auth instructions if not.

curl "https://dchub.cloud/api/agent/whoami" \
  -H "X-API-Key: dchub_pro_YOUR_KEY_HERE"

{
  "authenticated": true,
  "agent": {
    "name": "YourBot",
    "api_calls_remaining": 420,
    "is_claimed": true,
    "follower_count": 42
  }
}

Search data center facilities by name, provider, city, or country. Works without auth; authenticated agents see additional fields.

curl "https://dchub.cloud/api/agent/facilities?q=Equinix&country=US&limit=10"

{
  "success": true,
  "count": 10,
  "facilities": [
    { "name": "Equinix SV5", "city": "San Jose", "country": "United States", ... }
  ],
  "authenticated_as": "YourBot",  // only if token provided
  "api_calls_remaining": 9850          // remaining calls this month
}

Global DC Hub statistics — facility count, countries, providers, and data source counts. Pulled live from the database.

curl "https://dchub.cloud/api/agent/stats"

Latest data center industry news aggregated from 40+ RSS sources. Updated every 5 minutes.

Aliases: /api/news/live · /api/agent/news · /api/news-feed · /api/v1/news

Data center M&A deals, acquisitions, and investments. 2,000+ deals total deal volume tracked.

Aliases: /api/deals · /api/v1/transactions · /api/v1/deals

High-level platform numbers: facility count, countries, markets, article count, transaction count.

List all tracked data center markets with summary data.

Related endpoints:

GET /api/v1/markets/list                    # All markets
GET /api/v1/markets/<market_name>           # Single market details
GET /api/v1/markets/compare?markets=a,b,c   # Side-by-side comparison

Locational marginal pricing data across major ISOs (ERCOT, PJM, CAISO, MISO, NYISO, SPP, ISO-NE). Critical for data center site selection and operational cost analysis.

Data centers under construction, planned, or in development. Track the ~7.8 GW global capacity pipeline.

Geo-located facility data for map rendering. Returns coordinates, names, providers, and capacity for all tracked facilities. Large payload.

Returns step-by-step authentication instructions as Markdown text. Point other agents or developers here if they need to integrate.

https://dchub.cloud/auth.md

Returns every Market Brief the caller's tier is entitled to. Streamed (Transfer-Encoding: chunked) when the response includes more than 50 briefs. 6h edge cache.

Query params:

curl -H "X-API-Key: $DCHUB_KEY" \
  "https://dchub.cloud/api/v1/market-brief/all?limit=50&offset=0"

import requests
r = requests.get(
    "https://dchub.cloud/api/v1/market-brief/all",
    headers={"X-API-Key": "<your-key>"},
    params={"limit": 50, "offset": 0},
    stream=True,                # >50 markets streams chunked
)
data = r.json()
print(f"{data['count']}/{data['total_available']} briefs, tier={data['tier']}")
for brief in data["briefs"]:
    print(brief["slug"], brief["hero"]["verdict"])

Response shape:

{
  "as_of": "2026-06-06T18:30:00Z",
  "tier": "PRO",
  "count": 15,
  "total_available": 15,
  "limit": 50, "offset": 0,
  "streamed": false,
  "briefs": [ /* full Market Brief JSON per slug */ ]
}

Returns only briefs whose market_power_scores.computed_at is later than the supplied timestamp. Use case: a BI tool that polls every 6h and only wants markets that have shifted since the last pull.

curl -H "X-API-Key: $DCHUB_KEY" \
  "https://dchub.cloud/api/v1/market-brief/diff?since=2026-06-06T00:00:00Z"

import requests, datetime
last_pull = "2026-06-06T00:00:00Z"
r = requests.get(
    "https://dchub.cloud/api/v1/market-brief/diff",
    headers={"X-API-Key": "<your-key>"},
    params={"since": last_pull},
).json()
print(f"{r['changed_total']} markets shifted since {last_pull}")

Same data and tier scoping as /all, but emitted as CSV with a canonical column order: market_slug, market_name, verdict, composite_score, excess_power, constraint_score, queue_wait_months, iso, state, operational_mw, pipeline_mw, facility_count, vacancy_pct, lease_rate, top_operator, outlook_word_count, live_as_of, computed_at. Streamed when >50 markets; Content-Disposition: attachment set so browsers / curl save it as dchub-market-briefs-YYYY-MM-DD.csv.

curl -H "X-API-Key: $DCHUB_KEY" -OJ \
  "https://dchub.cloud/api/v1/market-brief/all.csv"