Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kusama transaction API

The transaction API from Kusama — 6 operation(s) for transaction.

Kusama transaction API is one of 21 APIs that Kusama publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include transaction. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 6 operations across 6 paths, and defines 18 schemas. It is described by OpenAPI 3.0.0, at version 20.14.1.

Requests are made against 5 base URLs: https://polkadot-public-sidecar.parity-chains.parity.io/, https://kusama-public-sidecar.parity-chains.parity.io/, https://polkadot-asset-hub-public-sidecar.parity-chains.parity.io/, https://kusama-asset-hub-public-sidecar.parity-chains.parity.io/, http://localhost:8080.

6 operations 6 paths 18 schemas 2 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
20.14.1
Base URL
https://kusama-rpc.polkadot.io/
Resource Areas
1

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 2 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

transaction 6
POST
/transaction
Submit a transaction to the node's transaction pool.
submitTransaction body → 200400
POST
/transaction/dry-run
Dry run an extrinsic.
dryrunTransaction body → 200400
POST
/transaction/fee-estimate
Receive a fee estimate for a transaction.
feeEstimateTransaction body → 200400
GET
/transaction/material
Get all the network information needed to construct a transaction offline.
getTransactionMaterial 3 params → 200400
GET
/transaction/material/{metadataVersion}
Get all the network information needed to construct a transaction offline and the version of metadata specified in metadataVersion.
getTransactionMaterialwithVersionedMetadata 3 params → 200400
POST
/transaction/metadata-blob
Get the metadata blob for offline signers.
getTransactionMetadataBlob body → 200400

Schemas 18

The contract defines 18 schemas that model the data the API accepts and returns. The most detailed are TransactionMetadataBlob (8 properties), TransactionFeeEstimateFailure (7 properties), TransactionMaterial (7 properties), MetadataBlobBody (6 properties). Each schema is shown below with its type and property counts.

TransactionValidityError
object
The error result from an invalid transaction submitted via the dry-run endpoint.
1 property
TransactionFeeEstimateFailure
object
7 properties
BlockIdentifiers
object
2 properties
TransactionDispatchError
object
The reason why the dispatch call failed.
1 property
TransactionMetadataBlob
object
Response containing the metadata blob for offline signers. The metadataBlob contains type definitions needed to decode the specific transaction, Merkle proofs…
8 properties
DryRunBody
object
3 properties
WeightsV2
object
2 properties
TransactionMaterial
object
Note: chainName, specName, and specVersion are used to define a type registry with a set of signed extensions and types. For Polkadot and Kusama, chainName is…
7 properties
MetadataBlobBody
object
Request body for generating the metadata blob. You must provide either: (1) tx (full extrinsic) with optional txAdditionalSigned, or (2) callData with included…
6 properties
TransactionFailedToSubmit
object
Error message when the node rejects the submitted transaction.
5 properties
TransactionFailedToParse
object
Error message when Sidecar fails to parse the transaction.
5 properties
Transaction
object
1 property
TransactionFeeEstimate
object
Note: partialFee does not include any tips that you may add to increase a transaction's priority. See [computefee](https://crates.parity.io/pallettransactionpa…
3 properties
TransactionDryRun
object
References: - PostDispatchInfo: https://docs.rs/frame-support/38.0.0/framesupport/dispatch/struct.PostDispatchInfo.html - DispatchError: https://docs.rs/sp-run…
2 properties
Error
object
4 properties
TransactionSuccess
object
1 property
TransactionDispatchOutcome
object
The result of a valid transaction submitted via the dry-run endpoint.
2 properties
TransactionFailure

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kusama-transaction-api-openapi.yml Raw ↑

Other APIs Kusama publishes across the network.

Kusama JSON-RPC API
Kusama accounts API
Kusama ahm API
Kusama blocks API
Kusama contracts API
Kusama coretime API
Kusama node API
Kusama pallets API
Kusama paras API
Kusama rc accounts API
Kusama rc API
Kusama rc blocks API