Meridian Signal API · v2026-07

Signal API documentation

Paid product for Signal / Portfolio Alerts ($19.99/mo). Same rules engine as the public Rules Portfolio. Non-custodial: you execute at your own broker (Tiger, IBKR, Moomoo, etc.).

← Product page · API Console

Entitlement

Active membership plan: portfolio_alerts
Create keys in the API Console while signed in
Data endpoints require API key (not session cookie)

Authentication

Authorization: Bearer msig_live_<secret>
# or
X-Api-Key: msig_live_<secret>

Keys are shown once at creation. Meridian stores only a SHA-256 hash.

Endpoints

GET /api/v1/portfolio/rebalance

Full rebalance payload: actions, positions, cash weight, as-of date.

GET /api/v1/portfolio/positions

Positions + cash snapshot only.

GET|POST|DELETE /api/v1/signal-api/keys

Session auth. Manage up to 5 live keys.

GET|POST|DELETE /api/v1/signal-api/webhook

Session auth. Register HTTPS URL; secret returned once for HMAC verify.

GET /api/v1/signal-api/me

Session auth. Entitlement, keys list, webhook status.

Example response (rebalance)

{
  "product": "meridian_signal",
  "version": "2026-07",
  "asOf": "2026-07-24",
  "cashWeight": 0.12,
  "rebalance": {
    "needed": true,
    "summary": "2 trade(s) on 2026-07-24: BUY NVDA, SELL …",
    "actions": [
      {
        "symbol": "NVDA",
        "action": "BUY",
        "currentWeight": 0,
        "targetWeight": 0.22,
        "deltaWeight": 0.22,
        "reason": "…"
      }
    ]
  },
  "positions": [ … ],
  "meta": { "disclaimer": "…" }
}

Webhooks

On portfolio alert dispatch (rebalance with trades), Meridian POSTs:

POST https://your-server/hooks/meridian
Content-Type: application/json
X-Meridian-Event: portfolio.rebalance
X-Meridian-Signature: sha256=<hmac_hex>

{
  "event": "portfolio.rebalance",
  "timestamp": "…",
  "data": { /* same as GET rebalance */ }
}

Verify: HMAC-SHA256(raw_body, webhook_secret) hex digest equals the value after sha256=.

Public vs paid

GET /api/portfolio/meridian — public full portfolio JSON (DIY / research). No key.
GET /api/v1/signal — public macro direction (not rebalance list).
GET /api/v1/portfolio/* — paid Signal product with stable contract + webhooks.

curl

export MSIG_KEY=msig_live_…
curl -sS "https://meridianintel.xyz/api/v1/portfolio/rebalance" \
  -H "Authorization: Bearer $MSIG_KEY" | jq .

Not investment advice. Non-custodial: Meridian does not place orders or hold client funds. Past performance of the demo rules book is not indicative of future results. Contact research@meridianintel.xyz.