API Documentation
Base URL: https://api.bullrundata.com
Recession Intelligence
Capital Rotation
Investment Calculators
Economic Indicators
Market Analysis
Example Response
GET /v1/recession/probability
{
"probability": 37.9,
"riskLevel": "MODERATE",
"trend": "mid_cycle",
"confidence": "medium",
"fed_stance": "neutral",
"fed_weight_impact": 0,
"confirmation": {
"confirming": 0,
"total": 4,
"status": "NOT_CONFIRMING"
},
"recommendation": "Mixed signals require caution. Begin defensive rotation.",
"model": {
"version": "v1",
"indicators_used": 15,
"last_updated": "2026-03-30T06:00:00.000Z"
}
}
Calculator Request Schemas
POST/v1/calculators/investment-property
All fields except purchasePrice and monthlyRent are optional with sensible defaults.
{
"purchasePrice": 450000, // Required
"monthlyRent": 2800, // Required
"downPaymentPct": 20, // Default: 20
"interestRate": 7.0, // Default: 7.0
"loanTermYears": 30, // Default: 30
"vacancyRatePct": 8, // Default: 8
"annualPropertyTax": 5400, // Default: 0
"annualInsurance": 1800, // Default: 0
"monthlyHoa": 0, // Default: 0
"maintenancePct": 1, // Default: 1 (% of purchase price/yr)
"propertyMgmtPct": 0, // Default: 0 (% of rent)
"closingCostsPct": 3 // Default: 3
}
POST/v1/calculators/brrrr
All fields except purchasePrice, arv, and monthlyRent are optional.
{
"purchasePrice": 200000, // Required — acquisition price
"arv": 320000, // Required — after repair value
"monthlyRent": 2200, // Required
"rehabCosts": 45000, // Default: 0
"closingCostsBuyPct": 3, // Default: 3
"holdingCosts": 5000, // Default: 0 (total during rehab)
"vacancyRatePct": 8, // Default: 8
"annualPropertyTax": 3600, // Default: 0
"annualInsurance": 1400, // Default: 0
"propertyMgmtPct": 0, // Default: 0
"maintenancePct": 1, // Default: 1
"monthlyHoa": 0, // Default: 0
"monthlyUtilities": 0, // Default: 0
"monthlyOtherExpenses": 0, // Default: 0
"refiLtvPct": 75, // Default: 75
"refiRate": 7.0, // Default: 7.0
"refiTermYears": 30, // Default: 30
"refiClosingCostsPct": 2, // Default: 2
"useInitialLoan": false, // Default: false (cash purchase)
"initialLoanAmount": 0 // Default: 0
}