--- title: "Batch query assets" method: GET path: "/openapi/v1/assets/query" tags: ["Asset"] --- # Batch query assets `GET /openapi/v1/assets/query` This endpoint can be used to obtain asset information in batches from the system. ## Query parameters - `chain` 'eth' | 'bsc' | 'polygon' | 'avalanche' | 'arbitrum' | 'zksync' | 'linea' | 'starknet' | 'opbnb' | 'base' | 'scroll' | 'manta_pacific' | 'optimism' | 'mantle' | 'zkfair' | 'blast' | 'merlin' | 'mode' | 'cyber' | 'bob' | 'lightlink' | 'zeta' | 'nibiru' | 'abstract' | 'bitlayer' | 'mantra' | 'monad' | 'ink', required - `contract_address` string, required - `token_ids` string - `sort_by` 'created_date' | 'last_transfer_date' - `cursor` string - `limit` integer, required ## Response `200` OK - ApiResponseAssetFilterList - `code` integer — Error Code - `msg` string — Error Message - `data` AssetFilterList — Return data, Generic - `pageInfo` PageInfo — Page infomation - `startCursor` string - `endCursor` string - `hasPreviousPage` string - `hasNextPage` string - `assetList` AccountAsset[] — Asset filter list - `cursor` string — The cursor of this list in system. - `asset` AssertFilter — Asset data. - `id` string - `chain` string — Chain name - `chainId` string — Chain id - `contractAddress` string — Contract address - `tokenId` string — Token id - `tokenType` string — Token type - `creatorAddress` string — Creator address - `name` string — Asset name - `description` string — Asset description - `supply` integer — Supply count - `createTime` string, date-time — The time when the asset was minted - `metaUpdateAt` string, date-time — The time when the meta was last updated - `properties` AssetProperty[] — Asset attribute list - `displayType` string — PROPERTY: value is string, STATS: value is a number, it may have a maximum value named maxValue, DATES: value is a Unix timestamp - `key` string - `value` string - `maxValue` string - `traitCount` integer — Number of attribute values - `traitTotal` integer — Total attribute keys - `traitSupply` integer — Total contract count - `levels` AssetLevel[] — Asset level list - `key` string - `value` string - `max` string - `stats` AssetStat[] — Asset Statistical data list - `key` string - `value` string - `max` string - `imageUrl` string - `imagePreviewUrl` string - `imageThumbnailUrl` string - `animationUrl` string - `externalUrls` string[] — External link address - `metadataUrl` string - `collection` Collection — The collection of this contract - `id` string - `name` string — Collection name - `slug` string — Collection slug - `description` string — Collection description - `royalty` integer — Copyright royalty - `createDate` string — createDate - `royaltyAddress` string — Royalty Address - `platformSellerFee` integer — Service charge charged by the platform - `platformSellerAddress` string — Service charge address by the platform - `imageUrl` string - `bannerImageUrl` string - `featuredImageUrl` string - `externalUrl` string - `twitterUrl` string - `instagramUrl` string - `facebookUrl` string - `mediumUrl` string - `telegramUrl` string - `discordUrl` string - `contracts` CollectionContract[] — Contract list about this collection - `blockChain` BlockChain — Chain information - … - `address` string — Contract address - `alias` string — Contract alias - `category` ContractCategory — Contract category - … - `owners` Account[] - `identity` Identity — Identification - … - `isVerified` boolean - `stats` CollectionStats — Simple field Collection Stats - `ownerCount` integer — Total number of owners - `assetCount` integer — Total number of asset - `owners` string[] — The asset owners address list. - `orderData` OrderData — Asset order data. - `bestAsk` AssetOrder - `chain` string — Chain Name - `chainId` string — Chain ID - `orderHash` string — Order Hash - `orderId` string — Order Id - `expirationTime` integer — Order expiration time - `listingTime` integer — Order listing time - `createTime` integer — Order create time - `maker` string — The order maker's wallet address - `taker` string — The order taker's wallet address - `side` integer — Side of the order. 0 for buy orders and 1 for sell orders. - `saleKind` integer — Kind of sell order. 0 for standard order, 3 for bulk listings, 7 for collection offer. - `paymentToken` string — The address of the smart contract of the payment token that is accepted or offered by the order - `quantity` string — The asset quantity of order. - `priceBase` number — The price in the base currency of the current chain (Ethereum is converted to eth, bsc is bnb), the unit is ether. - `priceUSD` number — The order price in USD. - `price` number — The order price in paymentToken, the unit is ether. - `standard` string — The order trading Standards. - `contractAddress` string — Asset contract address - `tokenId` string — Asset token id - `schema` string — Asset schema - `extra` string — Additional information - `exchangeData` string — Additional information - `paymentTokenCoin` CoinInfo - `id` string - `name` string - `address` string - `icon` string - `symbol` string - `decimal` integer - `accuracy` integer - `chain` string - `chainId` string - `bestBid` AssetOrder - `chain` string — Chain Name - `chainId` string — Chain ID - `orderHash` string — Order Hash - `orderId` string — Order Id - `expirationTime` integer — Order expiration time - `listingTime` integer — Order listing time - `createTime` integer — Order create time - `maker` string — The order maker's wallet address - `taker` string — The order taker's wallet address - `side` integer — Side of the order. 0 for buy orders and 1 for sell orders. - `saleKind` integer — Kind of sell order. 0 for standard order, 3 for bulk listings, 7 for collection offer. - `paymentToken` string — The address of the smart contract of the payment token that is accepted or offered by the order - `quantity` string — The asset quantity of order. - `priceBase` number — The price in the base currency of the current chain (Ethereum is converted to eth, bsc is bnb), the unit is ether. - `priceUSD` number — The order price in USD. - `price` number — The order price in paymentToken, the unit is ether. - `standard` string — The order trading Standards. - `contractAddress` string — Asset contract address - `tokenId` string — Asset token id - `schema` string — Asset schema - `extra` string — Additional information - `exchangeData` string — Additional information - `paymentTokenCoin` CoinInfo - `id` string - `name` string - `address` string - `icon` string - `symbol` string - `decimal` integer - `accuracy` integer - `chain` string - `chainId` string - `accountOrder` AssetOrder - `chain` string — Chain Name - `chainId` string — Chain ID - `orderHash` string — Order Hash - `orderId` string — Order Id - `expirationTime` integer — Order expiration time - `listingTime` integer — Order listing time - `createTime` integer — Order create time - `maker` string — The order maker's wallet address - `taker` string — The order taker's wallet address - `side` integer — Side of the order. 0 for buy orders and 1 for sell orders. - `saleKind` integer — Kind of sell order. 0 for standard order, 3 for bulk listings, 7 for collection offer. - `paymentToken` string — The address of the smart contract of the payment token that is accepted or offered by the order - `quantity` string — The asset quantity of order. - `priceBase` number — The price in the base currency of the current chain (Ethereum is converted to eth, bsc is bnb), the unit is ether. - `priceUSD` number — The order price in USD. - `price` number — The order price in paymentToken, the unit is ether. - `standard` string — The order trading Standards. - `contractAddress` string — Asset contract address - `tokenId` string — Asset token id - `schema` string — Asset schema - `extra` string — Additional information - `exchangeData` string — Additional information - `paymentTokenCoin` CoinInfo - `id` string - `name` string - `address` string - `icon` string - `symbol` string - `decimal` integer - `accuracy` integer - `chain` string - `chainId` string - `message` string ## Other responses - `400` — Bad Request - `429` — Too Many Requests - `500` — Internal Server Error --- [API](https://skmtc.net/element/apis/element-open-api.md) · [All operations](https://skmtc.net/element/apis/element-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/element/element-open-api/versions/fa83ac7feb23/schema)