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.

Authenticate