DC Hub API v2.1

Data center intelligence for developers and AI agents.

20,534+ facilities 140+ countries $51B+ deals tracked API Key Auth

DC Hub provides programmatic access to the world's most comprehensive data center intelligence platform. Search facilities, track M&A deals, query energy infrastructure, and get real-time market data.

Authenticate with your DC Hub API key to access full data and higher rate limits. Generate your key at dchub.cloud/dashboard.

Base URL

API Base

https://dchub.cloud

Static discovery files are served from https://dchub.cloud.

Quick test: Verify the API is running with GET /api/health

Authentication

Include your DC Hub API key in the X-API-Key header with every request. No token exchange needed — the key works directly.

Getting Your API Key

Generate your API key from your DC Hub Dashboard. Keys start with dchub_pro_ for Pro users.

Using Your Key

curl

# Include your API key in every request
curl "https://dchub.cloud/api/v1/facilities?limit=50" \
  -H "X-API-Key: dchub_pro_YOUR_KEY_HERE"

Search Facilities

curl

# Search by market
curl "https://dchub.cloud/api/v1/facilities?market=Northern%20Virginia&limit=25" \
  -H "X-API-Key: dchub_pro_YOUR_KEY_HERE"

Get Market Stats

curl

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

Pro Tip: Free users get 10 API calls/day. Pro subscribers get 10,000 calls/month with full data fields. Founding Members get Pro-level access at a locked-in rate.

Agent Endpoints

GET /api/agent/capabilities Full capability spec No Auth

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

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

Response includes

JSON

{
  "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..."
}

GET /api/agent/whoami Verify authentication Optional Auth

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

curl

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

Authenticated response

JSON

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

GET /api/agent/facilities Search 20,534+ data centers Optional Auth

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

Parameter	Type	Description
q	string	Search query — matches name, city, or provider
country	string	Filter by country name
limit	integer	Max results (default: 20, max: 100)

curl

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

Response

JSON

{
  "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
}

GET /api/agent/stats Platform overview No Auth

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

curl

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

Platform Data Endpoints

These power the DC Hub frontend and are open for any agent or developer to use.

GET /api/news Industry news No Auth

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

Parameter	Type	Description
limit	integer	Max articles (default: 50)

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

GET /api/transactions M&A deals No Auth

Data center M&A deals, acquisitions, and investments. $51B+ total deal volume tracked.

Parameter	Type	Description
limit	integer	Max results (default: 100)
deal_type	string	Filter: acquisition, investment, merger

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

GET /api/stats Platform statistics No Auth

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

GET /api/v1/markets/list All markets No Auth

List all tracked data center markets with summary data.

Related endpoints:

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

GET /api/v1/lmp/prices Energy pricing by ISO No Auth

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.

GET /api/v1/pipeline Construction pipeline No Auth

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

GET /api/v1/map Facility map data No Auth

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

Discovery Files

Machine-readable files for AI crawlers, LLM context injection, and agent-to-agent communication. Served from dchub.cloud.

📋

skill.json

OpenClaw skill definition

🤖

AGENTS.md

Agent communication guide

AI summary (~800 tokens)

📑

llms-full.txt

Full context (~4K tokens)

🎯

for-ai.html

AI integration dashboard

auth.md

GET /auth.md Auth instructions (Markdown) No Auth

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

URL

https://dchub.cloud/auth.md

Rate Limits

Rate limits vary by plan. Include your API key to get your plan's rate limit.

Tier	Requests	Requirement
Free	10/day	Free account
Pro / Founding	10,000/month	Valid API key
Enterprise	Unlimited	Enterprise API key

Errors

All error responses follow a consistent JSON format:

JSON

{
  "error": "Description of what went wrong",
  "auth_instructions": "https://dchub.cloud/api-docs#auth"  // on 401s
}

Code	Meaning
200	Success
400	Bad request — missing required parameters
401	Invalid or missing API key
429	Rate limit exceeded
500	Server error