DealWave API
Create an API key, authenticate your first request, and choose the next endpoint to try.
DealWave API access requires Agentic. Create keys in Settings > API Keys:
- Personal workspace:
/settings/api-keys - Team workspace:
/{account}/settings/api-keys
Name keys by environment or integration, such as Production GHL, Staging CRM, or Local development. New keys are shown once. Store the raw dw_sk_live_... value before closing the dialog because DealWave cannot show it again.
Authenticate
Send the key as a Bearer token.
curl https://app.dealwave.com/api/v1/analyze \
-H "Authorization: Bearer $DEALWAVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"address":"123 Main St, Indianapolis, IN 46201"}'
TypeScript
const response = await fetch('https://app.dealwave.com/api/v1/analyze', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.DEALWAVE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
address: '123 Main St, Indianapolis, IN 46201',
}),
});
const payload = await response.json();
if (!response.ok) {
throw new Error(`${payload.error.code}: ${payload.error.message}`);
}
Python
import os
import requests
response = requests.post(
"https://app.dealwave.com/api/v1/analyze",
headers={
"Authorization": f"Bearer {os.environ['DEALWAVE_API_KEY']}",
"Content-Type": "application/json",
},
json={"address": "123 Main St, Indianapolis, IN 46201"},
timeout=30,
)
response.raise_for_status()
payload = response.json()
Key Lifecycle
Revoke unused keys in Settings > API Keys. Revoked keys stop authenticating immediately.
To rotate a key, create a replacement key, update the integration or secret manager, confirm the new key works, then revoke the old key.
Common Failures
| Status | Code | Meaning |
|---|---|---|
401 | invalid_api_key | Missing, malformed, invalid, revoked, or expired key. |
403 | plan_required | API access requires Agentic. |
429 | rate_limit_exceeded | The per-key rate limit was exceeded. |
The current standard rate limit is 60 requests per minute per API key.
Next Endpoints
/score: score a deal with optional purchase price or ARV overrides./math: inspect the MAO and strategy calculation details./strategy: evaluate a specific exit strategy./analyze/batch: analyze up to 25 addresses synchronously with per-address failure isolation.