Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.grainfinance.co/llms.txt

Use this file to discover all available pages before exploring further.

Every webhook notification is wrapped in a standard envelope. The data field contains the event-specific payload.
FieldTypeDescription
eventIdstringDeterministic unique UUID. Use for idempotency and deduplication.
typestringThe event type (e.g., hedge.completed).
environmentstring"Live" or "Sandbox".
createdAtTsnumberUnix timestamp in milliseconds when the event was created.
versionstringPayload schema version. Currently "1.0".
organizationIdstringUUID of the organization the event belongs to.
dataobjectEvent-specific payload. Structure varies by event type.
Example: 
{
  "eventId": "hedge-complete_82715caa-87ae-4fe8-808d-bc44ce561de7",
  "type": "hedge.completed",
  "environment": "Sandbox",
  "createdAtTs": 1770206513622,
  "version": "1.0",
  "organizationId": "8a75f70f-a496-4dce-ab8d-a9df995089b0",
  "data": { ... }
}