API Evangelist conversational phrasing for Tooloracle Io Carbon API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Tooloracle Io Carbon API
  version: 1.0.0
extends: openapi/tooloracle-io-carbon-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/api/v1/feeds/carbon/chains'].get
  update:
    x-apievangelist-phrasing:
      intent: Get carbon data for 49 blockchains
      effect: read
      questions:
      - How much CO2 and energy does each blockchain network use?
      - Which consensus types have the best carbon score across the 49 tracked networks?
      instructions:
      - text: Get carbon and energy data for all 49 networks from the carbon feed.
      - text: Compare CO2 per network across the 49 tracked blockchains.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/feeds/carbon/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Get blockchain carbon summary stats
      effect: read
      questions:
      - What are the headline carbon statistics across blockchains in the feed?
      - Can I get aggregate emissions stats instead of per-chain data?
      instructions:
      - text: Show the carbon feed summary statistics.
      - text: Summarize total blockchain emissions from the carbon feed.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/carbon/chains'].get
  update:
    x-apievangelist-phrasing:
      intent: Get public carbon data for 50+ chains
      effect: read
      questions:
      - Is there a public endpoint for carbon data on 50+ blockchains?
      - Can I read per-chain carbon data without going through the feeds path?
      instructions:
      - text: Get public per-chain carbon data from the /carbon/chains path.
      - text: List the 50+ chains in the public carbon dataset with their scores.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/carbon/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Get carbon summary from the alternate path
      effect: read
      questions:
      - Is there an alternate carbon summary path outside the feeds API?
      - Where's the non-feed carbon summary endpoint?
      instructions:
      - text: Pull the carbon summary from the alternate /carbon/summary path.
      - text: Read the carbon summary via the alternate non-feed endpoint.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/carbon/mica/{symbol}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get MiCA Article 66 carbon data for a token
      effect: read
      questions:
      - Can I get sustainability data formatted for MiCA Article 66 disclosure?
      - What carbon figures does a MiCA-formatted report include for one network?
      instructions:
      - text: Get MiCA Article 66 carbon data for {symbol}.
        slots:
          symbol: path.symbol
      - text: Format the carbon disclosure for {symbol} the way MiCA requires.
        slots:
          symbol: path.symbol
      method: generated
      generated: '2026-10-01'