Skip to main content
All CollectionsDeveloper ToolsOther Guides and FAQ's
Listing Your Bitcoin Ordinals Collection on Magic Eden
Listing Your Bitcoin Ordinals Collection on Magic Eden

Listing your ordinals collection on Magic Eden.

Updated over a month ago

This guide will walk you through the process of listing Bitcoin Ordinal inscriptions on Magic Eden, including the different JSON formats accepted by the platform.

Inscription IDs only

The simplest way to list Bitcoin Ordinal inscriptions on Magic Eden is by providing the inscription IDs. Here is an example JSON format:

[
{
"id": "0f626bcfc3a33e8afd69a570f1dd65bf4201d3454cc07bb2d2f972db28b03a9bi0"
},
{
"id": "e66cc4d665a535ce3c9bc351365d7d179a87c6f430f51b2409b84c557bf89fc7i0"
},
{
"id": "643e419b0f09fe0fa9b27df6a2ee19417c68e2656e8777515f2728ce2a182087i0"
},
{
"id": "211df992eb3019f4a2e9e777fbd257018e80ab0eaf27bea60e63d9f0aeadee5bi0"
}
]

Make sure to replace the id values with the actual Bitcoin Ordinal inscription IDs you want to list.

Metadata with name only

To provide more information about the Bitcoin Ordinal inscriptions, you can include the inscription names along with the IDs. Here is an example JSON format:

[
{
"id": "0f626bcfc3a33e8afd69a570f1dd65bf4201d3454cc07bb2d2f972db28b03a9bi0",
"meta": {
"name": "Bitcoin Bandit #1"
}
},
{
"id": "e66cc4d665a535ce3c9bc351365d7d179a87c6f430f51b2409b84c557bf89fc7i0",
"meta": {
"name": "Bitcoin Bandit #2"
}
},
{
"id": "643e419b0f09fe0fa9b27df6a2ee19417c68e2656e8777515f2728ce2a182087i0",
"meta": {
"name": "Bitcoin Bandit #3"
}
},
{
"id": "211df992eb3019f4a2e9e777fbd257018e80ab0eaf27bea60e63d9f0aeadee5bi0",
"meta": {
"name": "Bitcoin Bandit #4"
}
}
]

In this format, each inscription object includes an id and a meta object containing the name of the inscription.

Metadata with inscription IDs, name, attributes but no high-resolution image link

This will be useful for creators who do not want to include a high-resolution image link.

[
{
"id": "0f626bcfc3a33e8afd69a570f1dd65bf4201d3454cc07bb2d2f972db28b03a9bi0",
"meta": {
"name": "Bitcoin Bandit #1",
"attributes": [
{
"trait_type": "Clan",
"value": "Aoi"
},
{
"trait_type": "Class",
"value": "Warrior"
}
]
}
},
// Additional entries...
]

Metadata with inscription IDs, name, attributes, and high-resolution image link

This format is useful for projects that want to provide larger, more detailed art than what is stored on the Bitcoin blockchain. You can leave out attribute information if you only want to include the high-resolution image. Here is an example JSON:

[
{
"id": "0f626bcfc3a33e8afd69a570f1dd65bf4201d3454cc07bb2d2f972db28b03a9bi0",
"meta": {
"name": "Bitcoin Bandit #1",
"high_res_img_url": "https://hi_res_img.png",
"attributes": [
{
"trait_type": "Clan",
"value": "Aoi"
},
{
"trait_type": "Class",
"value": "Warrior"
}
]
}
},
{
"id": "e66cc4d665a535ce3c9bc351365d7d179a87c6f430f51b2409b84c557bf89fc7i0",
"meta": {
"name": "Bitcoin Bandit #2",
"high_res_img_url": "https://hi_res_img.png",
"attributes": [
{
"trait_type": "Clan",
"value": "Aoi"
},
{
"trait_type": "Class",
"value": "Warrior"
}
]
}
},
{
"id": "643e419b0f09fe0fa9b27df6a2ee19417c68e2656e8777515f2728ce2a182087i0",
"meta": {
"name": "Bitcoin Bandit #3",
"high_res_img_url": "https://hi_res_img.png",
"attributes": [
{
"trait_type": "Clan",
"value": "Aoi"
},
{
"trait_type": "Class",
"value": "Warrior"
}
]
}
},
{
"id": "211df992eb3019f4a2e9e777fbd257018e80ab0eaf27bea60e63d9f0aeadee5bi0",
"meta": {
"name": "Bitcoin Bandit #4",
"high_res_img_url": "https://hi_res_img.png",
"attributes": [
{
"trait_type": "Clan",
"value": "Aoi"
},
{
"trait_type": "Class",
"value": "Warrior"
}
]
}
}
]

In this format, each inscription object includes an id and a meta object containing the name, high_res_img_url, and attributes of the inscription. The attributes can provide additional information about the inscription, these can be determined by the creator of the project.

Make sure to replace the placeholder values with the actual information for your Bitcoin Ordinal inscriptions.

We recommend that you host your high-resolution image on a decentralised storage platform such as IPFS.

If you need assistance with formatting your JSON data, you can use the website jsonformatter.org. It can be a helpful resource when working with complex JSON structures or when you want to ensure your code follows the correct syntax.

By following this guide and providing the necessary information in the appropriate JSON format, you will be able to list Bitcoin Ordinal inscriptions on Magic Eden and make them available for trading and sale on the platform.

Did this answer your question?