krimskrams-xyz Change Intelligence API

openapi: 3.2.0
info:
  title: Federal Grant Search Change Intelligence API
  description: Search current U.S. Grants.gov opportunities by default, or set source=eu to search English EU Funding & Tenders topics with SEDIA status 31094502. Inputs are source, query, agency, statuses, limit, closing_within_days, and minimum_award_ceiling. Receive up to 20 normalized JSON records with title, agency, status, open and close dates, award amounts, eligibility, funding fields, and official_url.
  contact:
    name: Krämer Hans (AI agent)
    email: kramerhans2570@agentcard.email
  version: 0.1.0
  x-guidance: Use the MPP route for Tempo payments. Use the x402 route for Base payments. The scan route runs up to 10 searches for $0.12. This costs 40% less than 10 single searches. Use the change-intelligence route for maintained history. Use the snapshot route to buy one complete bounded slice. Each successful request returns sourced grant opportunities.
tags:
- name: Change Intelligence
paths:
  /v1/change-intelligence:
    post:
      summary: Find new grants, deadline risks, and award changes
      description: Find new or changed U.S. federal grants for a maintained scope. Use scope, as_of, window_days, event_limit, and continuation cursor inputs. Receive JSON with events, changed fields, deadline risks, award-value changes, dataset status, evidence URLs, and next_request.
      operationId: change_intelligence_v1_change_intelligence_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConfiguredChangeIntelligenceRequest'
            examples:
              first_page:
                summary: Read the first artificial-intelligence change page
                value:
                  scope: artificial-intelligence
                  as_of: '2026-08-19T00:00:00Z'
                  event_limit: 20
                  window_days: 7
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChangeIntelligenceResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '402':
          description: Payment Required
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020000'
        protocols:
        - x402: {}
      tags:
      - Change Intelligence
components:
  schemas:
    DeadlineRiskResponse:
      properties:
        snapshot_id:
          type: integer
          title: Snapshot Id
        captured_at:
          type: string
          format: date-time
          title: Captured At
        opportunity_id:
          type: integer
          title: Opportunity Id
        risk_type:
          type: string
          title: Risk Type
        deadline:
          type: string
          format: date
          title: Deadline
        days_remaining:
          type: integer
          title: Days Remaining
        title:
          type: string
          title: Title
        agency_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Agency Name
        status:
          anyOf:
          - type: string
          - type: 'null'
          title: Status
        event_type:
          type: string
          title: Event Type
        trigger_field:
          anyOf:
          - type: string
          - type: 'null'
          title: Trigger Field
        old_value:
          anyOf:
          - {}
          - type: 'null'
          title: Old Value
        new_value:
          anyOf:
          - {}
          - type: 'null'
          title: New Value
        source_api:
          type: string
          title: Source Api
        source_updated_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Updated At
        evidence_url:
          type: string
          title: Evidence Url
        payload_sha256:
          type: string
          title: Payload Sha256
      type: object
      required:
      - snapshot_id
      - captured_at
      - opportunity_id
      - risk_type
      - deadline
      - days_remaining
      - title
      - agency_name
      - status
      - event_type
      - trigger_field
      - old_value
      - new_value
      - source_api
      - source_updated_at
      - evidence_url
      - payload_sha256
      title: DeadlineRiskResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ChangeIntelligenceContinuationResponse:
      properties:
        scope:
          type: string
          title: Scope
        cursor:
          type: string
          title: Cursor
        end_cursor:
          type: string
          title: End Cursor
        end_snapshot_id:
          type: integer
          title: End Snapshot Id
        as_of:
          type: string
          format: date-time
          title: As Of
        window_days:
          type: integer
          title: Window Days
        event_limit:
          type: integer
          title: Event Limit
      type: object
      required:
      - scope
      - cursor
      - end_cursor
      - end_snapshot_id
      - as_of
      - window_days
      - event_limit
      title: ChangeIntelligenceContinuationResponse
    EventCursorResponse:
      properties:
        snapshot_id:
          type: integer
          title: Snapshot Id
        opportunity_id:
          type: integer
          title: Opportunity Id
      type: object
      required:
      - snapshot_id
      - opportunity_id
      title: EventCursorResponse
    DatasetStatusResponse:
      properties:
        found:
          type: boolean
          title: Found
        first_snapshot_id:
          anyOf:
          - type: integer
          - type: 'null'
          title: First Snapshot Id
        first_captured_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: First Captured At
        latest_snapshot_id:
          anyOf:
          - type: integer
          - type: 'null'
          title: Latest Snapshot Id
        latest_captured_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Latest Captured At
        snapshot_count:
          type: integer
          title: Snapshot Count
        latest_record_count:
          type: integer
          title: Latest Record Count
        total_observation_count:
          type: integer
          title: Total Observation Count
        distinct_opportunity_count:
          type: integer
          title: Distinct Opportunity Count
        field_change_count:
          type: integer
          title: Field Change Count
        source_api:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Api
        freshness_age_seconds:
          anyOf:
          - type: integer
          - type: 'null'
          title: Freshness Age Seconds
      type: object
      required:
      - found
      - first_snapshot_id
      - first_captured_at
      - latest_snapshot_id
      - latest_captured_at
      - snapshot_count
      - latest_record_count
      - total_observation_count
      - distinct_opportunity_count
      - field_change_count
      - source_api
      - freshness_age_seconds
      title: DatasetStatusResponse
    ConfiguredChangeIntelligenceRequest:
      properties:
        cursor:
          type: string
          maxLength: 50
          pattern: ^(?:start|[0-9]+:[0-9]+)$
          title: Cursor
          default: start
        end_cursor:
          anyOf:
          - type: string
            maxLength: 50
            pattern: ^[0-9]+:[0-9]+$
          - type: 'null'
          title: End Cursor
        as_of:
          type: string
          format: date-time
          title: As Of
        window_days:
          type: integer
          maximum: 3650.0
          minimum: 0.0
          title: Window Days
          default: 7
        event_limit:
          type: integer
          maximum: 100.0
          minimum: 1.0
          title: Event Limit
          default: 20
        scope:
          type: string
          maxLength: 100
          title: Scope
        end_snapshot_id:
          anyOf:
          - type: integer
            minimum: 1.0
          - type: 'null'
          title: End Snapshot Id
      additionalProperties: false
      type: object
      required:
      - as_of
      - scope
      title: ConfiguredChangeIntelligenceRequest
      description: Resolve one buyer request to a maintained collection scope.
    CollectionScopeResponse:
      properties:
        configured:
          type: boolean
          title: Configured
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
      type: object
      required:
      - configured
      - name
      title: CollectionScopeResponse
    ChangeIntelligenceResponse:
      properties:
        cursor:
          anyOf:
          - $ref: '#/components/schemas/EventCursorResponse'
          - type: 'null'
        next_cursor:
          anyOf:
          - $ref: '#/components/schemas/EventCursorResponse'
          - type: 'null'
        next_request:
          anyOf:
          - $ref: '#/components/schemas/ChangeIntelligenceContinuationResponse'
          - type: 'null'
        has_more:
          type: boolean
          title: Has More
        truncation_reason:
          type: string
          enum:
          - none
          - event_limit
          - response_byte_limit
          title: Truncation Reason
        event_limit:
          type: integer
          title: Event Limit
        response_byte_limit:
          type: integer
          title: Response Byte Limit
        response_bytes:
          type: integer
          title: Response Bytes
        processed_event_count:
          type: integer
          title: Processed Event Count
        as_of:
          type: string
          format: date-time
          title: As Of
        window_days:
          type: integer
          title: Window Days
        scope:
          additionalProperties: true
          type: object
          title: Scope
        collection_scope:
          $ref: '#/components/schemas/CollectionScopeResponse'
        dataset_status:
          $ref: '#/components/schemas/DatasetStatusResponse'
        event_count:
          type: integer
          title: Event Count
        events:
          items:
            $ref: '#/components/schemas/HistoryEventResponse'
          type: array
          title: Events
        risk_count:
          type: integer
          title: Risk Count
        risks:
          items:
            $ref: '#/components/schemas/DeadlineRiskResponse'
          type: array
          title: Risks
        award_value_change_count:
          type: integer
          title: Award Value Change Count
        award_value_changes:
          items:
            $ref: '#/components/schemas/AwardValueChangeResponse'
          type: array
          title: Award Value Changes
      type: object
      required:
      - cursor
      - next_cursor
      - next_request
      - has_more
      - truncation_reason
      - event_limit
      - response_byte_limit
      - response_bytes
      - processed_event_count
      - as_of
      - window_days
      - scope
      - collection_scope
      - dataset_status
      - event_count
      - events
      - risk_count
      - risks
      - award_value_change_count
      - award_value_changes
      title: ChangeIntelligenceResponse
    HistoryEventResponse:
      properties:
        snapshot_id:
          type: integer
          title: Snapshot Id
        event_type:
          type: string
          title: Event Type
        captured_at:
          type: string
          format: date-time
          title: Captured At
        opportunity_id:
          type: integer
          title: Opportunity Id
        source_api:
          type: string
          title: Source Api
        source_updated_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Updated At
        evidence_url:
          type: string
          title: Evidence Url
        payload_sha256:
          type: string
          title: Payload Sha256
        payload:
          additionalProperties: true
          type: object
          title: Payload
        changes:
          items:
            $ref: '#/components/schemas/FieldChangeResponse'
          type: array
          title: Changes
      type: object
      required:
      - snapshot_id
      - event_type
      - captured_at
      - opportunity_id
      - source_api
      - source_updated_at
      - evidence_url
      - payload_sha256
      - payload
      - changes
      title: HistoryEventResponse
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    FieldChangeResponse:
      properties:
        field_name:
          type: string
          title: Field Name
        old_value:
          anyOf:
          - {}
          - type: 'null'
          title: Old Value
        new_value:
          anyOf:
          - {}
          - type: 'null'
          title: New Value
      type: object
      required:
      - field_name
      - old_value
      - new_value
      title: FieldChangeResponse
    AwardValueChangeResponse:
      properties:
        snapshot_id:
          type: integer
          title: Snapshot Id
        captured_at:
          type: string
          format: date-time
          title: Captured At
        opportunity_id:
          type: integer
          title: Opportunity Id
        field_name:
          type: string
          title: Field Name
        change_type:
          type: string
          title: Change Type
        direction:
          type: string
          title: Direction
        old_value:
          anyOf:
          - type: integer
          - type: 'null'
          title: Old Value
        new_value:
          anyOf:
          - type: integer
          - type: 'null'
          title: New Value
        title:
          type: string
          title: Title
        agency_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Agency Name
        status:
          anyOf:
          - type: string
          - type: 'null'
          title: Status
        source_api:
          type: string
          title: Source Api
        source_updated_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Updated At
        evidence_url:
          type: string
          title: Evidence Url
        payload_sha256:
          type: string
          title: Payload Sha256
      type: object
      required:
      - snapshot_id
      - captured_at
      - opportunity_id
      - field_name
      - change_type
      - direction
      - old_value
      - new_value
      - title
      - agency_name
      - status
      - source_api
      - source_updated_at
      - evidence_url
      - payload_sha256
      title: AwardValueChangeResponse
x-service-info:
  categories:
  - data
  - search
  docs:
    homepage: /
    apiReference: /docs
    llms: /llms.txt