Skip to content
LogoLogo

Assets

Node API v1.0.0 (Arrekta Node API).

MethodPathSummary
GET/v1/assetsList Assets
GET/v1/assets/{key}Get Asset
GET/v1/assets/{key}/frozenAsset Frozen
POST/v1/tools/metadata-hashMetadata Tool

GET /v1/assets

List Assets.

curl -s http://127.0.0.1:28332/v1/assets

Parameters

NameInTypeRequiredNotes
offsetqueryintegernomin 0, default 0
limitqueryintegernomin 1, max 500, default 100

Response 200 (application/json): AssetPage

FieldTypeRequiredNotes
itemsAsset[]yes
limitintegeryes
offsetintegeryes

Unknown fields may be added within v1; clients must ignore them.

Errors 400, 404, 409, 422, 429: application/problem+json Problem with a stable code.

operationId: list_assets_v1_assets_get

GET /v1/assets/{key}

Get Asset.

curl -s http://127.0.0.1:28332/v1/assets/<key>

Parameters

NameInTypeRequiredNotes
keypathstringyes

Response 200 (application/json): Asset

FieldTypeRequiredNotes
assetstringyes
authority_assetstring | nullyesmay be null
burnedstringyes
circulatingstringyes
clawbackbooleanyes
control_assetstring | nullyesmay be null
decimalsintegeryes
freezablebooleanyes
issue_heightintegeryes
issue_txidstringyes
issuedstringyes
max_supplystringyes
metadata_hashstringyes
mintablebooleanyes
namestringyes
nativebooleanyes
tickerstringyes

Unknown fields may be added within v1; clients must ignore them.

Errors 400, 404, 409, 422, 429: application/problem+json Problem with a stable code.

operationId: get_asset_v1_assets__key__get

GET /v1/assets/{key}/frozen

Asset Frozen.

curl -s http://127.0.0.1:28332/v1/assets/<key>/frozen

Parameters

NameInTypeRequiredNotes
keypathstringyes
limitqueryintegernomin 1, max 5000, default 1000

Response 200 (application/json): AssetFrozen

FieldTypeRequiredNotes
assetstringyes
freezablebooleanyes
frozenFrozenHolder[]yes
tickerstringyes

Unknown fields may be added within v1; clients must ignore them.

Errors 400, 404, 409, 422, 429: application/problem+json Problem with a stable code.

operationId: asset_frozen_v1_assets__key__frozen_get

POST /v1/tools/metadata-hash

Metadata Tool.

Validate an asset metadata document (ARRK-AMS-1) and return the hash to put in an issuance.

curl -s -X POST http://127.0.0.1:28332/v1/tools/metadata-hash -H 'content-type: application/json' -d '{…}'

Request body (application/json, required): MetadataBody

FieldTypeRequiredNotes
controlledbooleannodefault false
documentobjectyes
tickerstring | nullnomay be null

Response 200 (application/json): MetadataHash

FieldTypeRequiredNotes
canonicalstringyes
metadata_hashstringyes

Unknown fields may be added within v1; clients must ignore them.

Errors 400, 404, 409, 422, 429: application/problem+json Problem with a stable code.

operationId: metadata_tool_v1_tools_metadata_hash_post

Schemas

Asset

FieldTypeRequiredNotes
assetstringyes
authority_assetstring | nullyesmay be null
burnedstringyes
circulatingstringyes
clawbackbooleanyes
control_assetstring | nullyesmay be null
decimalsintegeryes
freezablebooleanyes
issue_heightintegeryes
issue_txidstringyes
issuedstringyes
max_supplystringyes
metadata_hashstringyes
mintablebooleanyes
namestringyes
nativebooleanyes
tickerstringyes

Unknown fields may be added within v1; clients must ignore them.

AssetFrozen

FieldTypeRequiredNotes
assetstringyes
freezablebooleanyes
frozenFrozenHolder[]yes
tickerstringyes

Unknown fields may be added within v1; clients must ignore them.

AssetPage

FieldTypeRequiredNotes
itemsAsset[]yes
limitintegeryes
offsetintegeryes

Unknown fields may be added within v1; clients must ignore them.

FrozenHolder

FieldTypeRequiredNotes
addressstring | nullyesmay be null
since_heightintegeryes

Unknown fields may be added within v1; clients must ignore them.

MetadataBody

FieldTypeRequiredNotes
controlledbooleannodefault false
documentobjectyes
tickerstring | nullnomay be null

MetadataHash

FieldTypeRequiredNotes
canonicalstringyes
metadata_hashstringyes

Unknown fields may be added within v1; clients must ignore them.