NFT API

API Reference

Get Collections

Get Collections

GET https://open-api.openocean.finance/nft/v2/:chain/collections

Query Parameters

fuzzy match collection name response:

{
    "code":0,
    "data":[
        {
            "id":"0xaadba140ae5e4c8a9ef0cc86ea3124b446e3e46a",
            "slug":"mutantcats",
            "name":"MutantCats",
            "image":"https://i.seadn.io/gcs/files/785aa6b9f07435e690956aa27ada6eee.png?w=500&auto=format",
            "primaryContract":"0xaadba140ae5e4c8a9ef0cc86ea3124b446e3e46a",
            "discordUrl":"https://discord.gg/mutantcats",
            "twitterUsername":"mutantcatsDAO",
            "description":"9,999 cats mutated by a disease on the Ethereum blockchain. Each Mutant Cat NFT grants access to the exclusive DAO community and voting rights over the DAO's assets.",
            "tokenCount":"9999",
            "onSaleCount":"120",
            "floorAskPrice":0.145,
            "floorPrice":{
                "symbol":"ETH",
                "icon":"https://cloudstorage.openocean.finance/images/1637894743832_8242841824007741.png",
                "value":0.145
            },
            "offerMinPrice":0.0145,
            "isCollectionOffersEnabled":true,
            "volume":{
                "1day":1.677,
                "7day":10.29991,
                "30day":45.00287,
                "allTime":16854.96768
            },
            "volumeChange":{
                "1day":11.893617021276595,
                "7day":0.6539036675936096,
                "30day":1.757470164370173
            },
            "isVerified":true
        }
    ]
}

Get Asset

Get Asset

GET https://open-api.openocean.finance/nft/v1/:chain/assets

Query Parameters

{
    "code": 0,
    "message": "ok",
    "next": "MTAwMDAwMDAwMDAwMDAwMF8yNTQx",
    "data": [
        {
            "tokenId": "1",
            "tokenAddress": "0x1da1c30436ed44774406daeeef26860791fb48cb",
            "name": "The Other Side",
            "description": "Appearances can be deceiving.\nSometimes it hides something else.",
            "owner": {
                "user": {
                    "username": "19YAKIM87"
                },
                "profile_img_url": "https://storage.googleapis.com/opensea-static/opensea-profile/2.png",
                "address": "0xd71bc875138433e62f2b29117d64dff88f038e68",
                "config": ""
            },
            "assetContract": {
                "name": "Diary of the Future",
                "description": null,
                "type": "non-fungible",
                "schemaName": "ERC721",
                "address": "0x1da1c30436ed44774406daeeef26860791fb48cb",
                "tokenSymbol": "10",
                ...
            },
            "collection": {
                "createdDate": "2022-06-01T09:50:54.797Z",
                "name": "Diary of the Future",
                "description": null,
                "slug": "diary-of-the-future",
                "hidden": false,
                ...
            },
            "orders": null,
            "sellOrders": [{market: '', order: ''}],
            "buyOrders": null,
            ...
            "transferFee": null,
            "transferFeePaymentToken": null
        }
    ]
}

Get Buy Transaction

Get Buy Transaction

POST https://open-api.openocean.finance/nft/v1/:chain/buy

Path Parameters

Request Body

{
    "code":0,
    "message":"ok",
    "data":{
        "from":"0x36b35012F3728105ea3f49830ccdFBa615C1d8c9",
        "data":"0x09ba153d000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000001400000000000000000000000000000000000000000000000000000000000000660000000000000000000000000000000000000000000000000000000000000120000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000100000000000000000000000049d5c2bdffac6ce2bfdb6640f4f80f226bc10bab000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000071e49281a63e20000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000226abadc42f80000000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000044481ae255a000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000c000000000000000000000000076daaaf7711f0dc2a34bca5e13796b7c5d862b53000000000000000000000000000000000000000000000000000000000000570c00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000226abadc42f8000000000000000000000000000000000000000000000000000000000000000034cfb0f3ee10000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000223ead2047c1000000000000000000000000000e70adc8cb03979307d6f7a7a075f9b577c474b1c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000076daaaf7711f0dc2a34bca5e13796b7c5d862b53000000000000000000000000000000000000000000000000000000000000570c000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063f7bf87000000000000000000000000000000000000000000000000000000006404ac900000000000000000000000000000000000000000000000000000000000000000360c6ebe00000000000000000000000000000000000000009d3b7705c2e31cbf0000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f00000000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f00000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000024000000000000000000000000000000000000000000000000000000000000002a000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000002c0dbbfb370000000000000000000000000000000a26b00c1f0df003000390027140000faa719000000000000000000000000000000000000000000000000000000000000004168b879d570171abddcee01ac1961cf6056f81ff42aad2221b35b52320a86172d137cdada3b45339c6b873394bbaaea946e1ce172c3b7ec65818a5c10f818301f1c0000000000000000000000000000000000000000000000000000000000000000000000360c6ebe0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000b04593427b6000000000000000000000000000000000000000000000000000000000000010000000000000000000000000049d5c2bdffac6ce2bfdb6640f4f80f226bc10bab00000000000000000000000000000000000000000000000000071e49281a63e20000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000009c490411a3200000000000000000000000007749429d3d9047a966b28a489500325bac9f1b6000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000001c000000000000000000000000049d5c2bdffac6ce2bfdb6640f4f80f226bc10bab000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007749429d3d9047a966b28a489500325bac9f1b600000000000000000000000022c389e690b33842bf9430104c59d2b3916c1aa700000000000000000000000000000000000000000000000000071e49281a63e2000000000000000000000000000000000000000000000000027d8c6464debb3c0000000000000000000000000000000000000000000000000283fd008f433e6b00000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000014000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000460000000000000000000000000000000000000000000000000000000000000058000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000104aeba9ec10000000000000000000000001701a7e5034ed1e35c52245ab7c07dbdaf353de7000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000071e49281a63e200000000000000000000000007749429d3d9047a966b28a489500325bac9f1b600000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002b49d5c2bdffac6ce2bfdb6640f4f80f226bc10bab000028b31f66aa3c1e785363f0875a1b74e27b85fd66c700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000001649f865422000000000000000000000000b31f66aa3c1e785363f0875a1b74e27b85fd66c7000000000000000000000000000000010000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000004000000000000000000000000b31f66aa3c1e785363f0875a1b74e27b85fd66c700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000242e1a7d4d00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000648a6a1e850000000000000000000000000000000000000000000000000000000000000000000000000000000000000000353c1f0bc78fbbc245b3c93ef77b1dcc5b77d2a02710000000000000000000000000000000000000000000000283fd008f433e6b00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000001a49f865422000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000004400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000064d1660f99000000000000000000000000000000000000000000000000000000000000000000000000000000000000000022c389e690b33842bf9430104c59d2b3916c1aa70000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
        "to":"0x22c389e690b33842bf9430104c59d2B3916C1Aa7",
        "value":"0x",
        "approve":[
            {
                "from":"0x36b35012f3728105ea3f49830ccdfba615c1d8c9",
                "data":"0x095ea7b300000000000000000000000022c389e690b33842bf9430104c59d2b3916c1aa7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                "to":"0x49D5c2BdFfac6CE2BFdB6640F4F80f226bc10bAB",
                "value":"0x"
            }
        ]
    }
}

Get Sell Signature Data

Get Sell Signature Data

POST https://open-api.openocean.finance/nft/v1/:chain/sell

Path Parameters

Request Body

{
    "code": 0,
    "message": "ok",
    "data": {
        "makerOrder": { // Order data for signature
            "isOrderAsk": true,
            "signer": "0x1cad209a2022747a0c8c538ee7d99fd1060fd175",
            "collection": "0xd4C4643053E46eacffa06E2573641907a54125Fb",
            "price": "100000000000000",
            "tokenId": "318",
            "amount": "1",
            "strategy": "0x732319A3590E4fA838C111826f9584a9A2fDEa1a",
            "currency": "0xc778417E063141139Fce010982780140Aa0cD5Ab",
            "nonce": 0,
            "startTime": 1655363481,
            "endTime": 1655449881,
            "minPercentageToAsk": 8500,
            "params": []
        },
        "orderHash": "0xda105357dab470fb524e4c4c22ad9b00d21b5ae0fc38327bc92268f4c77df4bc" // unique to x2y2
        "approve": { // approve data
            "from": "0x1cad209a2022747a0c8c538ee7d99fd1060fd175",
            "data": "0xa22cb4650000000000000000000000003f65a762f15d01809cdc6b43d8849ff24949c86a0000000000000000000000000000000000000000000000000000000000000001",
            "to": "0xd4C4643053E46eacffa06E2573641907a54125Fb",
            "value": "0x"
        }
    }
}

Get offer signature data

Get offer signature data

POST https://open-api.openocean.finance/nft/v1/:chain/offer

Path Parameters

Request Body

{
    "code": 0,
    "message": "ok",
    "data": {
        "makerOrder": { // Order data for signature
            "isOrderAsk": true,
            "signer": "0x1cad209a2022747a0c8c538ee7d99fd1060fd175",
            "collection": "0xd4C4643053E46eacffa06E2573641907a54125Fb",
            "price": "100000000000000",
            "tokenId": "318",
            "amount": "1",
            "strategy": "0x732319A3590E4fA838C111826f9584a9A2fDEa1a",
            "currency": "0xc778417E063141139Fce010982780140Aa0cD5Ab",
            "nonce": 0,
            "startTime": 1655363481,
            "endTime": 1655449881,
            "minPercentageToAsk": 8500,
            "params": []
        },
        "orderHash": "0xda105357dab470fb524e4c4c22ad9b00d21b5ae0fc38327bc92268f4c77df4bc" // unique to x2y2
        "approve": { // approve data
            "from": "0x1cad209a2022747a0c8c538ee7d99fd1060fd175",
            "data": "0xa22cb4650000000000000000000000003f65a762f15d01809cdc6b43d8849ff24949c86a0000000000000000000000000000000000000000000000000000000000000001",
            "to": "0xd4C4643053E46eacffa06E2573641907a54125Fb",
            "value": "0x"
        }
    }
}

Submit Order

Submit Order

POST https://open-api.openocean.finance/nft/v1/:chain/sign

Path Parameters

Request Body

{
    "code": 0,
    "message": "ok"
}

Get Rankings

Get Rankings

GET https://open-api.openocean.finance/nft/v2/:chain/rankings

Query Parameters

{
    "code":0,
    "message":"ok",
    "data":[
        {
            "id":"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
            "slug":"boredapeyachtclub",
            "name":"Bored Ape Yacht Club",
            "image":"https://i.seadn.io/gae/Ju9CkWtV-1Okvf45wo8UctR-M9He2PjILP0oOvxE89AyiPPGtrR3gysu1Zgy0hjd2xKIgjJJtWIc0ybj4Vd7wv8t3pxDGHoJBzDB?w=500&auto=format",
            "primaryContract":"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
            "discordUrl":"https://discord.gg/3P5K3dzgdB",
            "twitterUsername":"BoredApeYC",
            "description":"The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs— unique digital collectibles living on the Ethereum blockchain. Your Bored Ape doubles as your Yacht Club membership card, and grants access to members-only benefits, the first of which is access to THE BATHROOM, a collaborative graffiti board. Future areas and perks can be unlocked by the community through roadmap activation. Visit www.BoredApeYachtClub.com for more details.",
            "tokenCount":"10000",
            "onSaleCount":"359",
            "floorAskPrice":70.99,
            "floorPrice":{
                "symbol":"ETH",
                "icon":"https://cloudstorage.openocean.finance/images/1637894743832_8242841824007741.png",
                "value":70.99
            },
            "volume":{
                "1day":3214.9985,
                "7day":43249.40795,
                "30day":74316.84229,
                "allTime":1062155.90567
            },
            "volumeChange":{
                "1day":0.5175934773853805,
                "7day":3.064792334531978,
                "30day":1.5204050348567173
            },
            "isVerified":true
        }
    ],
    "total":97
}

Get Orders

Get Orders

GET https://open-api.openocean.finance/nft/v2/:chain/orders

Query Parameters

{
    "code":0,
    "data":[
        {
            "id":"0x4bfbc9593399323db54622d11a1456087c5037cb421c803dd59d74db20c8ee0e",
            "contract_address":"0x6187e7a47cebf45b307bf70d109ce343f60d2366",
            "collection":{
                "id":"0x6187e7a47cebf45b307bf70d109ce343f60d2366",
                "name":"RSTLSS ✕ CrypToadz",
                "image":"https://api.reservoir.tools/assets/v1?asset=d13dd00e722beffaf6c818fc35b7e75a0f01e25b25369d0f19bf2607ea756be739a9e5422975cef28aa5de22a273ef3a565924c4b60594d7f177802d4085e225d21f2912380356fce460d6243ce8e26f2573e7e40288fee9530d283ebd0a413d",
                "slug":"rstlss-cryptoadz"
            },
            "token_id":"1339",
            "name":"RSTLSS x CrypToadz #7053",
            "schema_name":"erc721",
            "market":"opensea",
            "price":"116000000000000000",
            "owner":"0x849213bb7f84bb720ede09ec8273f036f00ef4af",
            "status":"",
            "image_url":"https://api.reservoir.tools/assets/v1?asset=d13dd00e722beffaf6c818fc35b7e75a792a6b2d8fb6b393c2b54fc2b994ae2f3f577808e73f3f1ab37f59dd24d53e88027883b37aebf99b4592c4e797c1ae97ea4ed5a4d740f5709928267c775f4eff2573e7e40288fee9530d283ebd0a413d",
            "traits":[

            ],
            "code":"eyJzb3VyY2UiOiJpbmRleGVyIiwib3JkZXJJZCI6IjB4NGJmYmM5NTkzMzk5MzIzZGI1NDYyMmQxMWExNDU2MDg3YzUwMzdjYjQyMWM4MDNkZDU5ZDc0ZGIyMGM4ZWUwZSIsIm93bmVyIjoiMHg4NDkyMTNiYjdmODRiYjcyMGVkZTA5ZWM4MjczZjAzNmYwMGVmNGFmIiwicHJpY2UiOiIxMTYwMDAwMDAwMDAwMDAwMDAiLCJwb29sSWQiOm51bGx9",
            "paymentAsset":{
                "symbol":"ETH",
                "address":"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
                "decimals":18,
                "image":"https://cloudstorage.openocean.finance/images/1637894743832_8242841824007741.png"
            },
            "isFlagged":false
        }
    ],
    "next":"eyJyZXNlcnZpZXIiOiJNVE0wT1RBd01EQXdNREF3TURBd01EQXdYekI0TmpFNE4yVTNZVFEzWTJWaVpqUTFZak13TjJKbU56QmtNVEE1WTJVek5ETm1OakJrTWpNMk5sODBPVGc9In0"
}

Get NFT info

Get NFT info

GET https://open-api.openocean.finance/nft/v1/:chain/detail

Query Parameters

{
    "code":0,
    "message":"ok",
    "data":{
        "contract_address":"0x6187e7a47cebf45b307bf70d109ce343f60d2366",
        "collection":{
            "id":"0x6187e7a47cebf45b307bf70d109ce343f60d2366",
            "name":"RSTLSS ✕ CrypToadz",
            "image":"https://api.reservoir.tools/assets/v1?asset=d13dd00e722beffaf6c818fc35b7e75a0f01e25b25369d0f19bf2607ea756be739a9e5422975cef28aa5de22a273ef3a565924c4b60594d7f177802d4085e225d21f2912380356fce460d6243ce8e26f2573e7e40288fee9530d283ebd0a413d",
            "slug":"rstlss-cryptoadz"
        },
        "name":"RSTLSS x CrypToadz #7053",
        "image_url":"https://api.reservoir.tools/assets/v1?asset=d13dd00e722beffaf6c818fc35b7e75a792a6b2d8fb6b393c2b54fc2b994ae2f3f577808e73f3f1ab37f59dd24d53e88027883b37aebf99b4592c4e797c1ae97ea4ed5a4d740f5709928267c775f4eff2573e7e40288fee9530d283ebd0a413d",
        "schema_name":"erc721",
        "symbol":"",
        "description":"A small, warty, amphibious creature that resides in the metaverse.",
        "token_traits":[
            {
                "key":"Garment Artist",
                "kind":"string",
                "value":"RSTLSS",
                "tokenCount":1825,
                "onSaleCount":215,
                "floorAskPrice":0.116,
                "topBidValue":null,
                "createdAt":"2023-02-26T00:51:20.661Z"
            }
        ],
        "token_id":"1339",
        "paymentAssets":[
            {
                "id":"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
                "symbol":"ETH"
            }
        ],
        "isMakeOffer":false,
        "owner":{
            "address":"0x849213bb7f84bb720ede09ec8273f036f00ef4af"
        },
        "orders":[
            {
                "market":"opensea",
                "priceUsd":190.30759,
                "price":0.116,
                "end_at":1679794525000,
                "amount":"1",
                "code":"eyJzb3VyY2UiOiJpbmRleGVyIiwib3duZXIiOiIweDg0OTIxM2JiN2Y4NGJiNzIwZWRlMDllYzgyNzNmMDM2ZjAwZWY0YWYiLCJub25jZSI6IjB4MmM3NTIzZWNjMTk4ODMzNGViNzI5YjU5MmFhZWI4ZjIxY2I2YTEwZTQ3MGUzNmYzOGQxOGRlOGMwMjZkMmQ2NTM2MDgyODVkOWQxNjIzZmYxZGFjZTFkMTVlOTU5NTk1NjM5M2E2MDMyYzczNThiNmYyOTY0MjdiOWU5ODBhZTExYiIsInRpbWUiOiIiLCJwcmljZSI6IjExNjAwMDAwMDAwMDAwMDAwMCIsIm9yZGVySWQiOiIweDRiZmJjOTU5MzM5OTMyM2RiNTQ2MjJkMTFhMTQ1NjA4N2M1MDM3Y2I0MjFjODAzZGQ1OWQ3NGRiMjBjOGVlMGUifQ",
                "paymentAsset":{
                    "symbol":"ETH",
                    "address":"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
                    "decimals":18,
                    "image":"https://cloudstorage.openocean.finance/images/1637894743832_8242841824007741.png"
                }
            }
        ],
        "isFlagged":false
    }
}

Get Token Quote

Get Token Quote

POST https://open-api.openocean.finance/nft/v1/:chain/quote

Path Parameters

Request Body

{
    "code": 0,
    "message": "ok",
    "data": [
        {
            "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
            "amount": 1500000000000000000,
            "outAmount": "3241563615936904222198",
            "estimatedGas": "180452"
        }
    ]
}

Owner NFTs

Owner NFTs

GET https://open-api.openocean.finance/nft/v1/:chain/nfts?address=0x&cursor=1

Query Parameters

{
    "code":0,
    "data":[
        {
            "contract_address":"0x76be3b62873462d2142405439777e971754e8e77",
            "token_id":"10397",
            "image_url":"https://api.reservoir.tools/assets/v1?asset=d13dd00e722beffaf6c818fc35b7e75aff273573f7e983ee7f02c6451a94960fc23a0129d686a51c2fa086b5362ac0e4de53e27c219ffea7247f67f500dc8541ea4ed5a4d740f5709928267c775f4eff2573e7e40288fee9530d283ebd0a413d",
            "collection_slug":"",
            "name":"Mantis Corsair",
            "tokenAmount":"2",
            "schema_name":"erc1155",
            "on_sale":false,
            "floorPrice":"1090000000000000",
            "collection_name":"Parallel Alpha",
            "last_sale":"1250000000000000",
            "code":"eyJzb3VyY2UiOiJpbmRleGVyIiwib3duZXIiOiIweDcyZjE2Q2FlOEY1MEFkNjE1QUI1QThlMjMxQTQ5NmIyYWNlNTI1MzIifQ",
            "paymentAsset":{
                "symbol":"ETH",
                "address":"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
                "decimals":18,
                "image":"https://cloudstorage.openocean.finance/images/1637894743832_8242841824007741.png"
            }
        }
    ],
    "next":2
}

Owner Offers

Owner Offers

GET https://open-api.openocean.finance/nft/v1/:chain/offers

Query Parameters

{
    "code": 0,
    "message": "ok",
    "data": [],
    "next": ""
}

Cancel Order

Cancel Order

POST https://open-api.openocean.finance/nft/v1/:chain/cancel

Path Parameters

Request Body

{
    "code": 0,
    "message": "ok",
    "data": {
        "from": "0x1cad209a2022747a0c1c538ee7d99fd1060fd378",
        "data": "0x09ba153d00000000000000000000000000000000000000000...",
        "to": ""
    }
}

Check order state

Check order state

POST https://open-api.openocean.finance/nft/v1/:chain/order/state

Path Parameters

Request Body

{
    "code": 0,
    "message": "ok",
    "data": [
        {
            "market":"looksrare", // marketplace
            "tokenType":"ERC721",
            "collection":"0x4E1f41613c9084FdB9E34E11fAE9412427480e56", // nft contract
            "tokenId":"3048",
            "code": "",
            "amount":1,
            "expired": true
        },
        {
            "market":"x2y2",
            "tokenType":"ERC721",
            "collection":"0xc377b4fe503afea2573daf49c200a17c4160e14d",
            "tokenId":"3258",
            "code": "",
            "amount":1,
            "expired": false
        }
    ]
}

Sudoswap refresh order price

Sudoswap refresh order price

POST https://open-api.openocean.finance/nft/v1/:chain/refreshPrice

Path Parameters

{
    "code": 200,
    "data": {
         "0x16f71d593bc6446a16ef84551cf8d76ff5973db1": "7918529411764705746", // key - poolId, value - price
    }
}

Get Token Swap

Get Token Swap

POST https://open-api.openocean.finance/nft/v1/:chain/swap

Path Parameters

Request Body

{
    "code": 0,
    "message": "ok",
    "data": [
        {
            "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
            "to": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
            "amount": "4986678460420321202",
            "outAmount": "3616385441300520",
            "estimatedGas": "179198"
        }
    ]
}

Owner Listings

Owner Listings

GET https://open-api.openocean.finance/nft/v1/:chain/listings

Query Parameters

{
    "code":0,
    "data":[
        {
            "contract_address":"0xa4f47f8e2579f45c0a6e26d5fb69f8a1b027b8ca",
            "token_id":"46",
            "image_url":"https://api.reservoir.tools/assets/v1?asset=36109e01a0f463f89d0054dfb865c355814e73000779cff19c745153c0940b62a0f6d6d162252b5f90714cee0e30660fce6fe590d90bf6b892a15dfd9af35e9601bbc70db8e553c04fb623854ffb7660a28dbde39d9a236c6012977fd5349b7d0cb5844c1c3141ae520ad93de034a37d309d0ed3529d6d5c05f877658432d931",
            "collection_slug":"testnnft-v2",
            "name":"Thump - Common",
            "schema_name":"erc721",
            "tokenAmount":0,
            "on_sale":true,
            "market":"opensea",
            "orderType":"listing",
            "floorPrice":0,
            "price":"220000000000000",
            "amount":"1",
            "collection_name":"testNNFT V2",
            "last_sale":"100000000000000",
            "end_at":1679033127000,
            "code":"eyJzb3VyY2UiOiJpbmRleGVyIiwib3duZXIiOiIweDcyZjE2Q2FlOEY1MEFkNjE1QUI1QThlMjMxQTQ5NmIyYWNlNTI1MzIiLCJub25jZSI6IjB4ZDY3ZWE2ZWY5ODM2OGI2ZDNhMWFkNzJkOTdkNTk2ZDZhNzhhNmNkNDEwMWU1MmNlNGI5YmEzMjAzYmQwNGViMTQ2ZTIxNzY5NGFhMmE1MzlmYjdiNmQ5Y2JmOWZjZjE4MjJkNmRkOWZmNTU2ZGJjNDBiN2NhNmYwOTQ4MTdkZmIxYyIsInRpbWUiOiIiLCJwcmljZSI6IjIyMDAwMDAwMDAwMDAwMCIsIm9yZGVySWQiOiIweGM4NWExOWRiMDkwYzM4YjdkZDJhZGRmMmUzMzU5ZTY2NGY3MDU1YmRiZTU3ZjFmMGM0MDU1MjU5ZmU2YTg5Y2MiLCJvcmRlclR5cGUiOiJsaXN0aW5nIn0",
            "paymentAsset":{
                "symbol":"ETH",
                "address":"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
                "decimals":18,
                "image":"https://cloudstorage.openocean.finance/images/1637894743832_8242841824007741.png"
            }
        }
    ],
    "next":null
}

Get collection activity

Get collection activity

GET https://open-api.openocean.finance/nft/v1/:chain/collection/activity

Query Parameters

{
    "code":200,
    "data":[
        {
            "type":"sale",
            "fromAddress":"0xa879683c83bd76ff3369a063ebf250065d4df0a9",
            "toAddress":"0x520b12c94ce6f6c4efdea594969b5259df315441",
            "price":0.0035,
            "amount":1,
            "timestamp":1677476315,
            "token":{
                "tokenId":"675111",
                "tokenName":"Bag #675111",
                "tokenImage":"https://openseauserdata.com/files/d5ca96a8d71959a1f82ea05675fe44ea.svg"
            },
            "collection":{
                "collectionId":"0x1dfe7ca09e99d10835bf73044a23b73fc20623df",
                "collectionImage":null,
                "collectionName":"More Loot"
            },
            "txHash":"0xa4ad8566d5b843f521b1aac5e4e3b0aec380df7e55df8537672818402529d81b",
            "logIndex":69,
            "batchIndex":1,
            "source":{
                "domain":"element.market",
                "name":"element.market",
                "icon":"https://www.element.market/resource/images/favicon-180.png"
            }
        }
    ]
}

Owner Activity

Owner Activity

GET https://open-api.openocean.finance/nft/v1/:chain/address/activity

Query Parameters

{
    "code":200,
    "data":[
        {
            "type":"ask",
            "fromAddress":"0x72f16cae8f50ad615ab5a8e231a496b2ace52532",
            "toAddress":null,
            "price":0.0038,
            "amount":1,
            "timestamp":1676965006,
            "token":{
                "tokenId":"10193",
                "tokenName":"Change of Heart",
                "tokenImage":"https://i.seadn.io/gcs/files/311f64e7ecc5c39aacdb1d48d40fe819.png?w=500&auto=format"
            },
            "collection":{
                "collectionId":"0x76be3b62873462d2142405439777e971754e8e77",
                "collectionImage":"https://i.seadn.io/gae/Nnp8Pdo6EidK7eBduGnAn_JBvFsYGhNGMJ_fHJ_mzGMN_2Khu5snL5zmiUMcSsIqtANh19KqxXDs0iNq_aYbKC5smO3hiCSw9PlL?w=500&auto=format",
                "collectionName":"Parallel Alpha"
            }
        }
    ]
}

Last updated