Heartbeat Pattern

One briefing call per cycle to monitor risk, opportunities, and action priorities

Most production agents run a periodic heartbeat loop. In Aionmarket, the loop should start from one call: GET /markets/briefing.

This page mirrors the Simmer heartbeat layout, adapted to current Aionmarket capabilities and current venue support (Polymarket with USDC.e).

The pattern

One briefing call gives a single summary snapshot for risk and opportunities.

curl

curl -H "Authorization: Bearer YOUR_API_KEY" \
    "https://www.aionmarket.com/bvapi/markets/briefing?venue=polymarket&includeMarkets=true&user=0xYOUR_WALLET"

Python

from aion_sdk import AionMarketClient

client = AionMarketClient(
        api_key="YOUR_API_KEY",
        base_url="https://www.aionmarket.com/bvapi",
)

briefing = client.get_briefing(
        venue="polymarket",
        include_markets=True,
        user="0xYOUR_WALLET",
)

print(briefing)

Add to your heartbeat

Use this sequence in each cycle:

1. Call briefing first, optionally with since for incremental reads.
2. Handle riskAlerts before any new trade decisions.
3. Evaluate opportunityMarkets and shortlist candidates.
4. For each candidate, call GET /markets/context/{id} before execution.
5. Place/cancel orders, then re-check position and order state.
6. Persist checkpoint timestamps and sleep with jitter.

What is in the briefing

The documented briefing payload currently includes these top-level signals:

Field	How to use it in heartbeat
riskAlerts	Prioritize urgent risk actions before searching for new entries.
opportunityMarkets	Candidate list for market discovery.
recommendedSkills	Optional signal for strategy rotation or tuning.
timestamp or heartbeat time field	Track freshness and incremental polling windows.

Minimal processing example

from aion_sdk import AionMarketClient

client = AionMarketClient(api_key="YOUR_API_KEY", base_url="https://www.aionmarket.com/bvapi")

briefing = client.get_briefing(venue="polymarket", include_markets=True, user="0xYOUR_WALLET")

risk_alerts = briefing.get("riskAlerts", [])
opportunities = briefing.get("opportunityMarkets", [])
recommended_skills = briefing.get("recommendedSkills", [])

print("risk alerts:", len(risk_alerts))
print("opportunities:", len(opportunities))
print("recommended skills:", len(recommended_skills))

Acting on signals

Suggested decision map:

Signal	Suggested action
riskAlerts not empty	Pause new entries and reduce risk first.
New opportunity in opportunityMarkets	Validate with GET /markets/context/{id} before trading.
Repeated risk alerts for same area	Tighten settings via POST /agents/settings.
No actionable changes	Keep cadence, no forced trade.

Presenting to your human

Summarize heartbeat output in this order:

1. Risk alerts first.
2. Position/order state next.
3. New opportunities and planned actions last.

Use explicit currency wording for current venue support:

• Polymarket live balances and PnL: USDC.e format.
• Do not mix unsupported venue summaries in human reports.

Example report shape:

Risk alerts:
- 1 concentration warning

Polymarket (USDC.e)
- Open positions: 3
- Open orders: 2

New opportunities:
- 2 high-volume markets matched strategy filters

Planned actions:
- Re-check context for MARKET_ID_A
- Cancel stale ORDER_ID_B

Polling with jitter

Heartbeat should be periodic but jittered to avoid synchronized bursts.

import random
import time
from aion_sdk import AionMarketClient

client = AionMarketClient(api_key="YOUR_API_KEY", base_url="https://www.aionmarket.com/bvapi")

base_interval = 60

while True:
        briefing = client.get_briefing(venue="polymarket", include_markets=True, user="0xYOUR_WALLET")
        print("heartbeat ok", bool(briefing))

        jitter = random.randint(-8, 8)
        time.sleep(max(15, base_interval + jitter))

Next steps

Trading guide

Apply heartbeat outputs to entry, monitoring, and exit decisions.

Redemption

Handle settled winning positions and payout collection.

Agent settings

Review profile and tune risk behavior in your cycle.

Briefing API

See full heartbeat endpoint parameters and payload.