How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Supra

Supra Automation API

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.

Documentation Provider Profile APIs.io OpenAPI GitHub

This API exposes 56 operations across 56 paths, organized into 11 resource areas, and defines 112 schemas. It is described by OpenAPI 3.1.0, at version 5e9ea652457cd48aba6b1505bdd59da27fec13f6.

Requests are made against a single base URL, /.

56 operations 56 paths 112 schemas 48 GET8 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
5e9ea652457cd48aba6b1505bdd59da27fec13f6
Base URL
https://rpc-mainnet.supra.com
Contact
Supra Labs
Resource Areas
11

Paths & Operations 56

Across 56 paths, the API surfaces 56 operations — 48 GET, 8 POST. They span 11 resource areas, including Transactions, Faucet, Accounts, Block, Consensus, Tables, View, Events, and 3 more. Each is listed below with its method, path, parameters, and response codes.

Transactions 12

Transactions Api

GET
/rpc/v1/transactions/chain_id
Chain id (v1)
chain_id → 200
GET
/rpc/v1/transactions/parameters
Transaction parameters (v1)
transaction_parameter → 200
POST
/rpc/v1/transactions/submitdeprecated
Submit transaction (v1)
submit_txn body → 200
GET
/rpc/v2/transactions/estimate_gas_pricedeprecated
Estimate gas price (v2)
estimate_gas_price_v2 → 200
POST
/rpc/v2/transactions/simulatedeprecated
Simulate a transaction (v2)
simulate_txn_v2 body → 200
GET
/rpc/v2/transactions/{hash}deprecated
Get transaction by hash (v2)
transaction_by_hash_v2 1 param → 200
GET
/rpc/v3/transactions/estimate_gas_price
Estimate gas price (v3)
estimate_gas_price_v3 → 200
POST
/rpc/v3/transactions/simulate
Simulate a transaction (v3)
simulate_txn_v3 body → 200
POST
/rpc/v3/transactions/submit
Submit transaction (v3)
submit_txn_v3 body → 200
GET
/rpc/v3/transactions/{hash}
Get transaction by hash (v3)
transaction_by_hash_v3 3 params → 200
GET
/rpc/v4/transactions/certificates
Get transaction inclusion certificates by block height (v4)
transactions_inclusion_certificates_by_block_height_v4 2 params → 200404410
GET
/rpc/v4/transactions/{hash}
Get transaction by hash (v4)
transaction_by_hash_v4 4 params → 200
Faucet 3

Faucet Api

GET
/rpc/v1/wallet/faucet/transactions/{hash}deprecated
Faucet transaction (v1)
faucet_transaction_by_hash_v1 1 param → 200
GET
/rpc/v1/wallet/faucet/{address}
Faucet (v1)
faucet_v1 1 param → 200
GET
/rpc/v2/wallet/faucet/transactions/{hash}
Faucet transaction (v2)
faucet_v2 1 param → 200
Accounts 16

Accounts Api

GET
/rpc/v2/accounts/{address}deprecated
Get account (v2)
get_account_v2 1 param → 200
GET
/rpc/v2/accounts/{address}/coin_transactionsdeprecated
Get coin transactions (v2)
coin_transactions_v2 3 params → 200
GET
/rpc/v2/accounts/{address}/modulesdeprecated
Get account modules (v2)
get_account_modules_v2 3 params → 200
GET
/rpc/v2/accounts/{address}/modules/{module_name}deprecated
Get account module (v2)
get_account_module_v2 2 params → 200
GET
/rpc/v2/accounts/{address}/resourcesdeprecated
Get account resources (v2)
get_account_resources_v2 3 params → 200
GET
/rpc/v2/accounts/{address}/resources/{resource_type}deprecated
Get account resource (v2)
get_account_resource_v2 2 params → 200
GET
/rpc/v2/accounts/{address}/transactionsdeprecated
Get account transactions (v2)
get_account_transactions_v2 3 params → 200
GET
/rpc/v3/accounts/{address}
Get account (v3)
get_account_v3 1 param → 200
GET
/rpc/v3/accounts/{address}/automated_transactions
Get account auto-transaction (v3)
statement_automated_v3 5 params → 200503
GET
/rpc/v3/accounts/{address}/coin_transactions
Get coin transactions (v3)
coin_transactions_v3 5 params → 200503
GET
/rpc/v3/accounts/{address}/fa_transactions
Get Fungible Asset transactions (v3)
fa_transactions_v3 5 params → 200
GET
/rpc/v3/accounts/{address}/modules
Get account modules (v3)
get_account_modules_v3 3 params → 200
GET
/rpc/v3/accounts/{address}/modules/{module_name}
Get account module (v3)
get_account_module_v3 2 params → 200
GET
/rpc/v3/accounts/{address}/resources
Get account resources (v3)
get_account_resources_v3 3 params → 200
GET
/rpc/v3/accounts/{address}/resources/{resource_type}
Get account resource (v3)
get_account_resource_v3 2 params → 200
GET
/rpc/v3/accounts/{address}/transactions
Get account transactions (v3)
get_account_transactions_v3 4 params → 200503
Block 8

Block Api

GET
/rpc/v2/blockdeprecated
Get the latest block (v2)
latest_block_v2 → 200
GET
/rpc/v2/block/height/{height}deprecated
Get block by height (v2)
block_by_height_v2 2 params → 200404410
GET
/rpc/v2/block/{block_hash}deprecated
Get block by hash (v2)
block_header_info_v2 1 param → 200
GET
/rpc/v3/block
Get latest block (v3)
latest_block_v3 → 200
GET
/rpc/v3/block/height/{height}
Get block by height (v3)
block_by_height_v3 3 params → 200404410
GET
/rpc/v3/block/{block_hash}
Get block by hash (v3)
block_info_by_hash_v3 1 param → 200
GET
/rpc/v3/block/{block_hash}/transactions
Get transactions by block hash (v3)
txs_by_block_v3 2 params → 200
GET
/rpc/v4/block/height/{height}
Get block by height (v4)
block_by_height_v4 4 params → 200404410
Consensus 7
GET
/rpc/v2/consensus/blockdeprecated
Get latest consensus block (v2)
latest_consensus_block_v2 → 200404
GET
/rpc/v2/consensus/block/height/{height}deprecated
Get consensus block by height (v2)
consensus_block_v2 2 params → 200404
GET
/rpc/v2/consensus/committee_authorization/{epoch}deprecated
Get committee authorization (v2)
committee_authorization_v2 1 param → 200404
GET
/rpc/v4/consensus/block
Get latest consensus block (v4)
latest_consensus_block_v4 → 200404
GET
/rpc/v4/consensus/block/height/{height}
Get consensus block by height (v4)
consensus_block_v4 2 params → 200404
GET
/rpc/v4/consensus/committee_authorization/{epoch}
Get Committee Authorization (v4)
committee_authorization_v4 1 param → 200404
GET
/rpc/v4/consensus/committees/{epoch}
Get Authorized Committee (v4)
committees_v4 1 param → 200400
Tables 1

Tables Api

POST
/rpc/v2/tables/{table_handle}/item
Get table item (v2)
table_item_by_key 1 param body → 200400
View 2

View Api

POST
/rpc/v2/viewdeprecated
Execute view function (v2)
view_function_v2 body → 200
POST
/rpc/v3/view
Execute view function (v3)
view_function_v3 body → 200
Events 3

Events Api

GET
/rpc/v3/events/{event_type}
Get events by type (v3)
events_by_type_v3 5 params → 200410503
GET
/rpc/v4/events/{event_hash}/transaction/{transaction_hash}
Get event emission proof (v4)
event_emission_proof_v4 2 params → 200400404
GET
/rpc/v4/events/{event_type}
Get events by type (v4)
events_by_type_v4 6 params → 200410503
Version 1
GET
/rpc/v3/version
Get Build Information (v3)
version_info_v3 → 200
Proofs 2

Endpoints for retrieving Merkle proofs for consensus-certified data.

POST
/rpc/v4/proofs/events
Get a batch of event-emission proofs anchored to a single inclusion certificate (v4)
proofs_events_v4 body → 200400404
GET
/rpc/v4/proofs/events/{event_hash}/transaction/{transaction_hash}
Get a single event emission proof (v4)
proofs_event_emission_proof_v4 2 params → 200400404
WebSocket 1

Block-streaming WebSocket subscription Api

GET
/rpc/v4/ws
Supra JSON-RPC WebSocket subscriptions (v4)
supra_block_ws → 101429503

Schemas 112

The contract defines 112 schemas that model the data the API accepts and returns. The most detailed are ExecutedBlockStats (8 properties), TransactionInfoV4 (8 properties), TransactionInfoV2 (7 properties), TransactionInclusionProof (7 properties). Each schema is shown below with its type and property counts.

AccountAddress
string
Hex encoded account address.
AccountCoinStatementV1
object
2 properties 2 required
AccountCoinStatementV2
object
2 properties 2 required
AccountData
object
Datatype that holds the sequence number and account authentication key.
2 properties 2 required
AccountStatementV1
object
1 property 1 required
AccountStatementV2
object
1 property 1 required
AccountStatementV3
array
Account transactions of [TransactionV3] type.
AccumulatorProof
object
A proof that can be used authenticate an element in an accumulator given trusted root hash. For example, both TransactionInclusionProof and EventEmissionProof…
1 property 1 required
Address
The address of an account This is represented in a string as a 64 character hex string, sometimes shortened by stripping leading 0s, and adding a 0x.
AuthorizedCommittee
A versioned authorized committee, wrapping either V0 or V1.
AuthorizedCommitteeV0
object
A V0 authorized committee.
2 properties 2 required
AuthorizedCommitteeV1
object
A V1 authorized committee.
2 properties 2 required
BatchHeader
object
Batch metadata.
5 properties 5 required
BinaryData
A type reserved for internal use to represent [HttpResponse] with binary data.
Block
object
The API representation of a Supra block.
2 properties 1 required
BlockHeader
object
5 properties 5 required
BlockHeaderInfo
object
Metadata about a Supra block.
6 properties 6 required
BlockInfo
object
Metadata of a block including its digest.
2 properties 2 required
BlockMetadataInfoV3
object
Details of block metadata transaction execution
4 properties 3 required
BlockMetadataInfoV4
object
Details of block metadata transaction execution
5 properties 3 required
BlockV3
object
The API representation of a Supra block.
3 properties 1 required
BlockV4
object
The API representation of a Supra block.
3 properties 1 required
BlockVoteInfo
object
Metadata of a Moonshot consensus vote.
2 properties 2 required
CertificateThresholdType
string
Certificate_BlockVoteInfo
object
5 properties 5 required
Certificate_CommitteeInfo
object
5 properties 5 required
Certificate_TransactionsInclusionCertificationData
object
5 properties 5 required
CertifiedBlock
object
An [SmrBlock] certified by an [SmrQC].
2 properties 2 required
CommitteeAuthorization
object
A certificate indicating that the Committee with the hash digest contained in the related committee info is authorized to govern the related epoch.
1 property 1 required
CommitteeInfo
object
Metadata about a Committee required to construct a committee authorization.
2 properties 2 required
CommitteeV0
object
A committee of validators operating as a subset of the Supra blockchain network. Each Committee is assigned to perform a task for the duration of its associate…
3 properties 2 required
CommitteeV1
object
A V1 committee of validators operating as a subset of the Supra blockchain network. Each Committee is assigned to perform a task for the duration of its associ…
3 properties 3 required
ConsensusBlock
object
The API representation of a Supra Certified Consensus block.
2 properties 2 required
EpochId
object
2 properties 2 required
EpochInfo
object
Metadata about an epoch.
3 properties 3 required
ErrResp
object
1 property 1 required
EventEmissionProof
object
Proof of an event's emission within a transaction's events tree.
4 properties 4 required
EventEmissionProofEntry
object
A single matched event's emission proof plus the metadata needed to correlate it back to the caller's request.
4 properties 4 required
EventEmissionProofsBatchItem
object
Per-transaction selector. Both Move and EVM transactions are supported; the format of each entry in eventtypes is dispatched off the transaction's VM.
2 properties 2 required
EventEmissionProofsBatchItemResponse
object
Per-transaction proof bundle. A single transactioninclusionproof is shared across all matched events in the same transaction.
4 properties 4 required
EventEmissionProofsBatchRequest
object
Request body for POST /rpc/v4/proofs/event-emissions.
1 property 1 required
EventEmissionProofsBatchResponse
object
Response body for POST /rpc/v4/proofs/event-emissions. All proofs in the response are anchored to a single inclusion certificate at blockheight. A cross-chain…
3 properties 3 required
EventV1
object
On-chain event.
4 properties 4 required
EventV2
object
On-chain event v2.
5 properties 5 required
EventWithContextV3
object
Event wrapper with block height and transaction hash
3 properties 3 required
EventWithContextV4
object
Event wrapper with block height and transaction hash
4 properties 3 required
EventsV1
object
1 property 1 required
EventsV3
object
Events structure for v3 API
1 property 1 required
EventsV4
object
Events structure for v4 API
1 property 1 required
EvmTransactionOutput
API representation of the execution output of an Evm transaction.
EvmTransferKind
string
EvmTransferOperation
object
This is a convenience structure wrapping [TransferOperation] to implement (de)serialization logic.
4 properties 4 required
ExecutedBlockInfo
object
Block metadata and existing statistics collected on executed block output.
2 properties 1 required
ExecutedBlockStats
object
Executed block statistics collected based on execution results.
8 properties
FaucetStatus
GasPriceRes
object
2 properties 2 required
GasPriceResV2
object
3 properties 3 required
GasPriceResV3
object
4 properties 4 required
Guid
object
A globally unique identifier derived from the sender's address and a counter
2 properties 2 required
Hash
string
Hex encoded hash
Identity
string
Hex encoded identity.
MoveList
MoveModule
object
A Move module.
5 properties 5 required
MoveModuleBytecode
object
2 properties 2 required
MoveModuleList
object
2 properties 1 required
MoveModuleListV2
object
2 properties 1 required
MoveResource
object
A Move Resource.
2 properties 2 required
MoveResourceList
object
2 properties 1 required
MoveResourcesResponse
object
2 properties 2 required
MoveTransactionOutputV1
object
The execution output of a Move transaction.
3 properties 3 required
MoveTransactionOutputV4
object
The execution output of a Move transaction.
3 properties 3 required
MoveValue
An enum of the possible Move value types.
MoveValueResponseV1
object
Datatype for representing the MoveValue This struct is deprecated. Use the [super::v2::MoveValueResponse] struct instead.
1 property 1 required
MoveValueResponseV2
object
Datatype for representing the MoveValue
1 property 1 required
SignedSmrTransaction
object
Defines internal transactions (DKG and Oracle) coupled with signer data.
2 properties 2 required
SignedTransaction
object
Defines internal transactions(DKG and Oracle) coupled with signer data.
2 properties 2 required
SignerData
object
Signer information of the [crate::delegates::UnsignedSmrTransaction].
2 properties 2 required
SmrBlock
object
A Supra Moonshot block.
3 properties 3 required
SmrDkgCommitteeType
Defines supported committee types for which distributed key generation can be conducted.
SmrQC
object
1 property 1 required
SmrTimestamp
object
1 property 1 required
SmrTransactionHeader
object
6 properties 6 required
SmrTransactionProtocol
StructTag
object
4 properties 4 required
SupraTransaction
Transaction variants supported by Supra.
TableItemRequest
object
Describes body of the Table item request by item key.
3 properties 3 required
TransactionBlockInfo
object
Metadata about the block that finalized a particular [SmrTransaction].
3 properties 3 required
TransactionInclusionAndEventEmissionProof
object
Container for an event emission proof along with its corresponding transaction inclusion proof. This structure bundles the proofs required to verify that a spe…
2 properties 2 required
TransactionInclusionProof
object
Proof of a transaction's inclusion in the merkle accumulator tree.
7 properties 5 required
TransactionInfoV1
object
Information about a Supra transaction.
7 properties 5 required
TransactionInfoV2
object
Information about a Supra transaction.
7 properties 5 required
TransactionInfoV4
object
Information about a Supra transaction.
8 properties 5 required
TransactionOutputV1
[crate::v1::TransactionOutputV1] with all fields in human-readable format.
TransactionOutputV4
[crate::v4::TransactionOutputV4] with all fields in human-readable format.
TransactionParameters
object
1 property 1 required
TransactionV3
TransactionV4
TransactionsInclusionCertificates
object
A collection of transaction inclusion certificates for a given range of block heights. The entires are ordered by block height, with an entry being null if the…
1 property 1 required
TransactionsInclusionCertificationData
object
Data payload for transaction inclusion certificate. Certified by the transaction inclusion certifier to prove the both MoveVM and EVM merkle accumulator of a s…
4 properties 4 required
TxExecutionStatus
string
TypeTag
UnsignedSmrTransaction
object
Defines unsigned transaction enclosing only header and payload information.
2 properties 2 required
VMStatus
A VMStatus is represented as either - Executed indicating successful execution. - Error indicating an error from the VM itself. - MoveAbort indicating an abort…
ValidatorPublicKeys
object
The public keys held by a Supra validator. Intended to be stored in an unencrypted JSON file as a part of the validator's public identity for easy access by th…
2 properties 2 required
ValidatorV0
object
Information about a validator participating in a Committee.
4 properties 2 required
ValidatorV1
object
Information about a validator participating in a V1 Committee.
4 properties 3 required
VersionInfo
object
JSON payload returned by /rpc/v3/version
5 properties 5 required
View
object
2 properties 2 required
ViewRequest
object
View request for the Move View Function API.
3 properties 3 required
Vm
string
VM that produced a given transaction and its events. Determines which accumulator root in the shared inclusioncertificate a per-item transactioninclusionproof…
VoteType
string
The different types of valid vote messages in Moonshot.
u64
integer

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

supra-rpc-node-openapi.yml Raw ↑
#Automation#Blockchain#Smart Contracts#Move
← Back to S APIs
API Details
ID
supra:supra-automation-api
Base URL
https://rpc-mainnet.supra.com
Docs
https://docs.supra.com/automation/api-reference
Provider
Supra
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=supra-supra-automation-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/supra-supra-automation-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Supra Automation API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.