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

IOTA corecontracts API

The corecontracts API from IOTA — 18 operation(s) for corecontracts.

IOTA corecontracts API is one of 17 APIs that IOTA publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include corecontracts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 18 operations across 18 paths, and defines 24 schemas. It is described by OpenAPI 3.0.1, at version 0.

Requests are made against a single base URL, /.

18 operations 18 paths 24 schemas 18 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
0
Base URL
https://api.mainnet.iota.cafe:443
Authentication
API Key
Resource Areas
1

Authentication & Security 1

IOTA corecontracts API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Authorization).

  • Authorization — JWT Token

Paths & Operations 18

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

corecontracts 18
GET
/v1/chain/core/accounts/account/{agentID}/balance
Get all assets belonging to an account
accountsGetAccountBalance 2 params → 200401
GET
/v1/chain/core/accounts/account/{agentID}/nonce
Get the current nonce of an account
accountsGetAccountNonce 2 params → 200401
GET
/v1/chain/core/accounts/total_assets
Get all stored assets
accountsGetTotalAssets 1 param → 200401
GET
/v1/chain/core/blocklog/blocks/latest
Get the block info of the latest block
blocklogGetLatestBlockInfo 1 param → 200401
GET
/v1/chain/core/blocklog/blocks/latest/receipts
Get all receipts of the latest block
blocklogGetRequestReceiptsOfLatestBlock 1 param → 200401
GET
/v1/chain/core/blocklog/blocks/latest/requestids
Get the request ids for the latest block
blocklogGetRequestIDsForLatestBlock 1 param → 200401
GET
/v1/chain/core/blocklog/blocks/{blockIndex}
Get the block info of a certain block index
blocklogGetBlockInfo 2 params → 200401
GET
/v1/chain/core/blocklog/blocks/{blockIndex}/receipts
Get all receipts of a certain block
blocklogGetRequestReceiptsOfBlock 2 params → 200401
GET
/v1/chain/core/blocklog/blocks/{blockIndex}/requestids
Get the request ids for a certain block index
blocklogGetRequestIDsForBlock 2 params → 200401
GET
/v1/chain/core/blocklog/controladdresses
Get the control addresses
blocklogGetControlAddresses 1 param → 200401
GET
/v1/chain/core/blocklog/events/block/latest
Get events of the latest block
blocklogGetEventsOfLatestBlock 1 param → 200401
GET
/v1/chain/core/blocklog/events/block/{blockIndex}
Get events of a block
blocklogGetEventsOfBlock 2 params → 200401
GET
/v1/chain/core/blocklog/events/request/{requestID}
Get events of a request
blocklogGetEventsOfRequest 2 params → 200401
GET
/v1/chain/core/blocklog/requests/{requestID}
Get the receipt of a certain request id
blocklogGetRequestReceipt 2 params → 200401
GET
/v1/chain/core/blocklog/requests/{requestID}/is_processed
Get the request processing status
blocklogGetRequestIsProcessed 2 params → 200401
GET
/v1/chain/core/errors/{contractHname}/message/{errorID}
Get the error message format of a specific error id
errorsGetErrorMessageFormat 4 params → 200401
GET
/v1/chain/core/governance/chainadmin
Get the chain admin
governanceGetChainAdmin 1 param → 200401
GET
/v1/chain/core/governance/chaininfo
Get the chain info
governanceGetChainInfo 1 param → 200401

Schemas 24

The contract defines 24 schemas that model the data the API accepts and returns. The most detailed are RequestJSON (10 properties), ReceiptResponse (10 properties), BlockInfoResponse (7 properties), GovChainInfoResponse (6 properties). Each schema is shown below with its type and property counts.

ValidationError
object
2 properties 2 required
CoinJSON
object
2 properties 2 required
RequestIDsResponse
object
1 property 1 required
Limits
object
4 properties 4 required
GovPublicChainMetadata
object
5 properties 5 required
ReceiptResponse
object
10 properties 8 required
RequestJSON
object
10 properties 9 required
FeePolicy
object
3 properties 3 required
BlockInfoResponse
object
7 properties 7 required
Ratio32
object
2 properties 2 required
AssetsResponse
object
3 properties 3 required
UnresolvedVMErrorJSON
object
2 properties
GovChainInfoResponse
object
6 properties 6 required
EventsResponse
object
1 property 1 required
EventJSON
object
4 properties 4 required
CallTargetJSON
object
2 properties 2 required
ControlAddressesResponse
object
3 properties 3 required
IotaObjectJSON
object
2 properties 2 required
AssetsJSON
object
2 properties 2 required
RequestProcessedResponse
object
3 properties 3 required
AccountNonceResponse
object
1 property 1 required
BurnRecord
object
2 properties 2 required
ErrorMessageFormatResponse
object
1 property 1 required
GovChainAdminResponse
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

iota-corecontracts-api-openapi.yml Raw ↑

Other APIs IOTA publishes across the network.

IOTA GraphQL API
IOTA auth API
IOTA chains API
IOTA Coin Query API
IOTA Extended API
IOTA Governance API
IOTA Health API
IOTA metrics API
IOTA Move Utils API
IOTA node API
IOTA Read API
IOTA requests API