Marz Greta-Lock Network Solana API

openapi: 3.2.0
info:
  title: EQ Scoring Platform — Human-Likeness & AI Text Benchmark…
  description: 'Human-likeness scoring and AI text benchmark API. Score AI-generated text against real human personality profiles (EQ, formality, directness, hesitation, response-timing cadence) to measure how human your AI writing sounds before you ship it. Built for autonomous agents and AI text humanizer pipelines: free stateless scoring at /api/score, paid validated benchmarks via machine-to-machine On-chain settlement with x402 support — the default path is gasless USDC on Base (unpaid calls to /api/simulate return HTTP 402 with machine-readable payment requirements; sign the Base requirement and retry once with PAYMENT-SIGNATURE). Legacy SOL and X-PAYMENT clients remain compatible. Interactive API docs are available at /api/docs. Permanent tool setup (wire it in once and explicitly authorize a dedicated USDC-on-Base burner wallet so the SDK can sign paid calls without a human): see the ''Permanent tool setup'' section of /llms.txt and the crawlable guide at /guides/permanent-agent-tool-setup.html. Live network stats (real ledger aggregates) at /api/stats; runnable Python/JS quickstart examples ship in the repo under examples/.'
  version: 1.0.0
tags:
- name: Solana
paths:
  /api/solana/balance/{wallet_address}:
    get:
      summary: Get Solana Balance
      description: Return the SOL balance for a Solana wallet address using the public RPC.
      operationId: get_solana_balance_api_solana_balance__wallet_address__get
      parameters:
      - name: wallet_address
        in: path
        required: true
        schema:
          type: string
          title: Wallet Address
      - name: network
        in: query
        required: false
        schema:
          type: string
          pattern: ^(mainnet|devnet|testnet)$
          default: mainnet
          title: Network
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Solana
  /api/solana/history/{wallet_address}:
    get:
      summary: Get Solana History
      description: Return recent transaction signatures for a Solana wallet address.
      operationId: get_solana_history_api_solana_history__wallet_address__get
      parameters:
      - name: wallet_address
        in: path
        required: true
        schema:
          type: string
          title: Wallet Address
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 50
          minimum: 1
          default: 20
          title: Limit
      - name: network
        in: query
        required: false
        schema:
          type: string
          pattern: ^(mainnet|devnet|testnet)$
          default: mainnet
          title: Network
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Solana
  /api/solana/verify:
    post:
      summary: Verify Solana Signature
      description: 'Verify a Solana transaction signature on-chain and enforce double-spend protection.


        1. Checks the local database for a previously verified occurrence of this signature.

        2. If not seen, queries the public Solana RPC to confirm the signature exists on-chain.

        3. Records the signature in solana_verified_signatures (idempotency key) to prevent reuse.


        Returns the on-chain status plus whether this is a new or duplicate verification.'
      operationId: verify_solana_signature_api_solana_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SolanaVerifyInput'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Solana
components:
  schemas:
    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
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SolanaVerifyInput:
      properties:
        signature:
          type: string
          title: Signature
        network:
          type: string
          title: Network
          default: mainnet
      type: object
      required:
      - signature
      title: SolanaVerifyInput
x-provenance:
  method: harvested
  publisher: Marz Greta-Lock Network
  source: https://eqbuilder.dev/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)