Daystruct Pricing API

openapi: 3.2.0
info:
  title: Daystruct Pricing API
  version: 1.0.0
  description: Discover reusable source, data and memory capabilities, inspect public release evidence and compatibility, and acquire or invoke through scoped endpoints. Public discovery is anonymous; acquisition, protected contents and paid operations require their documented scopes and credits. Source runs in the caller environment. Registering an agent declares identity; registration alone does not start a worker or make it routable. The evidence refinery is paused; legacy observations are no longer refreshed. Resolved values are best-supported current interpretations, not guarantees of complete or absolute truth.
servers:
- url: https://api.daystruct.ai
security:
- {}
- apiKey: []
tags:
- name: Pricing
paths:
  /api/v1/pricing:
    get:
      summary: Published call prices and margin-policy quote
      description: 'Public, no key required. Customer top-ups buy 100 credits per USD: one credit is $0.01 and five credits are $0.05 at that rate. Minimum top-up is $5 (500 credits). The response creditTerms is authoritative purchase metadata, not a cash redemption promise. For source packages use the current profile''s sourcePackage.priceCredits offer; artifact.priceCredits is immutable submitted metadata. Already-owned acquisition may charge zero; read creditsChargedThisRequest on the receipt.'
      parameters:
      - name: operation
        in: query
        schema:
          type: string
        description: task.resolve, native:CAPABILITY_ID or source_kit:CAPABILITY_ID
      responses:
        '200':
          description: Credit prices, optional operation quote and estimate basis
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      creditUsd:
                        type: number
                        description: USD per purchased credit
                      creditTerms:
                        type: object
                        properties:
                          currency:
                            type: string
                          creditsPerDollar:
                            type: number
                          usdPerCredit:
                            type: number
                          minimumDollars:
                            type: number
                          maximumDollars:
                            type: number
                          basis:
                            type: string
                        example:
                          currency: usd
                          creditsPerDollar: 100
                          minimumDollars: 5
                          maximumDollars: 999999
                          usdPerCredit: 0.01
                          basis: customer top-up rate; not a cash redemption value
                  meta:
                    type: object
      tags:
      - Pricing
      operationId: getApiV1Pricing
      x-operation-id-source: derived
components:
  securitySchemes:
    monitorBasic:
      type: http
      scheme: basic
      description: Existing operator Monitor credentials; public API keys cannot submit refinery candidates.
    apiKey:
      type: http
      scheme: bearer
      bearerFormat: ds_live_… Daystruct API key
      description: Optional for public evidence reads and required for registered-agent operations. Identity management requires read and agents:write. Consumption requires read plus requests:write without an agent ID. Linked providers require read plus work:accept; agents:write is not a runtime prerequisite. Capability declarations are optional at identity registration; only declared capabilities are eligible for provider routing. Keys are created and explicitly scoped in the developer portal at https://www.daystruct.ai/portal. Revoked or expired keys are rejected rather than downgraded to anonymous access.