Bitcoin OP RETURN Chain Share

Share of OP RETURN chain space used by each detected protocol.

Percentage breakdown of Bitcoin's OP RETURN output space by the protocol writing to it (Runes, Omni, Stacks, OpenTimestamps, plain text, and unclassified), plus an Other slice for every remaining protocol not broken out individually. Other is the total OP RETURN chain share minus the six named protocols.

View in Newhedge External link

How to call

Request format

GET 
curl -X GET "https://newhedge.io/api/v2/metrics/op-return-chain-share/METRIC_NAME?api_token=YOUR_TOKEN"
Query params

api_token (required) — 24 character token.

resolution (optional) — 1d (default), 12h, 4h, 1h, 30m, 10m, coarsest to finest. Finer buckets are served to Advanced and Enterprise accounts, and only for the metrics that ingest them (listed per metric below); see Resolutions.

before (optional) — exclusive cursor, returns observations older than this timestamp_ms. Works on every resolution.

limit (optional) — the most recent N observations, maximum 5000. Finer resolutions page by default (2500); a 1d request returns the whole series unless you send limit or before.

before and limit narrow a time series. A response with no single time axis, such as a hash keyed by venue or a labelled snapshot table, has nothing to cut on. It is returned whole, and both parameters are ignored rather than rejected.

A before that is not a positive epoch-millisecond timestamp is a 400. It is the one paging value we reject rather than ignore, because a page size has a sensible default and a cursor does not.

include (optional) — definition wraps the response as {"definition": …, "data": …} and returns the record shown under each metric; see Definitions. Any other value is a 400.

Path params

:metric_name — one of the metric names listed below.

Responses

200 with JSON payload, 400 for an unknown include value, 401 for missing/invalid token, 404 for missing resources. A 404 for a metric withdrawn on purpose adds withdrawn, withdrawn_on and reason, for example {"error":"Metric not found","withdrawn":true,"withdrawn_on":"2026-09-07","reason":"The venue's public feed reports insurance-fund settlements, not liquidation orders."}; a removed chart can add successor.

Plan and quota refusals keep these statuses and error texts and add code, required_plan, current_plan, feature, upgrade_url, limit and resets_at where they apply. A Pro token whose history window removed points also gets the X-Newhedge-History-Truncated headers, and for a Pro token X-Newhedge-Available-From is the start of the window. See Errors and plan limits.

Metrics

Each metric is fetched independently. Responses are trimmed samples to show structure.

7 metrics
Metric

Runesop_return_runes_chain_share

Data used by the Bitcoin OP RETURN Chain Share chart.

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint 
https://newhedge.io/api/v2/metrics/op-return-chain-share/op_return_runes_chain_share?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    0.39110002
  ],
  [
    1792627200000,
    0.39130002
  ],
  [
    1792713600000,
    0.39189997
  ]
]
Definition (from the chart description)

Units: percent

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

Omniop_return_omni_chain_share

Data used by the Bitcoin OP RETURN Chain Share chart.

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint 
https://newhedge.io/api/v2/metrics/op-return-chain-share/op_return_omni_chain_share?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    0.053000003
  ],
  [
    1792627200000,
    0.0529
  ],
  [
    1792713600000,
    0.0529
  ]
]
Definition (from the chart description)

Units: percent

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

Stacksop_return_stacks_chain_share

Data used by the Bitcoin OP RETURN Chain Share chart.

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint 
https://newhedge.io/api/v2/metrics/op-return-chain-share/op_return_stacks_chain_share?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    0.0164
  ],
  [
    1792627200000,
    0.0164
  ],
  [
    1792713600000,
    0.0164
  ]
]
Definition (from the chart description)

Units: percent

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

OpenTimestampsop_return_open_timestamps_chain_share

Data used by the Bitcoin OP RETURN Chain Share chart.

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint 
https://newhedge.io/api/v2/metrics/op-return-chain-share/op_return_open_timestamps_chain_share?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    0.0
  ],
  [
    1792627200000,
    0.0
  ],
  [
    1792713600000,
    0.0
  ]
]
Definition (from the chart description)

Units: percent

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

Textop_return_text_chain_share

Data used by the Bitcoin OP RETURN Chain Share chart.

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint 
https://newhedge.io/api/v2/metrics/op-return-chain-share/op_return_text_chain_share?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    0.0343
  ],
  [
    1792627200000,
    0.0343
  ],
  [
    1792713600000,
    0.0344
  ]
]
Definition (from the chart description)

Units: percent

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

Unknownop_return_unknown_chain_share

Data used by the Bitcoin OP RETURN Chain Share chart.

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint 
https://newhedge.io/api/v2/metrics/op-return-chain-share/op_return_unknown_chain_share?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    0.0323
  ],
  [
    1792627200000,
    0.0324
  ],
  [
    1792713600000,
    0.0324
  ]
]
Definition (from the chart description)

Units: percent

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily

Metric

Otherop_return_other_chain_share

Data used by the Bitcoin OP RETURN Chain Share chart.

Resolutions: 1d, 12h, 4h, 1h, 30m, 10m.

Endpoint 
https://newhedge.io/api/v2/metrics/op-return-chain-share/op_return_other_chain_share?api_token=YOUR_TOKEN

Replace `YOUR_TOKEN` with your API token.

Sample response
200 Successful response 
[
  [
    1792540800000,
    0.289499977
  ],
  [
    1792627200000,
    0.28959998
  ],
  [
    1792713600000,
    0.28940007
  ]
]
Definition (from the chart description)

Units: percent

Timestamp (1d): Labelled 00:00 UTC of the day it describes.

Timestamp (finer resolutions): A finer resolution is labelled in UTC at the end of the interval it covers, not at its start. Add include=definition to a request and the definition describes the bucket that request was served.

Calendar: calendar_daily