BlockRazor API

openapi: 3.1.0
info:
  title: BlockRazor API
  version: '2026-11-02'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-02: 21 operation(s) read from 40 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; BlockRazor has published no machine-readable contract
    that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 7
    documentation: 14
    pages-with-code: 14
    pages-read: 40
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-02'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.blockrazor.io/transaction-submission/rpc/ethereum/endpoint.md
  - https://docs.blockrazor.io/transaction-submission/block-builder/endpoint.md
  - https://docs.blockrazor.io/transaction-submission/rpc/bsc/bsc-rpc-endpoint.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/endpoint.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/robinhood-chain/endpoint.md
  - https://docs.blockrazor.io/get-started/authentication.md
  - https://docs.blockrazor.io/streams/node-stream/ethereum.md
  - https://docs.blockrazor.io/transaction-submission/block-builder.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending.md
  - https://docs.blockrazor.io/streams/block-stream/solana/geyser-stream/go.md
  - https://docs.blockrazor.io/streams/block-stream/solana/geyser-stream/js.md
  - https://docs.blockrazor.io/streams/block-stream/solana/geyser-stream/cli.md
  - https://docs.blockrazor.io/transaction-submission/rpc/bsc/eth_sendbundle.md
  - https://docs.blockrazor.io/streams/block-stream/solana/geyser-stream/rust.md
  - https://docs.blockrazor.io/streams/node-stream/ethereum/cl-el-client-sync.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/base.md
  - https://docs.blockrazor.io/transaction-submission/block-builder/call-bundle.md
  - https://docs.blockrazor.io/transaction-submission/block-builder/send-bundle.md
  - https://docs.blockrazor.io/transaction-submission/block-builder/trace-bundle.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/solana.md
  - https://docs.blockrazor.io/transaction-submission/rpc/bsc/eth_sendrawtransaction.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/bsc/broadcast-tx.md
  - https://docs.blockrazor.io/transaction-submission/block-builder/send-privatetransaction.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-batch.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-bundle.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/ethereum/broadcast-tx.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-bundle/go.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-bundle/js.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-bundle/curl.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-bundle/rust.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-transaction.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/base/eth_sendrawtransaction.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/robinhood-chain/eth_sendbatch.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/base/eth_sendrawtransaction-tip.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-batch/request-example.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-batch/request-example/go.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-batch/request-example/js.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/robinhood-chain/eth_sendrawtransaction.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-batch/request-example/curl.md
  - https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-batch/request-example/rust.md
servers:
- url: https://virginia.builder.blockrazor.io
paths:
  /:
    post:
      operationId: post
      tags:
      - Api
      summary: POST /
      x-source: https://docs.blockrazor.io/transaction-submission/rpc/bsc/eth_sendbundle.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST -H \"Content-Type: application/json\" --data '{\n  \"id\": 1,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"eth_sendMevBundle\"\
          ,\n  \"params\": [{\n    \"Txs\": [\n\"0xf8668203988405f5e100825208942ee393c739036a7660ec11bf2101d537eb52f3ac80808193a06836d5f4052376dc3114794da5fedd7a5b8090ddae0ec45dfa66c234fcabb6efa07cf17dad992c33e8e3e4d82355cfe12d3be2560fc2b0873c36dce398088d8e4f\"\
          \n    ],\n    \"revertingTxHashes\":[],\n "
  /BlockRazorinc/geyserstream-client-go/releases/download/v1.0.0/{v100id}:
    get:
      operationId: get_BlockRazorinc_geyserstream_client_go_releases_download_v1_0_0_v100id
      tags:
      - Blockrazorinc
      summary: GET /BlockRazorinc/geyserstream-client-go/releases/download/v1.0.0/client-darwin-arm64
      x-source: https://docs.blockrazor.io/streams/block-stream/solana/geyser-stream/cli.md
      parameters:
      - name: v100id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -L -o client https://github.com/BlockRazorinc/geyserstream-client-go/releases/download/v1.0.0/client-darwin-arm64

          ```'
        collapsed_from: 3 example path(s) differing only at v100Id
  /bundlestate:
    get:
      operationId: get_bundlestate
      tags:
      - Bundlestate
      summary: GET /bundlestate
      x-source: https://docs.blockrazor.io/transaction-submission/block-builder/trace-bundle.md
      parameters:
      - name: hash
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBundlestateResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X GET "https://bsc-bundle-stats.blockrazor.io/bundlestate?hash=0x25f9fc35e978709195c00e864b9a19fb41ad5c5c5b8a3e003813ae9727317097"  -H
          "Content-Type: application/json"  -H "Authorization: M2ZiZj……JhODA1"‍

          ```'
  /eth/v1/node/peers:
    get:
      operationId: get_eth_v1_node_peers
      tags:
      - Eth
      summary: GET /eth/v1/node/peers
      x-source: https://docs.blockrazor.io/streams/node-stream/ethereum/cl-el-client-sync.md
      parameters:
      - name: state
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -s \"http://127.0.0.1:${REST_PORT}/eth/v1/node/peers?state=connected\"  | jq --arg id \"$Relay_Peer_ID\" '.data[] | select(.peer_id\
          \ == $id) | {\n      peer_id,\n      state,\n      direction,\n      last_seen_p2p_address,\n      enr\n    }'\n```"
  /eth_sendRawTransaction:
    post:
      operationId: post_eth_sendRawTransaction
      tags:
      - Eth Sendrawtransaction
      summary: POST /eth_sendRawTransaction
      x-source: https://docs.blockrazor.io/transaction-submission/transaction-sending/base/eth_sendrawtransaction.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostEthSendrawtransactionRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST  -H \"Content-Type: application/json\"  -H \"Authorization: Bearer [TOKEN]\"  -d '{\n    \"jsonrpc\": \"2.0\",\n\
          \    \"method\": \"eth_sendRawTransaction\",\n    \"params\": [\n        \"0xf8668206bf831e988e825208940d287d6c8e5f8ad086f90d1933de060fdc578c2d808082422ea082d586bdef05fd6af532ca2943740f092cc5275731f175c0e0538a3e6a9b3c0ba060d2454b3b7679cc6c31ec70d6a8d926dcc40cf8cd4442776e018bd54787befb\"\
          \n    ],\n "
  /get-started/authentication.md:
    get:
      operationId: get_get_started_authentication_md
      tags:
      - Get Started
      summary: Get a BlockRazor Auth Token | API Authentication
      description: Perform an HTTP GET request on the URL with the `ask` and `goal` query parameters to retrieve a direct answer from the documentation.
      x-source: https://docs.blockrazor.io/get-started/authentication.md
      parameters:
      - name: ask
        in: query
        required: true
        schema:
          type: string
        description: The immediate question, specific and self‑contained.
      - name: goal
        in: query
        required: true
        schema:
          type: string
        description: The user’s overall goal, describing the desired outcome.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /health:
    post:
      operationId: post_health
      tags:
      - Health
      summary: Solana Send Bundle Rust Example
      x-source: https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-bundle/rust.md
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostHealthResponse'
      x-evidence:
        kind: documentation
  /sendBatch:
    post:
      operationId: post_sendBatch
      tags:
      - Sendbatch
      summary: Solana Send Batch API Reference
      x-source: https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-batch.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostSendbatchRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /sendBundle:
    post:
      operationId: post_sendBundle
      tags:
      - Sendbundle
      summary: Solana Send Bundle API Reference
      x-source: https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-bundle.md
      parameters:
      - name: transactions
        in: query
        required: true
        schema:
          type: array
        description: Fully signed transactions, Base64 encoding protocal
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostSendbundleRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /sendTransaction:
    post:
      operationId: post_sendTransaction
      tags:
      - Sendtransaction
      summary: Solana Send Transaction API
      x-source: https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-transaction.md
      parameters:
      - name: transaction
        in: query
        required: true
        schema:
          type: string
        description: Fully signed transactions, compatible with encoding protocal Base64 and Base58, with Base64 being recommended
      - name: mode
        in: query
        required: false
        schema:
          type: string
        description: 'BlockRazor offers two modes: Fast and SandwichMitigation, with Fast as the default.'
      - name: safeWindow
        in: query
        required: false
        schema:
          type: string
        description: safeWindow is used to determine the timing of transaction sending in sandwichMitigation mode and represents the number of
          consecutive slots of whitelist validators. Range 3-13, default 3.
      - name: revertProtection
        in: query
        required: false
        schema:
          type: string
        description: If set to true, the transaction will not fail on chain, but inclusion speed may be affected.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostSendtransactionRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /streams/block-stream/solana/geyser-stream/cli.md:
    get:
      operationId: get_streams_block_stream_solana_geyser_stream_cli_md
      tags:
      - Streams
      summary: Solana Geyser Stream CLI Example
      x-source: https://docs.blockrazor.io/streams/block-stream/solana/geyser-stream/cli.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /streams/node-stream/ethereum.md:
    get:
      operationId: get_streams_node_stream_ethereum_md
      tags:
      - Streams
      summary: 'Ethereum Node Stream: CL/EL client synchronization.'
      description: Perform an HTTP GET request on the URL with the `ask` and `goal` query parameters to retrieve a direct answer and relevant
        excerpts from the documentation.
      x-source: https://docs.blockrazor.io/streams/node-stream/ethereum.md
      parameters:
      - name: ask
        in: query
        required: false
        schema:
          type: string
        description: The immediate question, specific and self‑contained.
      - name: goal
        in: query
        required: false
        schema:
          type: string
        description: The user’s ultimate goal, providing context for a better answer.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /transaction-submission/block-builder.md:
    get:
      operationId: get_transaction_submission_block_builder_md
      tags:
      - Transaction Submission
      summary: BSC Block Builder APIs & Integration
      x-source: https://docs.blockrazor.io/transaction-submission/block-builder.md
      parameters:
      - name: ask
        in: query
        required: false
        schema:
          type: string
        description: The immediate question, specific and self‑contained.
      - name: goal
        in: query
        required: false
        schema:
          type: string
        description: The user’s ultimate goal, describing the desired outcome.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /transaction-submission/block-builder/endpoint.md:
    get:
      operationId: get_transaction_submission_block_builder_endpoint_md
      tags:
      - Transaction Submission
      summary: BSC Block Builder Endpoint
      description: Perform an HTTP GET request on the URL with the `ask` and `goal` query parameters to retrieve answers from the documentation.
      x-source: https://docs.blockrazor.io/transaction-submission/block-builder/endpoint.md
      parameters:
      - name: ask
        in: query
        required: false
        schema:
          type: string
        description: The immediate question, specific and self‑contained.
      - name: goal
        in: query
        required: false
        schema:
          type: string
        description: The user’s ultimate goal, describing the desired outcome.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /transaction-submission/rpc/bsc/bsc-rpc-endpoint.md:
    get:
      operationId: get_transaction_submission_rpc_bsc_bsc_rpc_endpoint_md
      tags:
      - Transaction Submission
      summary: BSC RPC Endpoint
      description: Retrieves the markdown documentation for the BSC RPC Endpoint, which lists general, dedicated, and regional endpoints for BlockRazor
        BSC RPC.
      x-source: https://docs.blockrazor.io/transaction-submission/rpc/bsc/bsc-rpc-endpoint.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /transaction-submission/rpc/ethereum/endpoint.md:
    get:
      operationId: get_transaction_submission_rpc_ethereum_endpoint_md
      tags:
      - Transaction Submission
      summary: Ethereum RPC Endpoint
      description: Perform an HTTP GET request on the documentation page with `ask` and `goal` query parameters to retrieve a direct answer and
        relevant excerpts from the documentation.
      x-source: https://docs.blockrazor.io/transaction-submission/rpc/ethereum/endpoint.md
      parameters:
      - name: ask
        in: query
        required: true
        schema:
          type: string
        description: The immediate question to ask the documentation.
      - name: goal
        in: query
        required: true
        schema:
          type: string
        description: The broader goal the user wants to achieve.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /transaction-submission/transaction-sending.md:
    get:
      operationId: get_transaction_submission_transaction_sending_md
      tags:
      - Transaction Submission
      summary: Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters
      description: The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
      x-source: https://docs.blockrazor.io/transaction-submission/transaction-sending.md
      parameters:
      - name: ask
        in: query
        required: true
        schema:
          type: string
        description: 'The immediate question: it should be specific, self-contained, and written in natural language.'
      - name: goal
        in: query
        required: true
        schema:
          type: string
        description: The user’s ultimate goal, describing the outcome they want to achieve.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /transaction-submission/transaction-sending/base.md:
    get:
      operationId: get_transaction_submission_transaction_sending_base_md
      tags:
      - Transaction Submission
      summary: Base Transaction Sending API Integration
      description: Perform an HTTP GET request on the URL with the `ask` and `goal` query parameters to retrieve a direct answer and relevant
        excerpts from the documentation.
      x-source: https://docs.blockrazor.io/transaction-submission/transaction-sending/base.md
      parameters:
      - name: ask
        in: query
        required: false
        schema:
          type: string
        description: The immediate question, specific and self‑contained.
      - name: goal
        in: query
        required: false
        schema:
          type: string
        description: The user’s ultimate goal, describing the desired outcome.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /transaction-submission/transaction-sending/robinhood-chain/endpoint.md:
    get:
      operationId: get_transaction_submission_transaction_sending_robinhood_chain_endpoint_md
      tags:
      - Transaction Submission
      summary: Robinhood Chain Transaction Sending Endpoint
      x-source: https://docs.blockrazor.io/transaction-submission/transaction-sending/robinhood-chain/endpoint.md
      parameters:
      - name: ask
        in: query
        required: false
        schema:
          type: string
        description: The immediate question, specific and self‑contained.
      - name: goal
        in: query
        required: false
        schema:
          type: string
        description: The user’s ultimate goal, describing the desired outcome.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /transaction-submission/transaction-sending/solana.md:
    get:
      operationId: get_transaction_submission_transaction_sending_solana_md
      tags:
      - Transaction Submission
      summary: Explore the endpoints, API access documentation, Priority Fee & Tips, and Keep Alive for BlockRazor Solana Transaction Sending
        mode.
      x-source: https://docs.blockrazor.io/transaction-submission/transaction-sending/solana.md
      parameters:
      - name: ask
        in: query
        required: false
        schema:
          type: string
        description: The immediate question; specific, self‑contained, natural language.
      - name: goal
        in: query
        required: false
        schema:
          type: string
        description: The user’s ultimate goal, describing the desired outcome.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /transaction-submission/transaction-sending/solana/send-bundle/curl.md:
    get:
      operationId: get_transaction_submission_transaction_sending_solana_send_bundle_curl_md
      tags:
      - Transaction Submission
      summary: Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters
      description: The GET request returns a direct answer to the question along with relevant excerpts and sources from the documentation.
      x-source: https://docs.blockrazor.io/transaction-submission/transaction-sending/solana/send-bundle/curl.md
      parameters:
      - name: ask
        in: query
        required: true
        schema:
          type: string
        description: The immediate question, specific and self‑contained.
      - name: goal
        in: query
        required: true
        schema:
          type: string
        description: The ultimate goal of the user, describing the desired outcome.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostRequest:
      type: object
      properties:
        id:
          type: integer
        jsonrpc:
          type: string
        method:
          type: string
        params:
          type: array
          items:
            type: object
            properties:
              Txs:
                type: array
                items:
                  type: string
              revertingTxHashes:
                type: array
                items: {}
              maxBlockNumber:
                type: integer
    PostResponse:
      type: object
      properties:
        jsonrpc:
          type: string
        id:
          type: integer
        result:
          type: string
    GetBundlestateResponse:
      type: object
      properties:
        bundle:
          type: object
          properties:
            timestamp:
              type: string
              format: date-time
            bundleHash:
              type: string
            state:
              type: string
            blockNumber:
              type: integer
            priority:
              type: string
    PostEthSendrawtransactionRequest:
      type: object
      properties:
        jsonrpc:
          type: string
        method:
          type: string
        params:
          type: array
          items:
            type: string
        id:
          type: integer
    PostHealthResponse:
      type: object
      properties:
        result:
          type: string
    PostSendbatchRequest:
      type: object
      properties:
        transactions:
          type: array
          description: Signed transactions, Base64 encoded, maximum 25 transactions
        mode:
          type: string
          description: 'BlockRazor offers two modes: Fast and SandwichMitigation, with Fast as the default.'
        safeWindow:
          type: integer
          description: Determines timing of transaction sending in sandwichMitigation mode; range 3-13, default 3.
        revertProtection:
          type: boolean
          description: If true, the transaction will not fail on chain but may affect inclusion speed.
      required:
      - transactions
    PostSendbundleRequest:
      type: object
      properties:
        transactions:
          type: string
          description: Fully signed transactions, Base64 encoding protocal
      required:
      - transactions
    PostSendtransactionRequest:
      type: object
      properties:
        transaction:
          type: string
          description: Fully signed transaction (Base64 or Base58).
        mode:
          type: string
          description: fast or sandwichMitigation.
        safeWindow:
          type: integer
          description: Number of consecutive whitelist slots (3‑13).
        revertProtection:
          type: boolean
          description: Enable revert protection.
      required:
      - transaction
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
security:
- apiKey: []
tags:
- name: Api
- name: Blockrazorinc
- name: Bundlestate
- name: Eth
- name: Eth Sendrawtransaction
- name: Get Started
- name: Health
- name: Sendbatch
- name: Sendbundle
- name: Sendtransaction
- name: Streams
- name: Transaction Submission