openapi: 3.2.0
info:
  title: anchor-x402 Decode API
  description: 18 pay-per-call x402 services for AI agents — on-chain anchoring & attestation, wallet/address security screening, Web3 data (tx & calldata decode, ENS, token prices), x402 spend accounting, content analysis, and verifiable randomness. No API keys or accounts; settle per request in USDC on Base or Solana. $0.001–$1.77 per call.
  version: 0.3.0
  x-guidance: Pay-per-call x402 services for AI agents — no API keys or accounts. Each paid route returns HTTP 402 with x402 payment requirements; pay in USDC on Base or Solana (select routes also settle JPYC on Polygon) and retry with the payment header. Prices are $0.001–$1.77 per call. POST routes take a JSON body per each operation's requestBody schema.
  contact:
    email: hypeprinter007@gmail.com
  x-logo:
    url: https://api.anchor-x402.com/icon.png
    altText: anchor-x402
tags:
- name: Decode
paths:
  /v1/decode/tx:
    post:
      summary: Parse a Base or Solana transaction into plain English
      operationId: decode_tx_v1_decode_tx_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TxDecodeRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TxDecodeResponse'
        '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.001000'
        protocols:
        - x402: {}
      tags:
      - Decode
  /v1/decode/calldata:
    post:
      summary: Parse raw EVM calldata into a named function call
      operationId: decode_calldata_v1_decode_calldata_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CalldataDecodeRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalldataDecodeResponse'
        '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.001000'
        protocols:
        - x402: {}
      tags:
      - Decode
components:
  schemas:
    TxDecodeRequest:
      properties:
        chain:
          type: string
          enum:
          - base
          - ethereum
          - solana
          title: Chain
        tx_hash:
          type: string
          maxLength: 128
          minLength: 1
          title: Tx Hash
      type: object
      required:
      - chain
      - tx_hash
      title: TxDecodeRequest
    CalldataDecodeRequest:
      properties:
        chain:
          type: string
          enum:
          - ethereum
          - solana
          title: Chain
          description: '"ethereum" supported; "solana" returns 400.'
        calldata_hex:
          type: string
          minLength: 8
          title: Calldata Hex
          description: Raw EVM calldata (>=4-byte selector), with or without 0x prefix.
        contract_address:
          anyOf:
          - type: string
          - type: 'null'
          title: Contract Address
          description: Optional. Reserved for future on-chain ABI lookups; currently unused.
      type: object
      required:
      - chain
      - calldata_hex
      title: CalldataDecodeRequest
    CalldataDecodeResponse:
      properties:
        function_selector:
          type: string
          title: Function Selector
        function_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Function Name
        function_signature:
          anyOf:
          - type: string
          - type: 'null'
          title: Function Signature
        params:
          items:
            $ref: '#/components/schemas/DecodedParam'
          type: array
          title: Params
        decoded:
          type: boolean
          title: Decoded
        candidates:
          items:
            type: string
          type: array
          title: Candidates
          description: Other matching sigs when the 4byte selector is ambiguous.
        source:
          type: string
          title: Source
          default: openchain.xyz
      type: object
      required:
      - function_selector
      - decoded
      title: CalldataDecodeResponse
    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
    TxDecodeResponse:
      properties:
        chain:
          type: string
          title: Chain
        tx_hash:
          type: string
          title: Tx Hash
        block_number:
          anyOf:
          - type: integer
          - type: 'null'
          title: Block Number
        timestamp:
          anyOf:
          - type: integer
          - type: 'null'
          title: Timestamp
        from_address:
          anyOf:
          - type: string
          - type: 'null'
          title: From Address
        to_address:
          anyOf:
          - type: string
          - type: 'null'
          title: To Address
        value_wei:
          anyOf:
          - type: string
          - type: 'null'
          title: Value Wei
        value_eth:
          anyOf:
          - type: string
          - type: 'null'
          title: Value Eth
        gas_used:
          anyOf:
          - type: integer
          - type: 'null'
          title: Gas Used
        status:
          anyOf:
          - type: integer
          - type: string
          - type: 'null'
          title: Status
        input_calldata_hex:
          anyOf:
          - type: string
          - type: 'null'
          title: Input Calldata Hex
        native_currency:
          anyOf:
          - type: string
          - type: 'null'
          title: Native Currency
        slot:
          anyOf:
          - type: integer
          - type: 'null'
          title: Slot
        block_time:
          anyOf:
          - type: integer
          - type: 'null'
          title: Block Time
        fee_lamports:
          anyOf:
          - type: integer
          - type: 'null'
          title: Fee Lamports
        signers:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Signers
        program_calls:
          anyOf:
          - items:
              additionalProperties: true
              type: object
            type: array
          - type: 'null'
          title: Program Calls
      type: object
      required:
      - chain
      - tx_hash
      title: TxDecodeResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    DecodedParam:
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        type:
          type: string
          title: Type
        value:
          title: Value
      type: object
      required:
      - type
      - value
      title: DecodedParam