Get Listings Batch

updated as of 5/9/2023

Gets multiple listings at once

POST https://marketplace.api.manifoldxyz.dev/listing/{marketplaceAddress}/batch

Given a marketplaceAddress and an array of listingIds fetch and return all the info for those listings.

*Note: The marketplaceAddress for Manifold's Ethereum Mainnet contract is 0x3a3548e060be10c2614d0a4cb0c03cc9093fd799

Path Parameters

Name	Type	Description
marketplaceAddress*	String	The Manifold marketplace contract address

Request Body

Name	Type	Description
listingIds	Array<String>	An array of strings of the listingIds you want to fetch

200: OK OK

[{
	"id": "5573",
	"seller": "0x03ee832367e29a5cd001f65093283eabb5382b62",
	"receivers": [
		["0x03ee832367e29a5cd001f65093283eabb5382b62", 9000],
		["0x3a0079197027d80c260f8cd482210fdc48ec51e5", 1000]
	],
	"details": {
		"type_": 1,
		"initialAmount": {
			"type": "BigNumber",
			"hex": "0x038d7ea4c68000"
		},
		"totalAvailable": "1",
		"totalPerSale": "1",
		"extensionInterval": 900,
		"minIncrementBPS": 500,
		"erc20": null,
		"identityVerifier": null,
		"startTime": 1683651600,
		"endTime": 1683741600
	},
	"token": {
		"spec": "erc721",
		"address_": "0xd90829c6c6012e4dde506bd95d7499a04b9a56de",
		"id": {
			"type": "BigNumber",
			"hex": "0x02"
		},
		"lazy": false,
		"thumbnail": {
			"image_status": "ok",
			"image_url": "https://assets.manifold.xyz/image/upload/c_limit,q_80,w_300/3VqFpPonZfq5QCFda5xZlu42Q2NdiPcSWdA0xeklcwQ_wejicr.webp",
			"animation_status": "ok",
			"animation_url": ""
		},
		"metadata": {
			"name": "There is no piano",
			"image": "https://arweave.net/3VqFpPonZfq5QCFda5xZlu42Q2NdiPcSWdA0xeklcwQ",
			"image_url": "https://arweave.net/3VqFpPonZfq5QCFda5xZlu42Q2NdiPcSWdA0xeklcwQ",
			"attributes": [{
				"value": "ACK",
				"trait_type": "Artist"
			}],
			"created_by": "Alpha Centauri Kid",
			"description": "There is nothing at all.\n\n\n\n\n\n\n1 of 1 / The Broken Keys Piano Collection / ACK / 2023",
			"image_details": {
				"bytes": 2860759,
				"width": 3840,
				"format": "PNG",
				"height": 2160,
				"sha256": "99de149a8021c377024e1d1a2060e5b11a7116a25818317057f88d146984b312"
			}
		}
	},
	"referrerBPS": 0,
	"fees": {
		"deliverBPS": null,
		"deliverFixed": null
	},
	"bid": {
		"amount": {
			"type": "BigNumber",
			"hex": "0x00"
		},
		"timestamp": 0,
		"bidder": ""
	},
	"finalized": false,
	"address": "0x3a3548e060be10c2614d0a4cb0c03cc9093fd799",
	"version": 2,
	"createdAt": 1683563681.517
}, {
	"id": "5574",
	"seller": "0x557c60995797fa7b47be105227a2e46148d85750",
	"receivers": [
		["0x557c60995797fa7b47be105227a2e46148d85750", 10000]
	],
	"details": {
		"type_": 1,
		"initialAmount": {
			"type": "BigNumber",
			"hex": "0x3b9aca00"
		},
		"totalAvailable": "1",
		"totalPerSale": "1",
		"extensionInterval": 600,
		"minIncrementBPS": 500,
		"erc20": null,
		"identityVerifier": null,
		"startTime": 1683574200,
		"endTime": 3861113400
	},
	"token": {
		"spec": "erc721",
		"address_": "0xeaa307991ffcf6bef170468a11e1d8017af60fa7",
		"id": {
			"type": "BigNumber",
			"hex": "0x2c"
		},
		"lazy": false,
		"thumbnail": {
			"image_status": "ok",
			"image_url": "https://assets.manifold.xyz/image/upload/c_limit,q_80,w_300/4kND0mQ5rCHI34uxJ2H4q0q36HTwPBizpu5Kc-ex5P8_kezhsd.webp",
			"animation_status": "ok",
			"animation_url": ""
		},
		"metadata": {
			"name": "The Skull",
			"image": "https://arweave.net/4kND0mQ5rCHI34uxJ2H4q0q36HTwPBizpu5Kc-ex5P8",
			"image_url": "https://arweave.net/4kND0mQ5rCHI34uxJ2H4q0q36HTwPBizpu5Kc-ex5P8",
			"attributes": [{
				"value": "Apehammer",
				"trait_type": "Artist"
			}, {
				"value": "Art",
				"trait_type": "Type"
			}, {
				"value": "Minimalism",
				"trait_type": "Origin"
			}, {
				"value": "2023",
				"trait_type": "Year"
			}],
			"created_by": "Apehammer",
			"description": "Patience is a dish best served cold. \n\nDigital graphic art made in p5.js",
			"image_details": {
				"bytes": 63968,
				"width": 4000,
				"format": "PNG",
				"height": 4000,
				"sha256": "b60af2f23a79c1ae0bb5bd41e8c74c300d5797cef7ce3be292e19ff103f78f88"
			}
		}
	},
	"referrerBPS": 690,
	"fees": {
		"deliverBPS": null,
		"deliverFixed": null
	},
	"bid": {
		"amount": {
			"type": "BigNumber",
			"hex": "0x00"
		},
		"timestamp": 0,
		"bidder": ""
	},
	"finalized": false,
	"address": "0x3a3548e060be10c2614d0a4cb0c03cc9093fd799",
	"version": 2,
	"createdAt": 1683573807.377
}]

404: Not Found Not Found

{
     "error": "No listing found with marketplaceAddress: X and listingId: Y"
}

Example curl

curl -X POST -d '{"listingIds":["5573","5574"]}' https://marketplace.api.manifoldxyz.dev/listing/0x3a3548e060be10c2614d0a4cb0c03cc9093fd799/batch

Where Can I Find the ListingIDs?

The listingID can be found within the Gallery app of Manifold Studio