{"uid":"cap_6jOyWQsNXgVjEFjOd6lC7","slug":"apex-runner-grid-health-signal-9116eafc","name":"APEX Runner Grid Health Signal","description":"APEX Runner: Grid Health Signal","url":"https://apexrunner.ai/signals/grid-health","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","required":["method"],"properties":{"queryParams":{"type":"object","properties":{"coin":{"enum":["AVAX","BTC","ETH","LINK","SOL","XRP"],"type":"string","default":"BTC"},"levels":{"type":"integer","default":8},"spacing_pct":{"type":"number","default":0.8}}}}},"output":{"type":"object","properties":{"example":{"type":"object","properties":{"coin":{"type":"string"},"atr_14":{"type":"number"},"rsi_14":{"type":"number"},"atr_fit":{"type":"string"},"current_config":{"type":"object","properties":{"levels":{"type":"integer"},"spacing_pct":{"type":"number"}}},"recommendation":{"type":"string"},"grid_efficiency_pct":{"type":"number"},"optimal_spacing_pct":{"type":"number"},"projected_daily_fills":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"pnl_pct":2.3,"fill_rate":0.68,"recommendation":"hold","rebalance_needed":false},"pnl_pct":"float — grid bot PnL as a percentage since last rebalance","fill_rate":"float — fraction of grid levels filled in the current cycle 0.0 to 1.0","recommendation":"string — suggested action: hold, rebalance, pause, or close","rebalance_needed":"boolean — true when price has moved outside the active grid range"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.35","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.35/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ki-8uGYnv0KfZRx8NVwkB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time health metrics for an active grid trading bot, including PnL, fill rate, and a rebalance recommendation.","exampleAgentPrompt":"Check the health of my APEX Runner grid bot and tell me if it needs rebalancing — I want to see the current PnL percentage, fill rate, and whether the recommendation is to hold, rebalance, pause, or close.","exampleUseCases":null,"resultDescription":"Returns a JSON object with: pnl_pct (float, grid bot PnL percentage since last rebalance), fill_rate (float 0.0–1.0, fraction of grid levels filled), recommendation (string enum: hold/rebalance/pause/close), and rebalance_needed (boolean indicating whether price has moved outside the active grid range).","failureModes":["No active grid bot found — returns empty or error if no grid strategy is running","Authentication failure — missing or invalid API credentials return 401/402","Grid bot not yet initialized — may return null values if bot has no trade history","Rate limit exceeded — too many calls in a short period return 429","Service unavailable — apexrunner.ai downtime returns 503"],"whenToPreferThis":"Use this endpoint when you need a real-time health check on a running grid trading bot to decide whether to rebalance, pause, or continue. It is specifically designed for grid strategy monitoring on Kraken, Coinbase, or Hyperliquid accounts managed by APEX Runner, and is ideal for agents automating periodic bot health checks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:52:12.293Z","isFirstParty":false}