Developers/Docs/Auto-Buy API

Auto-Buy API

Create automated purchasing rules that buy signals matching your criteria in real time. Set budgets, filters, and delivery preferences — signals are purchased and delivered the moment they appear.

Create Auto-Buy Rule

POST/api/v1/autobuy/rules

json

{
  "name": "Hot SaaS Switching Signals — West Coast",
  "filters": {
    "category": "switching_intent",
    "industry": "saas",
    "intent_level": "hot",
    "states": ["CA", "WA", "OR"]
  },
  "budget": {
    "daily_limit": 500,
    "monthly_limit": 10000,
    "max_price_per_signal": 100
  },
  "delivery": {
    "webhook_url": "https://your-app.com/webhook/autobuy",
    "enrich": true,
    "enrich_fields": ["email", "phone", "company_size"]
  }
}

json

{
  "id": "ab_rule_xyz789",
  "name": "Hot SaaS Switching Signals — West Coast",
  "status": "active",
  "budget": {
    "daily_limit": 500,
    "monthly_limit": 10000,
    "daily_spent": 0,
    "monthly_spent": 0
  },
  "created_at": "2026-03-27T12:00:00Z"
}

List Rules

GET/api/v1/autobuy/rules

Returns all auto-buy rules for your account, including current spend against budgets.

Update Rule

PATCH/api/v1/autobuy/rules/{rule_id}

json

{
  "budget": {
    "daily_limit": 750,
    "monthly_limit": 15000
  },
  "status": "paused"
}

Delete Rule

DELETE/api/v1/autobuy/rules/{rule_id}

Permanently deletes an auto-buy rule. Already-purchased signals are not affected.

Budget Enforcement

Budgets are enforced in real time at three levels:

Control	Behavior
max_price_per_signal	Skips any signal priced above this threshold
daily_limit	Pauses rule for the day once daily spend is reached
monthly_limit	Pauses rule for the month once monthly spend is reached

When a budget limit is hit, you receive an autobuy.budget_warning webhook event. The rule automatically resumes when the budget period resets.