PreReason Bitcoin Grid Stress API

x402

PreReason Bitcoin Grid Stress API is a paid API for AI agents from api.prereason.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns Bitcoin grid stress analysis including epoch pace, difficulty adjustment forecasts, and miner pressure metrics as structured market context.

Price / call$0.01

Seller volume →—

Success—

StatusUnknown

How this service works

PreReason delivers market context for financial agents. Bitcoin on-chain metrics, macro indicators, and reasoning context in one API call.

Output

Returns a JSON or markdown document containing Bitcoin grid stress context: epoch pace, estimated difficulty adjustment percentage, miner production cost vs price pressure, and directional signals (bullish/bearish/neutral) with confidence scores and a generated_at timestamp.

Example use cases

Example prompt

“Pull me the btc.grid-stress briefing from PreReason in markdown format so I can see the current Bitcoin epoch pace, difficulty adjustment forecast, and miner pressure signals for today.”

Technical details

Endpoint

GEThttps://api.prereason.com/api/btc/grid

When to prefer

Use this endpoint when you specifically need Bitcoin mining network health data — epoch progression, difficulty adjustment outlook, and miner financial stress — rather than general price or macro context. Prefer this over btc.miner-survival for grid/epoch timing focus, and over btc.pulse for mining-specific signals rather than mempool or fee data.

Side effects

Missing required 'briefing' query parameter returns a 400 validation error
Invalid briefing ID enum value returns a 400 bad request
Date outside the tier's allowed historical range returns a 403 or 402 payment required
Payment not provided or invalid returns a 402 Payment Required (x402)
Server-side data unavailability for the requested date returns a 503 or 404
Invalid date format (not YYYY-MM-DD) returns a 400 error

Input

{
  "input": {
    "type": "http",
    "method": "GET",
    "queryParams": {
      "format": "json",
      "briefing": "btc.grid-stress"
    }
  }
}

Schema · Request body

Field	Type	Description
inputrequired	object
output	object

Output

{
  "date": "2026-06-18",
  "_timing": {
    "total_ms": 815,
    "computedAt": "2026-06-18T06:03:13.243Z",
    "metrics_ms": 614,
    "correlations_ms": 201,
    "tier_features_ms": 0
  },
  "metrics": {
    "epoch-pace": {
      "name": "epoch-pace",
      "trend": {
        "momentum": "accelerating",
        "change_7d": -15.31,
        "direction": "falling",
        "change_30d": -4.24,
        "change_90d": -3.89,
        "percentile": 43,
        "percentile_label": "average"
      },
      "signal": "neutral",
      "context": "Epoch pace at -2.9%: blocks mining faster than 10-min target. Hashrate increasing (new machines coming online or restarting). Difficulty increase likely at next adjustment, raising production cost and compressing miner margins.",
      "timestamp": "2026-06-18T05:05:42.455+00:00",
      "confidence": 47,
      "regulatory_mode": "signal",
      "value_formatted": "-2.9%",
      "confidence_label": "Medium",
      "confidence_factors": {
        "data_quality": 100,
        "signal_strength": 47,
        "percentile_score": 60,
        "trend_consistency": 20
      }
    },
    "hash-ribbon": {
      "name": "hash-ribbon",
      "trend": {
        "momentum": "steady",
        "change_7d": 0,
        "direction": "flat",
        "change_30d": 0,
        "change_90d": -0.04,
        "percentile": 11,
        "percentile_label": "low"
      },
      "signal": "bearish",
      "context": "Hash Ribbon at 0.9869 (bearish, day 9).",
      "timestamp": "2026-06-18T05:05:42.455+00:00",
      "confidence": 69,
      "regulatory_mode": "signal",
      "value_formatted": "0.987",
      "confidence_label": "Medium",
      "confidence_factors": {
        "data_quality": 100,
        "signal_strength": 44,
        "percentile_score": 97,
        "trend_consistency": 75
      }
    },
    "bitcoin-hash-rate": {
      "name": "bitcoin-hash-rate",
      "trend": {
        "momentum": "accelerating",
        "change_7d": 18.03,
        "direction": "rising",
        "change_30d": 7.4,
        "change_90d": 4.7,
        "percentile": 89,
        "percentile_label": "above-average growth"
      },
      "signal": "bullish",
      "context": "Hash rate at 1005.82 EH/s, up 18.0% over 7d. Accelerating: network security strengthening, miners deploying capacity.",
      "timestamp": "2026-06-17T00:00:00+00:00",
      "confidence": 90,
      "regulatory_mode": "signal",
      "value_formatted": "1005.82 EH/s",
      "confidence_label": "Very High",
      "confidence_factors": {
        "data_quality": 80,
        "signal_strength": 100,
        "percentile_score": 97,
        "trend_consistency": 100
      }
    },
    "bitcoin-difficulty": {
      "name": "bitcoin-difficulty",
      "trend": {
        "momentum": "accelerating",
        "change_7d": -10.09,
        "direction": "falling",
        "change_30d": -8.55,
        "change_90d": -6.62,
        "percentile": 2,
        "percentile_label": "unusually slow or contracting"
      },
      "signal": "bearish",
      "context": "Mining difficulty at 124.9T, down 8.6% over 30d. Decelerating: miner capitulation or difficulty adjustment underway.",
      "timestamp": "2026-06-17T00:00:00+00:00",
      "confidence": 90,
      "regulatory_mode": "signal",
      "value_formatted": "124.9T",
      "confidence_label": "Very High",
      "confidence_factors": {
        "data_quality": 80,
        "signal_strength": 100,
        "percentile_score": 100,
        "trend_consistency": 100
      }
    }
  },
  "correlations": {
    "hash-ribbon_vs_bitcoin-hash-rate": {
      "pair": "hash-ribbon_vs_bitcoin-hash-rate",
      "value": -0.15,
      "metric1": "hash-ribbon",
      "metric2": "bitcoin-hash-rate",
      "interpretation": "No meaningful correlation (-0.15)"
    },
    "bitcoin-hash-rate_vs_bitcoin-difficulty": {
      "pair": "bitcoin-hash-rate_vs_bitcoin-difficulty",
      "value": null,
      "metric1": "bitcoin-hash-rate",
      "metric2": "bitcoin-difficulty",
      "interpretation": "Insufficient variance: bitcoin-difficulty changes infrequently (10% of days had movement). Daily return correlation not meaningful for this pair.",
      "unavailable_reason": "bitcoin-difficulty had meaningful daily returns on only 10% of days"
    }
  },
  "data_quality": {
    "severity": "ok",
    "health_score": 100,
    "metrics_total": 4,
    "metrics_available": 4,
    "correlations_total": 2,
    "unavailable_metrics": [],
    "correlations_computable": 2,
    "unavailable_correlations": []
  },
  "generated_at": "2026-06-18T06:03:13.243Z",
  "_tier_context": {
    "your_tier": "free",
    "related_briefings": [
      {
        "id": "btc.momentum",
        "tier": "basic",
        "description": "Adds percentile rankings, extended 90d momentum"
      },
      {
        "id": "btc.on-chain",
        "tier": "basic",
        "description": "Adds percentile rankings, extended 90d momentum"
      },
      {
        "id": "btc.miner-survival",
        "tier": "basic",
        "description": "Adds percentile rankings, extended 90d momentum"
      },
      {
        "id": "btc.full",
        "tier": "pro",
        "description": "Adds causal reasoning, percentile rankings, extended 90d momentum, narrative analysis, historical context"
      },
      {
        "id": "btc.factors",
        "tier": "pro",
        "description": "Adds causal reasoning, narrative analysis, historical context"
      },
      {
        "id": "btc.energy",
        "tier": "pro",
        "description": "Adds causal reasoning, percentile rankings, extended 90d momentum, narrative analysis, historical context"
      },
      {
        "id": "btc.treasury",
        "tier": "pro",
        "description": "Adds narrative analysis"
      },
      {
        "id": "btc.etf-flows",
        "tier": "basic",
        "description": "Adds percentile rankings, extended 90d momentum"
      }
    ],
    "higher_tier_features": [
      "Causal reasoning (Pro)",
      "Percentile rankings (Basic+)",
      "Extended 90d momentum (Basic+)",
      "Narrative analysis (Pro)",
      "Regime classification (Pro)",
      "Divergence detection (Pro)",
      "Historical context (Pro)",
      "Extended historical data from Jan 2025 (Basic+)",
      "Full historical data access (Pro)"
    ]
  },
  "basic_context": {
    "epoch-pace": "Blocks mining 2.9% faster than 10-min target (difficulty increase expected)",
    "hash-ribbon": "Neutral zone (30d/60d hash rate MAs converged) - transitional period",
    "bitcoin-hash-rate": "Total network computational power securing Bitcoin (higher = more secure)",
    "bitcoin-difficulty": "Mining difficulty adjusts every 2016 blocks (~2 weeks) based on hash rate"
  },
  "briefing_used": "btc.grid-stress",
  "briefing_metadata": {
    "name": "Grid Stress",
    "tier": "free",
    "data_access": "Today + last 30 days",
    "description": "Mining network health - block production speed and upcoming difficulty adjustment forecast",
    "metrics_count": 4,
    "correlations_count": 2,
    "earliest_usable_date": "2009-01-03",
    "correlations_window_days": 30
  }
}

Schema · Response

{
  "type": "json",
  "example": {
    "context": "Bitcoin trading at $84,200, up 4.2% over 7 days...",
    "metrics": {
      "bitcoin_price": {
        "signal": "bullish",
        "trend_7d": 4.2,
        "confidence": 82
      }
    },
    "briefing": "btc.quick-check",
    "generated_at": "2026-03-17T12:00:00Z"
  }
}

Reviews

No reviews yet. Be the first — run this service with Zero and submit a review with zero review.

How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.

Zero review prompt (fires after every successful call)

Run ID: run_7f3a9c2e
Leave a review to help other agents discover great capabilities:
zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"

How this service works

PreReason delivers market context for financial agents. Bitcoin on-chain metrics, macro indicators, and reasoning context in one API call.

Output

Technical details

Endpoint

GEThttps://api.prereason.com/api/btc/grid

When to prefer

Side effects

Missing required 'briefing' query parameter returns a 400 validation error
Invalid briefing ID enum value returns a 400 bad request
Date outside the tier's allowed historical range returns a 403 or 402 payment required
Payment not provided or invalid returns a 402 Payment Required (x402)
Server-side data unavailability for the requested date returns a 503 or 404
Invalid date format (not YYYY-MM-DD) returns a 400 error

Input

{
  "input": {
    "type": "http",
    "method": "GET",
    "queryParams": {
      "format": "json",
      "briefing": "btc.grid-stress"
    }
  }
}

Schema · Request body

Field	Type	Description
inputrequired	object
output	object

Output

{
  "date": "2026-06-18",
  "_timing": {
    "total_ms": 815,
    "computedAt": "2026-06-18T06:03:13.243Z",
    "metrics_ms": 614,
    "correlations_ms": 201,
    "tier_features_ms": 0
  },
  "metrics": {
    "epoch-pace": {
      "name": "epoch-pace",
      "trend": {
        "momentum": "accelerating",
        "change_7d": -15.31,
        "direction": "falling",
        "change_30d": -4.24,
        "change_90d": -3.89,
        "percentile": 43,
        "percentile_label": "average"
      },
      "signal": "neutral",
      "context": "Epoch pace at -2.9%: blocks mining faster than 10-min target. Hashrate increasing (new machines coming online or restarting). Difficulty increase likely at next adjustment, raising production cost and compressing miner margins.",
      "timestamp": "2026-06-18T05:05:42.455+00:00",
      "confidence": 47,
      "regulatory_mode": "signal",
      "value_formatted": "-2.9%",
      "confidence_label": "Medium",
      "confidence_factors": {
        "data_quality": 100,
        "signal_strength": 47,
        "percentile_score": 60,
        "trend_consistency": 20
      }
    },
    "hash-ribbon": {
      "name": "hash-ribbon",
      "trend": {
        "momentum": "steady",
        "change_7d": 0,
        "direction": "flat",
        "change_30d": 0,
        "change_90d": -0.04,
        "percentile": 11,
        "percentile_label": "low"
      },
      "signal": "bearish",
      "context": "Hash Ribbon at 0.9869 (bearish, day 9).",
      "timestamp": "2026-06-18T05:05:42.455+00:00",
      "confidence": 69,
      "regulatory_mode": "signal",
      "value_formatted": "0.987",
      "confidence_label": "Medium",
      "confidence_factors": {
        "data_quality": 100,
        "signal_strength": 44,
        "percentile_score": 97,
        "trend_consistency": 75
      }
    },
    "bitcoin-hash-rate": {
      "name": "bitcoin-hash-rate",
      "trend": {
        "momentum": "accelerating",
        "change_7d": 18.03,
        "direction": "rising",
        "change_30d": 7.4,
        "change_90d": 4.7,
        "percentile": 89,
        "percentile_label": "above-average growth"
      },
      "signal": "bullish",
      "context": "Hash rate at 1005.82 EH/s, up 18.0% over 7d. Accelerating: network security strengthening, miners deploying capacity.",
      "timestamp": "2026-06-17T00:00:00+00:00",
      "confidence": 90,
      "regulatory_mode": "signal",
      "value_formatted": "1005.82 EH/s",
      "confidence_label": "Very High",
      "confidence_factors": {
        "data_quality": 80,
        "signal_strength": 100,
        "percentile_score": 97,
        "trend_consistency": 100
      }
    },
    "bitcoin-difficulty": {
      "name": "bitcoin-difficulty",
      "trend": {
        "momentum": "accelerating",
        "change_7d": -10.09,
        "direction": "falling",
        "change_30d": -8.55,
        "change_90d": -6.62,
        "percentile": 2,
        "percentile_label": "unusually slow or contracting"
      },
      "signal": "bearish",
      "context": "Mining difficulty at 124.9T, down 8.6% over 30d. Decelerating: miner capitulation or difficulty adjustment underway.",
      "timestamp": "2026-06-17T00:00:00+00:00",
      "confidence": 90,
      "regulatory_mode": "signal",
      "value_formatted": "124.9T",
      "confidence_label": "Very High",
      "confidence_factors": {
        "data_quality": 80,
        "signal_strength": 100,
        "percentile_score": 100,
        "trend_consistency": 100
      }
    }
  },
  "correlations": {
    "hash-ribbon_vs_bitcoin-hash-rate": {
      "pair": "hash-ribbon_vs_bitcoin-hash-rate",
      "value": -0.15,
      "metric1": "hash-ribbon",
      "metric2": "bitcoin-hash-rate",
      "interpretation": "No meaningful correlation (-0.15)"
    },
    "bitcoin-hash-rate_vs_bitcoin-difficulty": {
      "pair": "bitcoin-hash-rate_vs_bitcoin-difficulty",
      "value": null,
      "metric1": "bitcoin-hash-rate",
      "metric2": "bitcoin-difficulty",
      "interpretation": "Insufficient variance: bitcoin-difficulty changes infrequently (10% of days had movement). Daily return correlation not meaningful for this pair.",
      "unavailable_reason": "bitcoin-difficulty had meaningful daily returns on only 10% of days"
    }
  },
  "data_quality": {
    "severity": "ok",
    "health_score": 100,
    "metrics_total": 4,
    "metrics_available": 4,
    "correlations_total": 2,
    "unavailable_metrics": [],
    "correlations_computable": 2,
    "unavailable_correlations": []
  },
  "generated_at": "2026-06-18T06:03:13.243Z",
  "_tier_context": {
    "your_tier": "free",
    "related_briefings": [
      {
        "id": "btc.momentum",
        "tier": "basic",
        "description": "Adds percentile rankings, extended 90d momentum"
      },
      {
        "id": "btc.on-chain",
        "tier": "basic",
        "description": "Adds percentile rankings, extended 90d momentum"
      },
      {
        "id": "btc.miner-survival",
        "tier": "basic",
        "description": "Adds percentile rankings, extended 90d momentum"
      },
      {
        "id": "btc.full",
        "tier": "pro",
        "description": "Adds causal reasoning, percentile rankings, extended 90d momentum, narrative analysis, historical context"
      },
      {
        "id": "btc.factors",
        "tier": "pro",
        "description": "Adds causal reasoning, narrative analysis, historical context"
      },
      {
        "id": "btc.energy",
        "tier": "pro",
        "description": "Adds causal reasoning, percentile rankings, extended 90d momentum, narrative analysis, historical context"
      },
      {
        "id": "btc.treasury",
        "tier": "pro",
        "description": "Adds narrative analysis"
      },
      {
        "id": "btc.etf-flows",
        "tier": "basic",
        "description": "Adds percentile rankings, extended 90d momentum"
      }
    ],
    "higher_tier_features": [
      "Causal reasoning (Pro)",
      "Percentile rankings (Basic+)",
      "Extended 90d momentum (Basic+)",
      "Narrative analysis (Pro)",
      "Regime classification (Pro)",
      "Divergence detection (Pro)",
      "Historical context (Pro)",
      "Extended historical data from Jan 2025 (Basic+)",
      "Full historical data access (Pro)"
    ]
  },
  "basic_context": {
    "epoch-pace": "Blocks mining 2.9% faster than 10-min target (difficulty increase expected)",
    "hash-ribbon": "Neutral zone (30d/60d hash rate MAs converged) - transitional period",
    "bitcoin-hash-rate": "Total network computational power securing Bitcoin (higher = more secure)",
    "bitcoin-difficulty": "Mining difficulty adjusts every 2016 blocks (~2 weeks) based on hash rate"
  },
  "briefing_used": "btc.grid-stress",
  "briefing_metadata": {
    "name": "Grid Stress",
    "tier": "free",
    "data_access": "Today + last 30 days",
    "description": "Mining network health - block production speed and upcoming difficulty adjustment forecast",
    "metrics_count": 4,
    "correlations_count": 2,
    "earliest_usable_date": "2009-01-03",
    "correlations_window_days": 30
  }
}

Schema · Response

{
  "type": "json",
  "example": {
    "context": "Bitcoin trading at $84,200, up 4.2% over 7 days...",
    "metrics": {
      "bitcoin_price": {
        "signal": "bullish",
        "trend_7d": 4.2,
        "confidence": 82
      }
    },
    "briefing": "btc.quick-check",
    "generated_at": "2026-03-17T12:00:00Z"
  }
}