Skip to main content
POST
/
agents
/
events
/
batch
cURL
# Agent endpoints require HMAC-SHA256 signing. See
# /get-started/authentication for the full payload + headers spec, or use
# the @relayerfi/agent-sdk which signs automatically.

curl -X POST https://api.relayer.fi/v1/agents/events/batch \
  -H "x-agent-id: $AGENT_ID" \
  -H "x-agent-auth: $HMAC_SIGNATURE_HEX" \
  -H "x-request-timestamp: $UNIX_TS" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      { "type": "llm_call",  "tokens": 1234, "cost_usd": "0.018" },
      { "type": "api_call",  "endpoint": "https://example/api", "cost_usd": "0.001" },
      { "type": "payment",   "amount": "5.00", "currency": "USDC", "to": "skill_xyz" }
    ]
  }'

Documentation Index

Fetch the complete documentation index at: https://docs.relayer.fi/llms.txt

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

Body

application/json
events
object[]
required
Maximum array length: 100

Response

Events recorded successfully