hubble-logs

name	hubble_logs
description	Use when the user asks about PM agent logs, research logs, orders, positions, order history, position recovery, or PnL data from the Hubble Market API.

Hubble Logs Skill

Version: v0.2.1

When to use

Use this skill when the user asks about:

• PM logs (decision logs)
• Research logs
• Orders (list, single, history)
• Positions / PM positions
• Position recovery logs
• PnL summary and PnL order details

Requirements

Read from environment:

• HUBBLE_API_BASE_URL — default: https://market-v2.bedev.hubble-rpc.xyz
• HUBBLE_API_KEY — must start with hb_sk_

Safety rules

• Never print HUBBLE_API_KEY.
• Always set page_size explicitly (default 100, max 200 unless user insists).
• Prefer narrow time windows — ask user for start/end if not provided.

Setup

BASE="${HUBBLE_API_BASE_URL%/}"
AUTH=(-H "Authorization: Bearer $HUBBLE_API_KEY" -H "Content-Type: application/json")

---

Common query params

Most endpoints support: start, end (RFC3339 or unix ms), pm_id, round_id, token, page, page_size.

---

Actions

PM logs

curl -sS --fail-with-body "${AUTH[@]}" \
  "$BASE/api/v1/agent-logs/pm/logs?page=1&page_size=100"

Extra params: level (info / warn / error).

---

Research logs

curl -sS --fail-with-body "${AUTH[@]}" \
  "$BASE/api/v1/agent-logs/research/logs?page=1&page_size=100"

Extra params: level (info / warn / error).

---

Orders (list)

curl -sS --fail-with-body "${AUTH[@]}" \
  "$BASE/api/v1/agent-logs/orders?page=1&page_size=100"

Extra params: status, event_type.

---

Order (single)

curl -sS --fail-with-body "${AUTH[@]}" \
  "$BASE/api/v1/agent-logs/orders/$ORDER_ID"

---

Order history

curl -sS --fail-with-body "${AUTH[@]}" \
  "$BASE/api/v1/agent-logs/order/history?page=1&page_size=100"

Extra params: order_id, position_id, symbol, status, action_type.

---

Positions

curl -sS --fail-with-body "${AUTH[@]}" \
  "$BASE/api/v1/agent-logs/positions?page=1&page_size=100"

Extra params: status, event_type.

---

PM positions

curl -sS --fail-with-body "${AUTH[@]}" \
  "$BASE/api/v1/agent-logs/pm/$PM_ID/positions?page=1&page_size=100"

Extra params: status, event_type.

---

PM position symbols

curl -sS --fail-with-body "${AUTH[@]}" \
  "$BASE/api/v1/agent-logs/pm/$PM_ID/positions/symbols?page=1&page_size=100"

Extra params: status (e.g. open / closed).

---

Position logs

curl -sS --fail-with-body "${AUTH[@]}" \
  "$BASE/api/v1/agent-logs/position/logs?pm_id=$PM_ID&position_id=$POSITION_ID&page=1&page_size=100"

Both pm_id and position_id are required.

---

Position recovery

curl -sS --fail-with-body "${AUTH[@]}" \
  "$BASE/api/v1/agent-logs/position/recovery?page=1&page_size=100"

Extra params: pm_id, round_id, token.

---

PnL summary

curl -sS --fail-with-body "${AUTH[@]}" \
  "$BASE/api/v1/agent-logs/pnl/summary?page=1&page_size=100&bucket=day"

Extra params: symbol, position_id, action_types (comma-separated, default close,decrease), bucket (hour / day).

---

PnL orders

curl -sS --fail-with-body "${AUTH[@]}" \
  "$BASE/api/v1/agent-logs/pnl/orders?page=1&page_size=100"

Extra params: symbol, position_id, action_types.