API Schema

Returns all tracked campaigns with signal strength, funding, backer tier, and current status.

{
  "campaigns": [
    {
      "id": "berachain-boyco",
      "name": "Berachain Boyco",
      "signal": 3,
      "category": "airdrop",
      "funding": 42000000,
      "backer_tier": "tier_1",
      "backers": ["Polychain", "Framework"],
      "chain": "berachain",
      "status": "active",
      "urgency": "ends_soon",
      "effort": "medium",
      "cost_usd": 50,
      "est_value": {"min": 500, "max": 2000},
      "tasks": ["connect_wallet", "deposit"],
      "automation_config": {"browser_use": "https://api.passivepin.xyz/configs/berachain.json"},
      "last_updated": "2025-05-21T12:00:00Z"
    }
  ],
  "meta": {"total": 23, "version": "v0.1"}
}

Returns step-by-step tasks for a specific campaign. Each task includes selectors, gas estimates, and automation params.

{
  "campaign_id": "berachain-boyco",
  "tasks": [
    {
      "step": 1,
      "action": "connect_wallet",
      "target_url": "https://berachain.com/boyco",
      "selectors": {
        "connect_btn": "[data-testid='connect-wallet']"
      },
      "gas_estimate": 0,
      "automation": {"requires_signature": true}
    },
    {
      "step": 2,
      "action": "deposit",
      "selectors": {
        "vault_dropdown": "[data-testid='vault-select']",
        "amount_input": "input[name='amount']"
      },
      "gas_estimate": 450000,
      "automation": {"requires_signature": true}
    }
  ]
}

Check wallet eligibility across known airdrop contracts. Returns missed allocations, claimable tokens, and upcoming drops.

{
  "address": "0x742d...bEb",
  "missed": [
    {"project": "Arbitrum", "value": 1200, "claimable": false},
    {"project": "Optimism", "value": 800, "claimable": false}
  ],
  "claimable_now": [
    {"project": "Zora", "value": 350, "claim_url": "https://zora.co/claim"}
  ],
  "upcoming": [
    {"project": "LayerZero", "snapshot_date": "2025-06-01"}
  ],
  "total_missed_value": 2000
}

Returns flagged GitHub commits containing alpha keywords across monitored repos.

{
  "alerts": [
    {
      "repo": "berachain/contracts",
      "commit": "a1b2c3d",
      "message": "feat: add snapshot merkle tree for airdrop",
      "keywords": ["snapshot", "airdrop"],
      "author": "dev@berachain.com",
      "timestamp": "2025-05-21T08:30:00Z",
      "severity": "high"
    }
  ]
}