Read and observation surface for Supra's native on-chain automation (AutoFi) registry. Automation tasks are registered and cancelled through the Supra CLI and Move entry functions rather than an HTTP write endpoint; execution is observed through the node RPC using the automated_transactions account endpoint and the type=auto block filter, and registry state is read through Move view functions.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/supra-automation-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
openapi: 3.1.0
info:
title: Supra RPC Node
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: /
paths:
/rpc/v1/transactions/chain_id:
get:
tags:
- Transactions
summary: Chain id (v1)
description: Fetch chain id
operationId: chain_id
responses:
'200':
description: Current chain id
headers:
x-supra-chain-id:
schema:
type: integer
format: u-int8
minimum: 0
description: Chain ID of the current chain.
content:
application/json:
schema:
type: integer
format: u-int8
minimum: 0
/rpc/v1/transactions/parameters:
get:
tags:
- Transactions
summary: Transaction parameters (v1)
description: Retrieve limits that a client must respect when composing a transaction.
operationId: transaction_parameter
responses:
'200':
description: Acceptable parameters for transaction submission
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/TransactionParameters'
/rpc/v1/transactions/submit:
post:
tags:
- Transactions
summary: Submit transaction (v1)
description: Submit a transaction to Supra.
operationId: submit_txn
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SupraTransaction'
required: true
responses:
'200':
description: transaction submitted
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/Hash'
deprecated: true
/rpc/v1/wallet/faucet/transactions/{hash}:
get:
tags:
- Faucet
summary: Faucet transaction (v1)
description: Get information about a faucet transaction by its hash.
operationId: faucet_transaction_by_hash_v1
parameters:
- name: hash
in: path
description: Hash of the faucet transaction to lookup
required: true
schema:
type: string
responses:
'200':
description: Faucet transaction data of the given transaction hash
headers:
x-supra-chain-id:
schema:
type: integer
format: u-int8
minimum: 0
description: Chain ID of the current chain.
content:
application/json:
schema:
oneOf:
- type: 'null'
- $ref: '#/components/schemas/TransactionInfoV1'
deprecated: true
/rpc/v1/wallet/faucet/{address}:
get:
tags:
- Faucet
summary: Faucet (v1)
description: funds account with [FUND_AMOUNT] coins
operationId: faucet_v1
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: list of associated transactions created
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/FaucetStatus'
/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/v2/block:
get:
tags:
- Block
summary: Get the latest block (v2)
description: Get the header of the most recently finalized block.
operationId: latest_block_v2
responses:
'200':
description: Returns the header of the most recently finalized block.
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/BlockHeaderInfo'
deprecated: true
/rpc/v2/block/height/{height}:
get:
tags:
- Block
summary: Get block by height (v2)
description: Get information about the block that has been finalized at the given height.
operationId: block_by_height_v2
parameters:
- name: height
in: path
description: Block height
required: true
schema:
type: integer
format: u-int64
minimum: 0
- name: with_finalized_transactions
in: query
description: 'If true, returns all transactions that were finalized by this block in the order that they
were executed.'
required: false
schema:
type: boolean
responses:
'200':
description: Information about the block that has been finalized at the given height.
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/Block'
'404':
description: Requested data is not available.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrResp'
'410':
description: Requested data has been pruned and is no longer available.
headers:
x-supra-oldest-block:
schema:
type: integer
format: u-int8
minimum: 0
description: Height of the oldest available block.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrResp'
deprecated: true
/rpc/v2/block/{block_hash}:
get:
tags:
- Block
summary: Get block by hash (v2)
description: Get the header of the block with the given hash.
operationId: block_header_info_v2
parameters:
- name: block_hash
in: path
description: Hex encoded block hash
required: true
schema:
type: string
responses:
'200':
description: The header of the block with the given hash.
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/BlockHeaderInfo'
deprecated: true
/rpc/v2/consensus/block:
get:
tags:
- Consensus
summary: Get latest consensus block (v2)
description: 'Get the BCS bytes of the latest consensus block.
Returns an HTTP response containing the BCS bytes of the requested ConsensusBlock, optionally
including the BCS bytes of the associated transaction batches.
- If the block is found, responds with [StatusCode::OK] and a binary body containing the serialized block data.
- If the block is not found, responds with [StatusCode::NOT_FOUND] and an empty body.'
operationId: latest_consensus_block_v2
responses:
'200':
description: Binary representation of the latest consensus block.
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/BinaryData'
'404':
description: No block found.
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/BinaryData'
deprecated: true
/rpc/v2/consensus/block/height/{height}:
get:
tags:
- Consensus
summary: Get consensus block by height (v2)
description: 'Get the BCS bytes of the consensus block at the requested height.
Returns an HTTP response containing the BCS bytes of the requested ConsensusBlock, optionally
including the BCS bytes of the associated transaction batches.
- If the block is found, responds with [StatusCode::OK] and a binary body containing the serialized block data.
- If the block is not found, responds with [StatusCode::NOT_FOUND] and an empty body.'
operationId: consensus_block_v2
parameters:
- name: height
in: path
description: Block height
required: true
schema:
type: integer
format: u-int64
minimum: 0
- name: with_batches
in: query
description: If true, returns all batches of transactions with certificates contained in this block.
required: true
schema:
type: boolean
responses:
'200':
description: Binary representation of the consensus block at the requested height.
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/BinaryData'
'404':
description: No block for for the requested height.
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/BinaryData'
deprecated: true
/rpc/v2/consensus/committee_authorization/{epoch}:
get:
tags:
- Consensus
summary: Get committee authorization (v2)
description: 'Get the BCS bytes of the Committee Authorization for the requested epoch.
Returns an HTTP response containing the BCS bytes of the requested CommitteeAuthorization.
- If the authorization is found, responds with [StatusCode::OK] and a binary body containing the serialized authorization
data.
- If the authorization is not found, responds with [StatusCode::NOT_FOUND] and an empty body.'
operationId: committee_authorization_v2
parameters:
- name: epoch
in: path
description: Epoch
required: true
schema:
$ref: '#/components/schemas/u64'
responses:
'200':
description: Binary representation of the committee authorization for the requested epoch.
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/BinaryData'
'404':
description: No committee authorization found for the requested epoch.
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/BinaryData'
deprecated: true
/rpc/v2/tables/{table_handle}/item:
post:
tags:
- Tables
summary: ' Get table item (v2)'
description: " Get the value at the `key` specified in the request body from the Move table identified by the `{table_handle}`\
\ path parameter.\n The key must be represented as an instance of `key_type` in the Move state, and the value must\
\ be represented as an instance of `value_type`.\n If either the key or the value cannot be parsed into the corresponding\
\ type then the API will return status code 400.\n\n ## Example of body\n ```json\n {\n \"key_type\": \"u64\",\n\
\ \"value_type\": \"0x1::multisig_voting::Proposal<0x1::governance_proposal::GovernanceProposal>\",\n \"key\"\
: \"12\"\n }\n```\n ```json\n {\n \"key_type\": \"u64\",\n \"value_type\": \"0x1::string::String\",\n \"key\"\
: \"42\"\n }\n```"
operationId: table_item_by_key
parameters:
- name: table_handle
in: path
description: Table handle to lookup. Should be a valid Move address retrieved from the account resources API.
required: true
schema:
type: string
requestBody:
description: Request containing item key and value types and item key itself
content:
application/json:
schema:
$ref: '#/components/schemas/TableItemRequest'
required: true
responses:
'200':
description: Item of the table
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/MoveValue'
'400':
description: Provided values cannot be parsed into the corresponding types.
headers:
x-supra-chain-id:
schema:
type: integer
format: u-int8
minimum: 0
description: Chain ID of the current chain.
/rpc/v2/transactions/estimate_gas_price:
get:
tags:
- Transactions
summary: Estimate gas price (v2)
description: Get statistics derived from the gas prices of recently executed transactions.
operationId: estimate_gas_price_v2
responses:
'200':
description: Returns the mean, median and maximum gas prices of recently executed transactions.
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/GasPriceResV2'
deprecated: true
/rpc/v2/transactions/simulate:
post:
tags:
- Transactions
summary: Simulate a transaction (v2)
operationId: simulate_txn_v2
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SupraTransaction'
required: true
responses:
'200':
description: Simulate a transaction against the current state of the RPC node. The transaction must have an invalid
signature.
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/TransactionInfoV2'
deprecated: true
/rpc/v2/transactions/{hash}:
get:
tags:
- Transactions
summary: Get transaction by hash (v2)
description: Get information about a transaction by its hash.
operationId: transaction_by_hash_v2
parameters:
- name: hash
in: path
description: Hash of the transaction to lookup
required: true
schema:
type: string
responses:
'200':
description: Transaction data of the given transaction hash
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/TransactionInfoV2'
deprecated: true
/rpc/v2/view:
post:
tags:
- View
summary: ' Execute view function (v2)'
description: " # Example\n ```json\n {\n \"function\": \"0x1::timestamp::now_microseconds\",\n \"type_arguments\"\
: [],\n \"arguments\": []\n }\n```"
operationId: view_function_v2
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ViewRequest'
required: true
responses:
'200':
description: Result of view function
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/MoveValueResponseV2'
deprecated: true
/rpc/v2/wallet/faucet/transactions/{hash}:
get:
tags:
- Faucet
summary: Faucet transaction (v2)
description: Get information about a faucet transaction by its hash.
operationId: faucet_v2
parameters:
- name: hash
in: path
description: Hash of the faucet transaction to lookup
required: true
schema:
type: string
responses:
'200':
description: Faucet transaction data of the given transaction hash
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/TransactionInfoV2'
/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 specifi
# --- truncated at 32 KB (188 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/supra/refs/heads/main/openapi/supra-rpc-node-openapi.yml