Proxy List / Copy Listing

Unified API to bulk list Ordinals or copy existing but standalone listings from source marketplace to all marketplaces via Ordyssey

Bulk Listing

1. Please watch the demo video by Ordyssey first.

2. It's an example UI by Ordyssey, we called it MegaListing. You can use this endpoint to implement it.

Ordyssey MegaListing UI

1. Bulk listing makes sellers' listing orders more efficient without having to visit various marketplace websites.

2. And due to the combined effect of multiple liquidity factors, sellers will receive bids faster.

Copy Listing

1. Definition: Based on the seller’s existing listings (if only listed on a single marketplace, we call them standalone here), expand/promote these offers to other marketplaces as much as possible

2. Auto Algorithm: Our backend will automatically generate corresponding unsigned PSBTs for all scalable offers based on the standalone listings under the seller's address.

Generate unsigned PSBTs

Tips for Unisat Wallet You can pass the multiple unsigned PSBTs together intoawait unisat.signPsbts()to drive your users sign them easily with just a single Unisat signing session.

Concurrently apply for batch list requests to various marketplaces.

POST https://open-api.ordyssey.com/v1/dex/bulk_listing/gen_unsigned

Request Body

Name	Type	Description
copy_mode	Any	Copy Listing function here. If pass it, we will auto-generate marketplace_to_token_prices according to the existing but standalone listings by seller. So only one of copy_mode and marketplace_to_token_prices are required. But copy_mode will be given priority in selecting.
marketplace_to_token_prices	JSON	Key: Marketplace name Value: Token with listing prices For example: {"magiceden":{"cf3ab4e342a6d0af322740ea41ac7cb17a4b5774709270ae7c45e2287e02bbf4i0":2000000}, "ordinalswallet":{"cf3ab4e342a6d0af322740ea41ac7cb17a4b5774709270ae7c45e2287e02bbf4i0":2000000, "f446b24dc13456c94613d48de1e6bb4f5a4d6ecc76ac254b2f934612f7c4980bi0":2000000}}
seller*	String	Seller BTC address, the Ordinals address
seller_receive_address*	String	Seller BTC address to receive payment BTC, default is equal with the seller field
seller_wallet_provider*	String	One of unisat, okx, leather, xverse
seller_pubkey*	String	Seller public key of BTC address
with_unparsed	Any	Return fields of unparsed response by source marketplaces

200: OK

{
    "order_uuid": "9a52437b-f0a2-4c08-a434-84ffba442fca",
    // Save the order_uuid, you need this in the next step
    "result": {
        "ordinalswallet": {
            "unsigned_psbt_base64": "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"
        },
        "magiceden": {
            "unsigned_psbt_base64": "cHNidP8BAF4CAAAAAVXz5vYNxP/KI1QJGGxjZtqjQ64qeH2SUXxZtVqDWFHFAQAAAAD/////ATR/eQUAAAAAIlEgWsOQ0ZoqzIVq0cMkfBfOjgsWvpUq5Rhjb0DYHo9P4UsAAAAAAAEA/RAEAgAAAAABBd1uvbOn7sCL28K84astuAE42/sToPZGg3aBfFymYVwhCAAAABcWABTffPTjP+ypvpLhSP5XKgQ8lNbgg/////+Usil4LPFvZe49jBWps4IMX56UM2XTSSK4xSa7Fkg0bwAAAAAXFgAU33z04z/sqb6S4Uj+VyoEPJTW4IP/////e9gdzqOcgowiJpsRa/bTrOyJZQ8aRkZcyrsJ1vsD3w8AAAAAAP////+7GQq31TctkSfwxOAu/ulswKg2kv/5RQqxIJcQu7F7rCEAAAAXFgAU33z04z/sqb6S4Uj+VyoEPJTW4IP/////lLIpeCzxb2XuPYwVqbOCDF+elDNl00kiuMUmuxZING8KAAAAFxYAFN989OM/7Km+kuFI/lcqBDyU1uCD/////wewBAAAAAAAABepFPXDpeVJbKS7Ye0xMxMpz4+S6u/DhxAnAAAAAAAAIlEgrTniUbIprxN0CVWRAOxEteSysV56Jnuvz8U7ZJNNsmBJL4YGAAAAABepFJkPM73j+xfRi+lSBbPgU/J/Uc4dhzD2KQAAAAAAFgAUwBXGUnbV841ZnURcTLA6p6oNw2VYAgAAAAAAABepFPXDpeVJbKS7Ye0xMxMpz4+S6u/Dh1gCAAAAAAAAF6kU9cOl5UlspLth7TEzEynPj5Lq78OHpb8KAAAAAAAXqRT1w6XlSWyku2HtMTMTKc+Pkurvw4cCRzBEAiAaNrc0WKezPta0sZOSGmcahAm1AxwgrVk0Z00dDaU2OgIgPHBLCTQ87c9+B57keSih5ADIuoZ+oRWq1i1G6fGDqZsBIQIdyCtwAvEbxuv/DibReeaamJLYSIum0P8ic4Uq3NprbgJHMEQCIA27pZV2vm/jFnj5S2t6m3aPu3UOak/Zi8arUVqUe72OAiBvss5yDKPe0jty4mRVnSrb9k4n3VYMl6b3xrcLZKmdxgEhAh3IK3AC8RvG6/8OJtF55pqYkthIi6bQ/yJzhSrc2mtuAUHEYBqUbQR1ZEwj3TBgB6Yhg+I86CGNuMhs/57r9M1fbroK0129Wx2+zzu32YdRYmt+2NNpAqd1NcHYeyfE17TIgwJIMEUCIQC11UbmfHdgh0rxuBPeMXrpcLxTrhdT979b0gpY0c2s/gIgWhzSH8QxfZqCpXo1/L/wj99GFgRRNwgdoJx6YFLE6BIBIQIdyCtwAvEbxuv/DibReeaamJLYSIum0P8ic4Uq3NprbgJIMEUCIQDXmF0TzS9hk3PzvHayDFll93kv8Z5p5QVVa0ooIdDqoAIgfigt7wv51F62XgmLtVLbC8d2XVrfhR4WdIm9Cg2kMnIBIQIdyCtwAvEbxuv/DibReeaamJLYSIum0P8ic4Uq3NprbgAAAAABASsQJwAAAAAAACJRIK054lGyKa8TdAlVkQDsRLXksrFeeiZ7r8/FO2STTbJgAQMEgwAAAAEXIFoXDEuMdoupdKNB0JEbBHpBHHxgOV42OtIbS7TdNRgUAAA="
        }
    }
} 
// Note: You can pass the 2 unsigned together into `await unisat.signPsbts()`, 
// so that user can sign them easily in a single Unisat signing session.

400: Bad Request

Send back signed PSBTs

Submit all signed PSBTs to Ordyssey and obtain the listing results concurrently.

POST https://open-api.ordyssey.com/v1/dex/bulk_listing/callback_signed

Request Body

Name	Type	Description
order_uuid*	String	The unique identifier of the bulk listing order, which is generated by the previous step
signed_psbts_base64*	JSON	Key: Marketplace name Value: Signed PSBT Base64 {"ordinalswallet":"cHNidP8BALIBAAAAAlXz5vYNxP/KI1QJGGxjZtqjQ64qeH2SUXxZtVqDWFHFAQAAAAD9", "magiceden":"cHNidP8BALIBAAAAAlXz5vYNxP/KI1QJGGxjZtqjQ64qeH2SUXxZtVqDWFHFAQAAAAD9"}

400: Bad Request

{
    "order_uuid": "9a52437b-f0a2-4c08-a434-84ffba442fca",
    "order_status": "failed",
    "result": {
        "magiceden": {
            "unparsed_response": {
                "ok": true,
                "listed": 0,
                "failed": [
                    "9e1c56fbbd0dcef0cc5b4b5258048baddd145eb63c0e94acaf38c9f826535abei0"
                ]
            },
            "parsed_status": "failed"
        },
        "ordinalswallet": {
            "unparsed_response": {
                "error": true,
                "message": "failed to deserialize psbt hex"
            },
            "error": "failed to deserialize psbt hex",
            "parsed_status": "failed"
        }
    }
}

200: OK