Chainstack Plasma Node API

Chainstack-managed Plasma JSON-RPC nodes (stablecoin-optimized chain).

OpenAPI Specification

chainstack-plasma-node-api-openapi.yml Raw ↑
openapi: 3.0.3
info:
  title: Chainstack Plasma Node API
  version: 1.0.0
  description: Chainstack-managed RPC node API for the Plasma blockchain. Endpoints follow the canonical JSON-RPC over HTTPS
    interface for the network. Authenticate against your Chainstack node's per-node URL (e.g. https://nd-XXX-XXX-XXX.p2pify.com/<key>).
    Merged from the Chainstack Developer Portal per-method fragments at https://github.com/chainstack/dev-portal/tree/main/openapi/plasma_node_api.
  contact:
    name: Chainstack API Support
    email: [email protected]
  license:
    name: Chainstack Terms
    url: https://chainstack.com/terms-of-service/
servers:
- url: https://{node_id}.p2pify.com/{api_key}
  description: Chainstack-managed node endpoint
  variables:
    node_id:
      default: nd-000-000-000
      description: Your Chainstack node identifier
    api_key:
      default: <api-key>
      description: Per-node access key
tags:
- name: Accounts Info
- name: Blocks Info
- name: Chain Info
- name: Client Info
- name: Debug And Trace
- name: Execute Transactions
- name: Filter Handling
- name: Gas Data
- name: Logs And Events
- name: Transaction Info
paths:
  /eth_getAccount:
    post:
      tags:
      - Accounts Info
      summary: eth_getAccount
      operationId: getAccount
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getAccount
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Address
                      description: The address of the account.
                    - type: string
                      title: Block
                      description: Block number or tag (latest, earliest, pending).
                  default:
                  - '0x0000000000000000000000000000000000000000'
                  - latest
      responses:
        '200':
          description: Returns the account information for a given address.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getBalance:
    post:
      tags:
      - Accounts Info
      summary: eth_getBalance
      operationId: getBalance
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getBalance
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Address
                      description: The address to check for balance.
                    - type: string
                      title: Block
                      description: Block number or tag (latest, earliest, pending).
                  default:
                  - '0x0000000000000000000000000000000000000000'
                  - latest
      responses:
        '200':
          description: Returns the balance of the account of given address.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getCode:
    post:
      tags:
      - Accounts Info
      summary: eth_getCode
      operationId: getCode
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getCode
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Address
                      description: The address to get the code from.
                    - type: string
                      title: Block
                      description: Block number or tag (latest, earliest, pending).
                  default:
                  - '0x0000000000000000000000000000000000000000'
                  - latest
      responses:
        '200':
          description: Returns code at a given address.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getProof:
    post:
      tags:
      - Accounts Info
      summary: eth_getProof
      operationId: getProof
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getProof
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Address
                      description: The address of the account.
                    - type: array
                      title: Storage keys
                      description: Array of storage keys to be proven.
                    - type: string
                      title: Block
                      description: Block number or tag (latest, earliest, pending).
                  default:
                  - '0x0000000000000000000000000000000000000000'
                  - []
                  - latest
      responses:
        '200':
          description: Returns the account and storage values of the specified account including the Merkle-proof.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getStorageAt:
    post:
      tags:
      - Accounts Info
      summary: eth_getStorageAt
      operationId: getStorageAt
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getStorageAt
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Address
                      description: The address to get storage from.
                    - type: string
                      title: Position
                      description: Integer position in the storage.
                    - type: string
                      title: Block
                      description: Block number or tag (latest, earliest, pending).
                  default:
                  - '0x0000000000000000000000000000000000000000'
                  - '0x0'
                  - latest
      responses:
        '200':
          description: Returns the value from a storage position at a given address.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getTransactionCount:
    post:
      tags:
      - Accounts Info
      summary: eth_getTransactionCount
      operationId: getTransactionCount
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getTransactionCount
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Address
                      description: The address to get the transaction count from.
                    - type: string
                      title: Block
                      description: Block number or tag (latest, earliest, pending).
                  default:
                  - '0x0000000000000000000000000000000000000000'
                  - latest
      responses:
        '200':
          description: Returns the number of transactions sent from an address.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_blockNumber:
    post:
      tags:
      - Blocks Info
      summary: eth_blockNumber
      operationId: blockNumber
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_blockNumber
                params:
                  type: array
                  items: {}
                  default: []
      responses:
        '200':
          description: Returns the number of most recent block.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getBlockByHash:
    post:
      tags:
      - Blocks Info
      summary: eth_getBlockByHash
      operationId: getBlockByHash
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getBlockByHash
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Block hash
                      description: Hash of the block.
                    - type: boolean
                      title: Show transaction details
                      description: If true, returns full transaction objects. If false, returns only hashes.
                  default:
                  - '0x0000000000000000000000000000000000000000000000000000000000000000'
                  - false
      responses:
        '200':
          description: Returns information about a block by hash.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getBlockByNumber:
    post:
      tags:
      - Blocks Info
      summary: eth_getBlockByNumber
      operationId: getBlockByNumber
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getBlockByNumber
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Block
                      description: Block number or tag (latest, earliest, pending).
                    - type: boolean
                      title: Show transaction details
                      description: If true, returns full transaction objects. If false, returns only hashes.
                  default:
                  - latest
                  - false
      responses:
        '200':
          description: Returns information about a block by block number.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getBlockReceipts:
    post:
      tags:
      - Blocks Info
      summary: eth_getBlockReceipts
      operationId: getBlockReceipts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getBlockReceipts
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Block
                      description: Block number or tag (latest, earliest, pending).
                  default:
                  - latest
      responses:
        '200':
          description: Returns all transaction receipts for a given block.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getBlockTransactionCountByHash:
    post:
      tags:
      - Blocks Info
      summary: eth_getBlockTransactionCountByHash
      operationId: getBlockTransactionCountByHash
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getBlockTransactionCountByHash
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Block hash
                      description: Hash of the block.
                  default:
                  - '0x0000000000000000000000000000000000000000000000000000000000000000'
      responses:
        '200':
          description: Returns the number of transactions in a block from a block matching the given block hash.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getBlockTransactionCountByNumber:
    post:
      tags:
      - Blocks Info
      summary: eth_getBlockTransactionCountByNumber
      operationId: getBlockTransactionCountByNumber
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getBlockTransactionCountByNumber
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Block
                      description: Block number or tag (latest, earliest, pending).
                  default:
                  - latest
      responses:
        '200':
          description: Returns the number of transactions in a block from a block matching the given block number.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getHeaderByHash:
    post:
      tags:
      - Blocks Info
      summary: eth_getHeaderByHash
      operationId: getHeaderByHash
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getHeaderByHash
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Block hash
                      description: Hash of the block.
                  default:
                  - '0x0000000000000000000000000000000000000000000000000000000000000000'
      responses:
        '200':
          description: Returns the block header by block hash.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getHeaderByNumber:
    post:
      tags:
      - Blocks Info
      summary: eth_getHeaderByNumber
      operationId: getHeaderByNumber
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getHeaderByNumber
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Block
                      description: Block number or tag (latest, earliest, pending).
                  default:
                  - latest
      responses:
        '200':
          description: Returns the block header by block number.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getUncleByBlockHashAndIndex:
    post:
      tags:
      - Blocks Info
      summary: eth_getUncleByBlockHashAndIndex
      operationId: getUncleByBlockHashAndIndex
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getUncleByBlockHashAndIndex
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Block hash
                      description: Hash of the block.
                    - type: string
                      title: Uncle index
                      description: The uncle index position.
                  default:
                  - '0x0000000000000000000000000000000000000000000000000000000000000000'
                  - '0x0'
      responses:
        '200':
          description: Returns information about an uncle by block hash and uncle index position.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getUncleByBlockNumberAndIndex:
    post:
      tags:
      - Blocks Info
      summary: eth_getUncleByBlockNumberAndIndex
      operationId: getUncleByBlockNumberAndIndex
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getUncleByBlockNumberAndIndex
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Block
                      description: Block number or tag (latest, earliest, pending).
                    - type: string
                      title: Uncle index
                      description: The uncle index position.
                  default:
                  - latest
                  - '0x0'
      responses:
        '200':
          description: Returns information about an uncle by block number and uncle index position.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getUncleCountByBlockHash:
    post:
      tags:
      - Blocks Info
      summary: eth_getUncleCountByBlockHash
      operationId: getUncleCountByBlockHash
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getUncleCountByBlockHash
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Block hash
                      description: Hash of the block.
                  default:
                  - '0x0000000000000000000000000000000000000000000000000000000000000000'
      responses:
        '200':
          description: Returns the number of uncles in a block from a block matching the given block hash.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_getUncleCountByBlockNumber:
    post:
      tags:
      - Blocks Info
      summary: eth_getUncleCountByBlockNumber
      operationId: getUncleCountByBlockNumber
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_getUncleCountByBlockNumber
                params:
                  type: array
                  items:
                    anyOf:
                    - type: string
                      title: Block
                      description: Block number or tag (latest, earliest, pending).
                  default:
                  - latest
      responses:
        '200':
          description: Returns the number of uncles in a block from a block matching the given block number.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_accounts:
    post:
      tags:
      - Chain Info
      summary: Eth_Accounts
      operationId: accounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_accounts
                params:
                  type: array
                  items: {}
                  default: []
      responses:
        '200':
          description: Returns a list of addresses owned by the client.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_chainId:
    post:
      tags:
      - Chain Info
      summary: eth_chainId
      operationId: chainId
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_chainId
                params:
                  type: array
                  items: {}
                  default: []
      responses:
        '200':
          description: Returns the chain ID of the current network.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_hashrate:
    post:
      tags:
      - Chain Info
      summary: Eth_Hashrate
      operationId: hashrate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_hashrate
                params:
                  type: array
                  items: {}
                  default: []
      responses:
        '200':
          description: Returns the number of hashes per second that the node is mining with.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_protocolVersion:
    post:
      tags:
      - Chain Info
      summary: eth_protocolVersion
      operationId: protocolVersion
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_protocolVersion
                params:
                  type: array
                  items: {}
                  default: []
      responses:
        '200':
          description: Returns the current Ethereum protocol version.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type: integer
                  result:
                    type: object
                    nullable: true
  /eth_syncing:
    post:
      tags:
      - Chain Info
      summary: Eth_Syncing
      operationId: syncing
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: integer
                  default: 1
                jsonrpc:
                  type: string
                  default: '2.0'
                method:
                  type: string
                  default: eth_syncing
                para

# --- truncated at 32 KB (81 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/chainstack/refs/heads/main/openapi/chainstack-plasma-node-api-openapi.yml