Aptos Blocks API is one of 10 APIs that Aptos publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Blocks. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.
This API exposes 2 operations across 2 paths, and defines 163 schemas. It is described by OpenAPI 3.2.0, at version 1.2.0.
Requests are made against a single base URL, /v1.
2 operations
2 paths
163 schemas
2 GET
Metadata
The identity and technical contract details declared by the specification.
Paths & Operations 2
Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.
Blocks 2
Access to blocks
GET
/blocks/by_height/{block_height}
Get blocks by height
GET
/blocks/by_version/{version}
Get blocks by version
Schemas 163
The contract defines 163 schemas that model the data the API accepts and returns. The most detailed are UserTransaction (21 properties), BlockMetadataTransaction (19 properties), ChunkyDKGResultTransaction (14 properties), DKGResultTransaction (13 properties). Each schema is shown below with its type and property counts.
WriteSetChange_DeleteModule
BlockMetadataExtension_BlockMetadataExtensionRandomness
WebAuthn
object
1 property
1 required
ValidatorTransaction_JWKUpdateTransaction
DeprecatedModuleBundlePayload
object
Signature_WebAuthn
MoveAbility
string
MoveStructField
object
Move struct field
2 properties
2 required
BlockMetadataExtensionEmpty
object
ScriptWriteSet
object
2 properties
2 required
EncryptedTransactionPayload
object
An encrypted transaction payload, discriminated by encryptedstate. NOTE: multisigaddress and replayprotectionnonce are not surfaced here. They are part of extr…
AccountSignature_AbstractSignature
PublicKey_SlhDsa_Sha2_128s
MoveModule
object
A Move module
5 properties
5 required
MultisigTransactionPayload
object
Enum for multisig transaction payloads, supporting both entry functions and scripts.
DecryptedPayload
object
Payload has been successfully decrypted.
6 properties
5 required
MoveStruct
object
A move struct
8 properties
8 required
Event
object
An event from a transaction
4 properties
4 required
TransactionSignature
object
An enum representing the different transaction signatures available
PublicKey
object
UnsupportedJWK
object
Move type 0x1::jwks::UnsupportedJWK in rust. See its doc in Move for more details.
2 properties
2 required
WriteSetChange_WriteTableItem
DeleteResource
object
Delete a resource
3 properties
3 required
MultisigTransactionPayload_ScriptPayload
EncryptedTransactionInnerPayload_ScriptPayload
BlockMetadataExtension_BlockMetadataExtensionRandomnessAndDecKey
TransactionSignature_MultiAgentSignature
UserTxnLimitsRequest_DelegationPoolDelegatorLimitsRequest
DirectWriteSet
object
2 properties
2 required
MoveStructTag
string
String representation of a MoveStructTag (on-chain Move struct type). This exists so you can specify MoveStructTags as path / query parameters, e.g. for geteve…
BlockMetadataExtension_BlockMetadataExtensionEmpty
WriteSet
object
The associated writeset with a payload
JWK
object
The JWK type that can be converted from/to JWKMoveStruct but easier to use in rust.
BlockEndInfo
object
4 properties
4 required
WriteSet_DirectWriteSet
MoveFunctionVisibility
string
Move function visibility
Secp256r1Ecdsa
object
1 property
1 required
Transaction_BlockEpilogueTransaction
WriteModule
object
Write a new module or update an existing one
3 properties
3 required
EncryptedTransactionPayload_FailedDecryptionPayload
UserTxnLimitsRequest
object
A request for higher transaction execution limits, backed by a staking proof.
Transaction_PendingTransaction
EncryptedTransactionInnerPayload
object
The inner payload of an encrypted transaction, present only when decrypted.
WriteSetPayload
object
A writeset payload, used only for genesis
1 property
1 required
EncryptedTransactionInnerPayload_MultisigPayload
EncryptedTransactionPayload_EncryptedPayload
BlockMetadataExtensionRandomnessAndDecKey
object
2 properties
FederatedKeyless
object
1 property
1 required
AccountSignature_SingleKeySignature
MultiKeySignature
object
A multi key signature
3 properties
3 required
Signature_Secp256k1Ecdsa
PublicKey_Secp256r1Ecdsa
TransactionPayload_MultisigPayload
JWKUpdateTransaction
object
13 properties
12 required
MultisigPayload
object
A multisig transaction that allows an owner of a multisig account to execute a pre-approved transaction as the multisig account.
2 properties
1 required
MultiAgentSignature
object
Multi agent signature for multi agent transactions This allows you to have transactions across multiple accounts
3 properties
3 required
UserTxnLimitsRequest_DelegatedVoterLimitsRequest
MoveStructGenericTypeParam
object
Move generic type param
1 property
1 required
Transaction_BlockMetadataTransaction
SingleKeySignature
object
A single key signature
2 properties
2 required
FeePayerSignature
object
Fee payer signature for fee payer transactions This allows you to have transactions across multiple accounts and with a fee payer
5 properties
5 required
SlhDsa_Sha2_128s
object
1 property
1 required
ExportedAggregateSignature
object
A more API-friendly representation of the on-chain aptostypes::aggregatesignature::AggregateSignature.
2 properties
1 required
GenesisPayload
object
The writeset payload of the Genesis transaction
TransactionSignature_Ed25519Signature
RSA_JWK
object
Move type 0x1::jwks::RSAJWK in rust. See its doc in Move for more details.
5 properties
5 required
WriteSetChange_WriteResource
TransactionPayload
object
An enum of the possible transaction payloads
WriteSetChange_WriteModule
TransactionPayload_EntryFunctionPayload
Keyless
object
1 property
1 required
WriteSet_ScriptWriteSet
EncryptedTransactionInnerPayload_EntryFunctionPayload
AptosErrorCode
string
These codes provide more granular error information beyond just the HTTP status code of the response.
PublicKey_Keyless
EncryptedPayload
object
Payload is still encrypted and cannot be read.
4 properties
3 required
DecodedTableData
object
Decoded table data
4 properties
4 required
TransactionPayload_ScriptPayload
TransactionPayload_DeprecatedModuleBundlePayload
FailedDecryptionPayload
object
Decryption was attempted but failed.
4 properties
3 required
Transaction_ValidatorTransaction
MoveResource
object
A parsed Move resource
2 properties
2 required
PendingTransaction
object
A transaction waiting in mempool
10 properties
7 required
HashValue
string
EventGuid
object
2 properties
2 required
AccountSignature_NoAccountSignature
EntryFunctionId
string
Entry function id is string representation of a entry function defined on-chain. Format: {address}::{module name}::{function name} Both module name and functio…
Transaction
object
Enum of the different types of transactions in Aptos
NoAccountSignature
object
A placeholder to represent the absence of account signature
StateCheckpointTransaction
object
A state checkpoint transaction
11 properties
10 required
MoveScriptBytecode
object
Move script bytecode
2 properties
1 required
UserTransaction
object
A transaction submitted by a user to change the state of the blockchain
21 properties
17 required
ExportedDKGTranscript
object
3 properties
3 required
TransactionPayload_EncryptedTransactionPayload
EntryFunctionPayload
object
Payload which runs a single entry function
3 properties
3 required
PublicKey_Secp256k1Ecdsa
HexEncodedBytes
string
All bytes (Vec ) data is represented as hex-encoded string prefixed with 0x and fulfilled with two hex digits per byte. Unlike the Address type, HexEncodedByte…
MoveStructVariant
object
A single variant of a Move enum.
2 properties
2 required
AccountSignature_MultiEd25519Signature
PublicKey_Ed25519
Signature_Keyless
EncryptedTransactionPayload_DecryptedPayload
DelegationPoolDelegatorLimitsRequest
object
A higher-limits request backed by a delegation pool the fee payer delegates to.
2 properties
2 required
MoveModuleBytecode
object
Move module bytecode along with it's ABI
2 properties
1 required
BlockMetadataTransaction
object
A block metadata transaction This signifies the beginning of a block, and contains information about the specific block
19 properties
17 required
AccountSignature
object
Account signature scheme The account signature scheme allows you to have two types of accounts: 1. A single Ed25519 key account, one private key 2. A k-of-n mu…
AbstractSignature
object
2 properties
2 required
Secp256k1Ecdsa
object
1 property
1 required
ExportedCertifiedAggregatedChunkySubtranscript
object
A more API-friendly representation of the on-chain aptostypes::dkg::chunkydkg::CertifiedAggregatedChunkySubtranscript.
4 properties
4 required
Transaction_UserTransaction
MoveFunctionGenericTypeParam
object
Move function generic type param
1 property
1 required
ExportedProviderJWKs
object
A more API-friendly representation of the on-chain aptostypes::jwks::ProviderJWKs.
3 properties
3 required
IndexedSignature
object
2 properties
2 required
Block
object
A Block with or without transactions This contains the information about a transactions along with associated transactions if requested
6 properties
5 required
BlockMetadataExtensionRandomness
object
1 property
Signature_Ed25519
BlockEpilogueTransaction
object
A block epilogue transaction
12 properties
10 required
Transaction_StateCheckpointTransaction
AptosError
object
This is the generic struct we use for all API errors, it contains a string message and an Aptos API specific error code.
3 properties
2 required
ValidatorTransaction_ChunkyDKGResultTransaction
TransactionSignature_AccountSignature
Signature_SlhDsa_Sha2_128s
PublicKey_FederatedKeyless
TransactionSignature_MultiEd25519Signature
Address
string
A hex encoded 32 byte Aptos account address. This is represented in a string as a 64 character hex string, sometimes shortened by stripping leading 0s, and add…
ValidatorTransaction_DKGResultTransaction
MoveStructValue
object
This is a JSON representation of some data within an account resource. More specifically, it is a map of strings to arbitrary JSON values / objects, where the…
WriteTableItem
object
Change set to write a table item
5 properties
4 required
StakePoolOwnerLimitsRequest
object
A higher-limits request whose backing is a stake pool the fee payer owns.
1 property
1 required
MultisigTransactionPayload_EntryFunctionPayload
U64
string
A string containing a 64-bit unsigned integer. We represent u64 values as a string to ensure compatibility with languages such as JavaScript that do not parse…
ScriptPayload
object
Payload which runs a script that can run multiple functions
3 properties
3 required
DeleteModule
object
Delete a module
3 properties
3 required
WriteSetChange
object
A final state change of a transaction on a resource or module
WriteSetChange_DeleteResource
Signature
object
ClaimedEntryFunction
object
An encrypted payload's claim about the entry function. Specifies at least the module address, and optionally the specific entry funtion.
2 properties
1 required
GenesisPayload_WriteSetPayload
WriteResource
object
Write a resource or update an existing one
3 properties
3 required
GenesisTransaction
object
The genesis transaction This only occurs at the genesis transaction (version 0)
12 properties
11 required
DeleteTableItem
object
Delete a table item
4 properties
3 required
TransactionSignature_FeePayerSignature
DeletedTableData
object
Deleted table data
2 properties
2 required
MoveFunction
object
Move function
7 properties
7 required
MoveModuleId
string
Move module id is a string representation of Move module. Format: {address}::{module name} address should be hex-encoded 32 byte account address that is prefix…
ChunkyDKGResultTransaction
object
14 properties
13 required
WriteSetChange_DeleteTableItem
ValidatorTransaction
object
AccountSignature_Ed25519Signature
Ed25519
object
1 property
1 required
RequestedMultipliers
object
Multipliers for higher transaction limits, expressed as percent of the base limit (100 = 1x, 200 = 2x, 250 = 2.5x).
2 properties
2 required
Ed25519Signature
object
A single Ed25519 signature
2 properties
2 required
AccountSignature_MultiKeySignature
MultiEd25519Signature
object
A Ed25519 multi-sig signature This allows k-of-n signing for a transaction
4 properties
4 required
ExportedQuorumCertifiedUpdate
object
A more API-friendly representation of the on-chain aptostypes::jwks::QuorumCertifiedUpdate.
2 properties
2 required
MoveType
string
String representation of an on-chain Move type tag that is exposed in transaction payload. Values: - bool - u8 - u16 - u32 - u64 - u128 - u256 - i8 - i16 - i32…
TransactionSignature_NoAccountSignature
Transaction_GenesisTransaction
DelegatedVoterLimitsRequest
object
A higher-limits request backed by a stake pool the fee payer is the delegated voter of.
2 properties
2 required
BlockMetadataExtension
object
DKGResultTransaction
object
13 properties
12 required
UserTxnLimitsRequest_StakePoolOwnerLimitsRequest
IdentifierWrapper
string
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Aptos 9
Other APIs Aptos publishes across the network.
Aptos Indexer GraphQL API
Aptos Transaction Stream API
Aptos Faucet API
Aptos Accounts API
Aptos Events API
Aptos General API
Aptos Tables API
Aptos Transactions API
Aptos View API
#Blocks
Where this information came from
This is an independent, third-party profile of Aptos Blocks 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.