# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Gitdealflow Com Deep Signal API
  version: 1.0.0
extends: openapi/gitdealflow-com-deep-signal-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/agent/deep-signal'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a paid deep enriched signal for a startup
      effect: read
      questions:
      - Can I get a composite score, sector percentile and thesis for a startup using credits?
      - Am I charged a credit when a deep signal lookup misses?
      instructions:
      - text: Get the credit-paid deep signal for {name}.
        slots:
          name: requestBody.name
      - text: Pull comparables and multi-period history for {name} using my API key credits.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/agent/deep-signal/x402'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a deep signal paid per call via x402
      effect: read
      questions:
      - Can my agent pay per call in USDC on Base without an API key?
      - How does x402 pay-per-call work for the deep signal?
      instructions:
      - text: Get the deep signal for {name} and pay with x402 USDC on Base.
        slots:
          name: requestBody.name
      - text: Fetch {name}'s enriched signal via an x402 micropayment.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/agent/deep-signal/solana'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Solana payment instructions for credits
      effect: read
      questions:
      - What wallet, mint and amount do I need to buy deep-signal credits with Solana?
      - How many credits does a Solana USDC top-up grant?
      instructions:
      - text: Show the Solana USDC payment requirements for a credit top-up.
      - text: Get the payTo address and cluster for buying credits on Solana.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/agent/deep-signal/solana'].post
  update:
    x-apievangelist-phrasing:
      intent: Redeem a Solana USDC payment for credits
      effect: write
      questions:
      - I've sent USDC on Solana, how do I turn it into deep-signal credits?
      - Can a Solana transaction signature be redeemed more than once?
      instructions:
      - text: Redeem Solana transaction {signature} for deep-signal credits.
        slots:
          signature: requestBody.signature
      - text: Add credits to my account using the USDC transfer {signature}.
        slots:
          signature: requestBody.signature
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/account/credits'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the credit balance for an API key
      effect: read
      questions:
      - How many deep-signal credits are left on my API key?
      - Can I check my remaining credit balance before making paid calls?
      instructions:
      - text: Check my API key's credit balance.
      - text: Show how many credits I have remaining.
      method: generated
      generated: '2026-10-01'