07 / 07
For partners.
Report rewards server-to-server.
Partners report qualifying actions to the same endpoint the extension uses. The engine applies the source's cooldown and daily cap and splits the amount across the user's Earn Portfolio.
POST https://stocknet.family/api/rewards/events
Authorization: Bearer <session or partner token>
Content-Type: application/json
{
"kind": "partner_offer", // search · browsing · shopping · partner_offer ·
// sponsored_link · partner_action · referral
"amountMicros": 1250000, // optional; default per source, capped at 40× default
"meta": { "partner": "acme", "note": "signup completed" }
}
200 → { "result": { "ok": true, "event": {…}, "pendingMicros": … }, "summary": {…} }
429 → { "result": { "ok": false, "reason": "cooldown" | "daily_cap" } }Meta
Only allow-listed keys survive: partner, engine, origin, source, campaign, note, query, intent, page. Everything is length-capped; URLs are never stored.
Coming
Per-partner API keys and signed postbacks. Today the endpoint accepts user sessions; contact us to be wired in as a partner.