Skip to main content
Version: release (v0.77)

List assets

GET 

/api/v2/assets

Get a list of assets available on the Vega network

Request

Query Parameters

    assetId string

    Optional asset ID to list data for.

    pagination.first int32

    Number of records to be returned that sort greater than row identified by cursor supplied in 'after'.

    pagination.after string

    If paging forwards, the cursor string for the last row of the previous page.

    pagination.last int32

    Number of records to be returned that sort less than row identified by cursor supplied in 'before'.

    pagination.before string

    If paging forwards, the cursor string for the first row of the previous page.

    pagination.newestFirst boolean

    Whether to order the results with the newest records first. If not set, the default value is true.

Responses

A successful response.

Schema
    assets object

    Page of assets data and corresponding page information.

    edges object[]

    Page of assets data and their corresponding cursors.

  • Array [
  • cursor string

    Cursor that can be used to fetch further pages.

    node object

    Asset data returned.

    details object

    Definition of the external source for this asset.

    builtinAsset object

    Vega built-in asset.

    maxFaucetAmountMint string

    Maximum amount that can be requested by a party through the built-in asset faucet at a time.

    decimals uint64

    Number of decimal / precision handled by this asset.

    erc20 object

    Ethereum ERC20 asset.

    chainId string

    Chain ID the asset originated from.

    contractAddress string

    Address of the contract for the token, on the ethereum network.

    lifetimeLimit string

    Lifetime limits deposit per address note: this is a temporary measure that can be changed by governance.

    withdrawThreshold string

    Maximum you can withdraw instantly. All withdrawals over the threshold will be delayed by the withdrawal delay. There’s no limit on the size of a withdrawal note: this is a temporary measure that can be changed by governance.

    name string

    Name of the asset (e.g: Great British Pound).

    quantum string

    Minimum economically meaningful amount in the asset.

    symbol string

    Symbol of the asset (e.g: GBP).

    id string

    Internal identifier of the asset.

    status - STATUS_UNSPECIFIED: Default value, always invalid - STATUS_PROPOSED: Asset is proposed and under vote - STATUS_REJECTED: Asset has been rejected from governance - STATUS_PENDING_LISTING: Asset is pending listing from the bridge - STATUS_ENABLED: Asset is fully usable in the network (string)

    Possible values: [STATUS_UNSPECIFIED, STATUS_PROPOSED, STATUS_REJECTED, STATUS_PENDING_LISTING, STATUS_ENABLED]

    Default value: STATUS_UNSPECIFIED

    Status of the asset.

  • ]
  • pageInfo object

    Page information that is used for fetching further pages.

    endCursor string

    End cursor.

    hasNextPage boolean

    Indicator if there is a next page.

    hasPreviousPage boolean

    Indicator if there is a previous page.

    startCursor string

    Start cursor.

Loading...