Supra Accounts API

openapi: 3.2.0
info:
  title: Supra RPC Node Accounts API
  description: '0.5.0

    tag:supra_rpc_v11.5.2

    commit_hash:5e9ea652

    build_time:2026-08-25 08:38:29 +00:00

    build_env:rustc 1.97.1 (8bab26f4f 2026-07-14),1.97.1-x86_64-unknown-linux-gnu'
  contact:
    name: Supra Labs
    url: https://supra.com
  version: 5e9ea652457cd48aba6b1505bdd59da27fec13f6
servers:
- url: /
tags:
- name: Accounts
  description: Accounts Api
paths:
  /rpc/v2/accounts/{address}:
    get:
      tags:
      - Accounts
      summary: Get account (v2)
      description: '# Response

        - `auth_key` — The authentication key used for validating transactions.

        - `sequence_number` — The current expected sequence number of the account.'
      operationId: get_account_v2
      parameters:
      - name: address
        in: path
        description: Address of account with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      responses:
        '200':
          description: Account information retrieved successfully
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountData'
      deprecated: true
  /rpc/v2/accounts/{address}/coin_transactions:
    get:
      tags:
      - Accounts
      summary: Get coin transactions (v2)
      description: 'List of finalized coin withdraw/deposit transactions relevant to the move account. Return max 100 transactions per request.

        It includes both transactions sent from and received by the account.'
      operationId: coin_transactions_v2
      parameters:
      - name: address
        in: path
        description: Address of account with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      - name: count
        in: query
        description: Maximum number of items to return. Default is 20.
        required: false
        schema:
          type: integer
          minimum: 0
        style: form
      - name: start
        in: query
        description: 'The cursor that the search should start from. The cursor for a given transaction can be derived by adding

          its index (where indexes start from zero) in the block in which it became finalized to the timestamp of the

          block.


          During a paginated query, the cursor returned in the previous page should be used as the starting cursor of the next page.


          If provided, return `:count` of transactions starting from this cursor in ascending order.

          If not provided, return `:count` of most recent transactions in descending order.'
        required: false
        schema:
          type: integer
          format: u-int64
          minimum: 0
        style: form
      responses:
        '200':
          description: List of *finalized* transactions sent from and received by the move account.
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountCoinStatementV2'
      deprecated: true
  /rpc/v2/accounts/{address}/modules:
    get:
      tags:
      - Accounts
      summary: Get account modules (v2)
      description: Retrieves all account modules' bytecode for a given account.
      operationId: get_account_modules_v2
      parameters:
      - name: address
        in: path
        description: Address of account with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      - name: count
        in: query
        description: Maximum number of items to return. Default is 20.
        required: false
        schema:
          type: integer
          minimum: 0
        style: form
      - name: start
        in: query
        description: 'Cursor specifying where to start for pagination.

          Use the cursor returned by the API when making the next request.'
        required: false
        schema:
          type: string
        style: form
      responses:
        '200':
          description: account module list
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MoveModuleListV2'
      deprecated: true
  /rpc/v2/accounts/{address}/modules/{module_name}:
    get:
      tags:
      - Accounts
      summary: Get account module (v2)
      description: Retrieves an individual module from a given account.
      operationId: get_account_module_v2
      parameters:
      - name: address
        in: path
        description: Address of account with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      - name: module_name
        in: path
        description: Name of module to retrieve e.g. coin
        required: true
        schema:
          type: string
      responses:
        '200':
          description: View account module by Move module name
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MoveModuleBytecode'
      deprecated: true
  /rpc/v2/accounts/{address}/resources:
    get:
      tags:
      - Accounts
      summary: Get account resources (v2)
      description: Get account resources by address
      operationId: get_account_resources_v2
      parameters:
      - name: address
        in: path
        description: Address of account with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      - name: count
        in: query
        description: Maximum number of items to return. Default is 20.
        required: false
        schema:
          type: integer
          minimum: 0
        style: form
      - name: start
        in: query
        description: 'Cursor specifying where to start for pagination.

          Use the cursor returned by the API when making the next request.'
        required: false
        schema:
          type: string
        style: form
      responses:
        '200':
          description: Account resource list
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MoveResourcesResponse'
      deprecated: true
  /rpc/v2/accounts/{address}/resources/{resource_type}:
    get:
      tags:
      - Accounts
      summary: Get account resource (v2)
      description: View account resource by Move type
      operationId: get_account_resource_v2
      parameters:
      - name: address
        in: path
        description: Address of account with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      - name: resource_type
        in: path
        description: Name of struct to retrieve e.g. `0x1::account::Account`
        required: true
        schema:
          type: string
          pattern: ^0x[0-9a-zA-Z:_<>]+$
        example: 0x1::coin::CoinStore<0x1::supra_coin::SupraCoin>
      responses:
        '200':
          description: View account resource by Move Struct type
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MoveResource'
      deprecated: true
  /rpc/v2/accounts/{address}/transactions:
    get:
      tags:
      - Accounts
      summary: Get account transactions (v2)
      description: List of finalized transactions sent by the move account. Return max 100 transactions per request.
      operationId: get_account_transactions_v2
      parameters:
      - name: address
        in: path
        description: Address of account with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      - name: count
        in: query
        description: Maximum number of items to return. Default is 20.
        required: false
        schema:
          type: integer
          minimum: 0
        style: form
      - name: start
        in: query
        description: 'Starting sequence number.

          If provided, return `:count` of transactions starting from this sequence number in ascending order.

          If not provided, return `:count` of most recent transactions in descending order.'
        required: false
        schema:
          type: integer
          format: u-int64
          minimum: 0
        style: form
      responses:
        '200':
          description: List of transactions from the move account.
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountStatementV2'
      deprecated: true
  /rpc/v3/accounts/{address}:
    get:
      tags:
      - Accounts
      summary: Get account (v3)
      description: '# Response

        - `auth_key` — The authentication key used for validating transactions.

        - `sequence_number` — The current expected sequence number of the account.'
      operationId: get_account_v3
      parameters:
      - name: address
        in: path
        description: Address of account with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      responses:
        '200':
          description: Account information retrieved successfully
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountData'
            application/x-bcs:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
            application/octet-stream:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
  /rpc/v3/accounts/{address}/automated_transactions:
    get:
      tags:
      - Accounts
      summary: Get account auto-transaction (v3)
      description: 'List of finalized automated transactions based on the automation tasks registered by the move account.

        Return max 100 transactions per request.'
      operationId: statement_automated_v3
      parameters:
      - name: address
        in: path
        description: Address of account with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      - name: count
        in: query
        description: Maximum number of items to return. Default is 20.
        required: false
        schema:
          type: integer
          minimum: 0
        style: form
      - name: block_height
        in: query
        description: 'Starting block height (inclusive). Optional.


          The block height at which to start lookup for transactions.

          If provided, returns `:count` of transactions starting from it in the specified order.

          For order see `:ascending` flag.


          Note: If a `:cursor` is specified then this field will be ignored.'
        required: false
        schema:
          type: integer
          format: u-int64
          minimum: 0
        style: form
      - name: cursor
        in: query
        description: 'The cursor (exclusive) to start the query from. Optional.


          If provided, returns `:count` of transactions starting from this cursor in the specified order.

          For order see `:ascending` flag.


          If not specified, the lookup will be done based on the `:block_height` parameter value.

          Note: If both `:cursor` and `:block_height` are specified then `:cursor` has precedence.'
        required: false
        schema:
          type: string
        style: form
      - name: ascending
        in: query
        description: 'Flag indicating order of lookup.


          Defaults to `false`; i.e. transactions are returned in descending order of their execution.

          If `true`, transactions are returned in ascending order of their execution.'
        required: false
        schema:
          type: boolean
        style: form
      responses:
        '200':
          description: List of automated transactions of the move account.
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
            x-supra-cursor:
              schema:
                type: string
              description: Cursor specifying where to start for pagination. This cursor cannot be derived manually client-side. Instead, you must call this endpoint once without this query parameter specified, and then use the cursor returned in the x-supra-cursor header in the response.
            x-supra-oldest-block:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Height of the oldest available block. Absent until the archive has indexed at least one block.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountStatementV3'
            application/x-bcs:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
            application/octet-stream:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
        '503':
          description: The archive is still initializing. No executed blocks are available yet. Please retry.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrResp'
  /rpc/v3/accounts/{address}/coin_transactions:
    get:
      tags:
      - Accounts
      summary: Get coin transactions (v3)
      description: List of finalized coin withdraw/deposit transactions relevant to the move account. Return max 100 transactions per request.
      operationId: coin_transactions_v3
      parameters:
      - name: address
        in: path
        description: Address of account with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      - name: count
        in: query
        description: Maximum number of items to return. Default is 20.
        required: false
        schema:
          type: integer
          minimum: 0
        style: form
      - name: start
        in: query
        description: 'The cursor (exclusive) that the search should start from.


          If provided, returns `:count` of transactions starting from this cursor in the specified order.


          For order see `:ascending` flag.'
        required: false
        schema:
          type: integer
          format: u-int64
          minimum: 0
        style: form
      - name: ascending
        in: query
        description: 'Flag indicating order of lookup.


          Defaults to `false` i.e. transactions are returned in descending order of their execution.

          If `true`, transactions are returned in ascending order of their execution.'
        required: false
        schema:
          type: boolean
        style: form
      - name: type
        in: query
        description: Transaction type to query. If missing any/all type of transactions will be looked for.
        required: false
        schema:
          type: string
          description: Type of the transaction to be queried.
          enum:
          - auto
          - user
          - meta
          - record
      responses:
        '200':
          description: List of *finalized* transactions sent from and received by the move account.
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
            x-supra-cursor:
              schema:
                type: string
              description: Cursor specifying where to start for pagination. This cursor cannot be derived manually client-side. Instead, you must call this endpoint once without this query parameter specified, and then use the cursor returned in the x-supra-cursor header in the response.
            x-supra-oldest-block:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Height of the oldest available block. Absent until the archive has indexed at least one block.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountStatementV3'
            application/x-bcs:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
            application/octet-stream:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
        '503':
          description: The archive is still initializing. No executed blocks are available yet. Please retry.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrResp'
  /rpc/v3/accounts/{address}/fa_transactions:
    get:
      tags:
      - Accounts
      summary: Get Fungible Asset transactions (v3)
      description: List of finalized Fungible Asset withdraw/deposit transactions relevant to the given Fungible Store address. Returns at most 100 transactions per request.
      operationId: fa_transactions_v3
      parameters:
      - name: address
        in: path
        description: Fungible Store address with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      - name: count
        in: query
        description: Maximum number of items to return. Default is 20.
        required: false
        schema:
          type: integer
          minimum: 0
        style: form
      - name: start
        in: query
        description: 'The cursor (exclusive) that the search should start from.


          If provided, returns `:count` of transactions starting from this cursor in the specified order.


          For order see `:ascending` flag.'
        required: false
        schema:
          type: integer
          format: u-int64
          minimum: 0
        style: form
      - name: ascending
        in: query
        description: 'Flag indicating order of lookup.


          Defaults to `false` i.e. transactions are returned in descending order of their execution.

          If `true`, transactions are returned in ascending order of their execution.'
        required: false
        schema:
          type: boolean
        style: form
      - name: type
        in: query
        description: Transaction type to query. If missing any/all type of transactions will be looked for.
        required: false
        schema:
          type: string
          description: Type of the transaction to be queried.
          enum:
          - auto
          - user
          - meta
          - record
      responses:
        '200':
          description: List of *finalized* Fungible Asset transactions associated with the given Fungible Store address.
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
            x-supra-cursor:
              schema:
                type: string
              description: Cursor specifying where to start for pagination. This cursor cannot be derived manually client-side. Instead, you must call this endpoint once without this query parameter specified, and then use the cursor returned in the x-supra-cursor header in the response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountStatementV3'
            application/x-bcs:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
            application/octet-stream:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
  /rpc/v3/accounts/{address}/modules:
    get:
      tags:
      - Accounts
      summary: Get account modules (v3)
      description: Retrieves all account modules' bytecode for a given account.
      operationId: get_account_modules_v3
      parameters:
      - name: address
        in: path
        description: Address of account with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      - name: count
        in: query
        description: Maximum number of items to return. Default is 20.
        required: false
        schema:
          type: integer
          minimum: 0
        style: form
      - name: start
        in: query
        description: 'Cursor specifying where to start for pagination.

          Use the cursor returned by the API when making the next request.'
        required: false
        schema:
          type: string
        style: form
      responses:
        '200':
          description: Account module list
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
            x-supra-cursor:
              schema:
                type: string
              description: Cursor specifying where to start for pagination. This cursor cannot be derived manually client-side. Instead, you must call this endpoint once without this query parameter specified, and then use the cursor returned in the x-supra-cursor header in the response.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MoveModuleBytecode'
            application/x-bcs:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
            application/octet-stream:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
  /rpc/v3/accounts/{address}/modules/{module_name}:
    get:
      tags:
      - Accounts
      summary: Get account module (v3)
      description: Retrieves an individual module from a given account.
      operationId: get_account_module_v3
      parameters:
      - name: address
        in: path
        description: Address of account with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      - name: module_name
        in: path
        description: Name of module to retrieve e.g. coin
        required: true
        schema:
          type: string
      responses:
        '200':
          description: View account module by Move module name
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MoveModuleBytecode'
            application/x-bcs:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
            application/octet-stream:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
  /rpc/v3/accounts/{address}/resources:
    get:
      tags:
      - Accounts
      summary: Get account resources (v3)
      description: Retrieves all account resources for a given account.
      operationId: get_account_resources_v3
      parameters:
      - name: address
        in: path
        description: Address of account with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      - name: count
        in: query
        description: Maximum number of items to return. Default is 20.
        required: false
        schema:
          type: integer
          minimum: 0
        style: form
      - name: start
        in: query
        description: 'Cursor specifying where to start for pagination.

          Use the cursor returned by the API when making the next request.'
        required: false
        schema:
          type: string
        style: form
      responses:
        '200':
          description: Account resource list
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
            x-supra-cursor:
              schema:
                type: string
              description: Cursor specifying where to start for pagination. This cursor cannot be derived manually client-side. Instead, you must call this endpoint once without this query parameter specified, and then use the cursor returned in the x-supra-cursor header in the response.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MoveResource'
            application/x-bcs:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
            application/octet-stream:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
  /rpc/v3/accounts/{address}/resources/{resource_type}:
    get:
      tags:
      - Accounts
      summary: Get account resource (v3)
      description: View account resource by Move type
      operationId: get_account_resource_v3
      parameters:
      - name: address
        in: path
        description: Address of account with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      - name: resource_type
        in: path
        description: Name of struct to retrieve e.g. `0x1::account::Account`
        required: true
        schema:
          type: string
          pattern: ^0x[0-9a-zA-Z:_<>]+$
        example: 0x1::coin::CoinStore<0x1::supra_coin::SupraCoin>
      responses:
        '200':
          description: View account resource by Move Struct type
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MoveResource'
            application/x-bcs:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
            application/octet-stream:
              schema:
                type: array
                items:
                  type: integer
                  format: u-int8
                  minimum: 0
  /rpc/v3/accounts/{address}/transactions:
    get:
      tags:
      - Accounts
      summary: Get account transactions (v3)
      description: List of finalized transactions sent by the move account. Return max 100 transactions per request.
      operationId: get_account_transactions_v3
      parameters:
      - name: address
        in: path
        description: Address of account with or without a 0x prefix
        required: true
        schema:
          type: string
        example: '0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1'
      - name: count
        in: query
        description: Maximum number of items to return. Default is 20.
        required: false
        schema:
          type: integer
          minimum: 0
        style: form
      - name: start
        in: query
        description: 'Starting sequence number.


          If provided, return `:count` of transactions starting from this sequence number (inclusive)

          in the specified order.


          For order see `:ascending` flag.'
        required: false
        schema:
          type: integer
          format: u-int64
          minimum: 0
        style: form
      - name: ascending
        in: query
        description: 'Flag indicating order of lookup.


          Defaults to `false`; i.e. the transactions are returned in descending order by sequence number.

          If `true`, transactions are returned in ascending order by sequence number.'
        required: false
        schema:
          type: boolean
        style: form
      responses:
        '200':
          description: List of transactions from the move account.
          headers:
            x-supra-chain-id:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              description: Chain ID of the current chain.
            x-supra-oldest-block:
              schema:
                type: integer
                format: u-int8
                minimum: 0
              descri

# --- truncated at 32 KB (47 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/supra/refs/heads/main/openapi/supra-accounts-api-openapi.yml