API Reference
Get Collections
Get Collections
GET
https://open-api.openocean.finance/nft/v2/:chain/collections
Query Parameters
eth, avax, polygon, arbitrum, optimism, solana
pagination(response next)
descending (allTimeVolume,1DayVolume,7DayVolume,30DayVolume)
address(specify collection details) or text(fuzzy match collection name)
200: OK https://open-api.openocean.finance/nft/v2/eth/collections?filters={%22text%22:%22mutant%22} 200: OK https://open-api.openocean.finance/nft/v2/eth/collections?filters={%22address%22:%220x354634c4621cdfb7a25e6486cca1e019777d841b%22}
Copy 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
}
]
}
Copy specify collection details responseīŧ
{
"code" : 0 ,
"data" :{
"id" : "0x354634c4621cdfb7a25e6486cca1e019777d841b" ,
"slug" : "mutant-hounds" ,
"name" : "Mutant Hounds" ,
"image" : "https://i.seadn.io/gcs/files/03a077ba38525dffdefae8add307da05.png?w=500&auto=format" ,
"primaryContract" : "0x354634c4621cdfb7a25e6486cca1e019777d841b" ,
"discordUrl" : null ,
"twitterUsername" : "MutantHounds" ,
"description" : "Mutant Hounds Are Insane. !howl\n\nOur Discord: http://discord.com/invite/mutantcartel" ,
"tokenCount" : "7579" ,
"ownerCount" : 2626 ,
"onSaleCount" : "677" ,
"floorAskPrice" : 0.3155 ,
"floorPrice" : {
"symbol" : "ETH" ,
"icon" : "https://cloudstorage.openocean.finance/images/1637894743832_8242841824007741.png" ,
"value" : 0.3155
} ,
"offerMinPrice" : 0.03155 ,
"isCollectionOffersEnabled" : true ,
"volume" : {
"1day" : 14.9169 ,
"7day" : 158.51282 ,
"30day" : 878.5984 ,
"allTime" : 5112.71505
} ,
"volumeChange" : {
"1day" : 0.947083114290721 ,
"7day" : 0.780128771183771 ,
"30day" : 0.20750453403519828
} ,
"attributes" : [
{
"key" : "Mega" ,
"attributeCount" : 6 ,
"kind" : "string" ,
"values" : [
{
"count" : 1 ,
"value" : "Ares"
} ,
{
"count" : 1 ,
"value" : "Caleb Lockjaw"
} ,
{
"count" : 1 ,
"value" : "Fiend"
} ,
{
"count" : 1 ,
"value" : "Glitch"
} ,
{
"count" : 1 ,
"value" : "Primo" ,
"floorAskPrice" : 150
} ,
{
"count" : 1 ,
"value" : "Volt"
}
]
}
] ,
"metadata" : {
"imageUrl" : "https://i.seadn.io/gcs/files/03a077ba38525dffdefae8add307da05.png?w=500&auto=format" ,
"discordUrl" : null ,
"description" : "Mutant Hounds Are Insane. !howl\n\nOur Discord: http://discord.com/invite/mutantcartel" ,
"externalUrl" : null ,
"bannerImageUrl" : "https://i.seadn.io/gcs/files/34b9b2939f421c213a82cfbbce46fc89.png?w=500&auto=format" ,
"twitterUsername" : "MutantHounds" ,
"safelistRequestStatus" : "approved"
} ,
"isVerified" : false ,
"marketplaceList" : [
{
"value" : "opensea" ,
"label" : "OpenSea"
} ,
{
"value" : "x2y2" ,
"label" : "X2Y2"
} ,
{
"value" : "looksrare" ,
"label" : "LooksRare"
} ,
{
"value" : "sudoswap" ,
"label" : "SudoSwap"
}
]
}
}
Get Asset
Get Asset
GET
https://open-api.openocean.finance/nft/v1/:chain/assets
Query Parameters
eth, avax, polygon, arbitrum, optimism, solana
pagination(response next)
address + tokenId(specify nft details) or address/text(match collection orders)
200: OK https://open-api.openocean.finance/nft/v1/eth/assets?filters={%22address%22:%220x1dfe7ca09e99d10835bf73044a23b73fc20623df%22,%22tokenId%22:119011}
Copy {
"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
eth, avax, polygon, arbitrum, optimism, solana
Request Body
payment token list(ERC20 + ETH)
remaining amount is transferred to the token list
200: OK https://open-api.openocean.finance/nft/v1/eth/buy
Copy {
"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
eth, avax, polygon, arbitrum, optimism, solana
Request Body
marketplace opensea/looksrare/x2y2
200: OK https://open-api.openocean.finance/nft/v1/eth/sell
Copy {
"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
eth, avax, polygon, arbitrum, optimism, solana
Request Body
marketplace opensea/looksrare/x2y2
200: OK https://open-api.openocean.finance/nft/v1/eth/offer
Copy {
"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
eth, avax, polygon, arbitrum, optimism, solana
Request Body
marketplace opensea/looksrare/x2y2
200: OK https://open-api.openocean.finance/nft/v1/eth/sign
Copy {
"code" : 0 ,
"message" : "ok"
}
Get Rankings
Get Rankings
GET
https://open-api.openocean.finance/nft/v2/:chain/rankings
Query Parameters
eth, avax, polygon, arbitrum, optimism, solana
1d 7d 30d all. 1d for default
200: OK https://open-api.openocean.finance/nft/v2/eth/rankings?time=1d&limit=50&offset=0
Copy {
"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
eth, avax, polygon, arbitrum, optimism, solana
pagination(response next)
filters={address,searchAttributes,market}
address is required
sudoswap needs this field, the initialization interface is {}, and the later refresh needs to pass the value,key-poolId (the id of the pool, returned by the orders interface), amount-the number of selected nft (default is 0)
200: OK https://open-api.openocean.finance/nft/v2/eth/orders?filters={%22address%22:%220x6187e7a47cebf45b307bf70d109ce343f60d2366%22,%22searchAttributes%22:%22%22}&limit=12&offset=&amount={}
Copy {
"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
eth, avax, polygon, arbitrum, optimism, solana
The number of selected nft in the pool, required by sudoswap
200: OK https://open-api.openocean.finance/nft/v1/eth/detail?address=0x6187e7a47cebf45b307bf70d109ce343f60d2366&tokenId=1339&code=eyJzb3VyY2UiOiJpbmRleGVyIiwib3JkZXJJZCI6IjB4NGJmYmM5NTkzMzk5MzIzZGI1NDYyMmQxMWExNDU2MDg3YzUwMzdjYjQyMWM4MDNkZDU5ZDc0ZGIyMGM4ZWUwZSIsIm93bmVyIjoiMHg4NDkyMTNiYjdmODRiYjcyMGVkZTA5ZWM4MjczZjAzNmYwMGVmNGFmIiwicHJpY2UiOiIxMTYwMDAwMDAwMDAwMDAwMDAiLCJwb29sSWQiOm51bGx9&amount=1
Copy {
"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
eth, avax, polygon, arbitrum, optimism, solana
Request Body
token amount(with decimals)
200: OK https://open-api.openocean.finance/nft/v1/eth/quote
Copy {
"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
eth, avax, polygon, arbitrum, optimism, solana
200: OK https://open-api.openocean.finance/nft/v1/eth/nfts?address=0x72f16Cae8F50Ad615AB5A8e231A496b2ace52532&cursor=1
Copy {
"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
eth, avax, polygon, arbitrum, optimism, solana
pagination(response next)
200: OK https://open-api.openocean.finance/nft/v1/eth/offers?address=0x72f16Cae8F50Ad615AB5A8e231A496b2ace52532&limit=20
Copy {
"code" : 0 ,
"message" : "ok" ,
"data" : [] ,
"next" : ""
}
Cancel Order
Cancel Order
POST
https://open-api.openocean.finance/nft/v1/:chain/cancel
Path Parameters
eth, avax, polygon, arbitrum, optimism, solana
Request Body
200: OK https://open-api.openocean.finance/nft/v1/eth/cancel
Copy {
"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
eth, avax, polygon, arbitrum, optimism, solana
Request Body
200: OK
Copy {
"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
eth, avax, polygon, arbitrum, optimism, solana
200: OK
Copy {
"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
eth, avax, polygon, arbitrum, optimism, solana
Request Body
200: OK
Copy {
"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
eth, avax, polygon, arbitrum, optimism, solana
200: OK https://open-api.openocean.finance/nft/v1/eth/listings?address=0x72f16Cae8F50Ad615AB5A8e231A496b2ace52532&cursor=1
Copy {
"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
eth, avax, polygon, arbitrum, optimism, solana
collection slug(Required for non-eth chains)
200: OK https://open-api.openocean.finance/nft/v1/eth/collection/activity?collection=0x1dfe7ca09e99d10835bf73044a23b73fc20623df
Copy {
"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
eth, avax, polygon, arbitrum, optimism, solana
200: OK https://open-api.openocean.finance/nft/v1/eth/address/activity?address=0x72f16Cae8F50Ad615AB5A8e231A496b2ace52532
Copy {
"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 3 months ago