Seascape Nft

Seascape Nft related API.

Get Seascape NFT Image

GET https://url/nft/img/:id

This endpoint allows you to get image of NFT.

Path Parameters

Name	Type	Description
id	integer	NFT Id

200 .gif image (content type: "image/gif")

403 Too many image options, which indicates an internal error. 0.00000001% chance you would have it.

{"error": "403 multiple result", "err_code": 403}

404 Could not find an image for sprite. Might be nft is not minted yet.

{ "error": "404 not found", "err_code": 404}

Get Seascape NFT data

GET https://url/nft/data/:id

This endpoint returns NFT parameters, such as generation, quality etc...

Path Parameters

Name	Type	Description
id	integer	NFT id

200 Returns the following parameters: * generation a seascape NFT generation. id NFT id img_id Img id, some images are repetitive quality Seascape quality id wallet_address Owner of token

{"generation":0,"id":58,"img_id":3,"quality":1,"wallet_address":"0xC6EF8A96F20d50E347eD9a1C84142D02b1EFedc0"}

404 Probably NFT was not minted yet.

{"error": "404 not found", "err_code": 404}

500 Any internal server error returns anything, except JSON. So, the following message will be seen:

{"error": "505 json to string convert error", "err_code": 500}

Get Seascape NFT data in OPENSEA format

GET https://url/nft/meta/:id

The parameters of Token, but for online Token sale platform https://opensea.io

Path Parameters

Name	Type	Description
id	integer	NFT id

200 The format of successful response solely defined on opensea. So checkout the https://docs.opensea.io/docs/metadata-standards

{
   "attributes":[
      {
         "max_value":5,
         "trait_type":"Quality",
         "value":1
      },
      {
         "display_type":"date",
         "trait_type":"Birthdate",
         "value":1607276794
      },
      {
         "trait_type":"Generation",
         "value":0
      }
   ],
   "description":"a simple Seascape NFT.",
   "external_url":"http://api-test.blocklords.io:81/nft/meta/58",
   "image":"http://api-test.blocklords.io:81/nft/img/58",
   "name":"Seascape NFT #58"
}

404 Probably NFT is not yet minted

{
   "error":"404 not found",
   "err_code":404
}

500 Any internal server error will return anything, except JSON. So following message will be seen:

{
   "error":"500 json to string convert error",
   "err_code":500
}

Get batch of nfts by the owner's wallet address

GET https://url/owned-by/:wallet-address

Path Parameters

Name	Type	Description
wallet_address	string	A wallet address of the user starting with the 0x prefix.

200 List of the nft metadata in a way, as it was returned by /nft/data/:id

[
   {
      "generation":0,
      "id":44,
      "img_id":4,
      "quality":1,
      "wallet_address":"0xe7186c0c4e6b249a269bd7fa3c3e1da54250c18b"
   },
   {
      "generation":0,
      "id":325,
      "img_id":7,
      "quality":2,
      "wallet_address":"0xe7186c0c4e6b249a269bd7fa3c3e1da54250c18b"
   },
]

GET https://url/owned-by/:wallet-address

Path Parameters

Name	Type	Description
	string

200 nft

Get Seasacpe Points (SP)

GET https://url/nft/sp-points/:id

Returns the calculated Seascape Points. Seascape Points is a weight of NFT in the Seascape platform. The higher the value, the bold nft it is. Seascape Points are calculated in format of generation multiplied by quality. The older the generation, and higher the quality, the seascape points will be high too. Addiontally, this endpoint returns a signature of hash of seascape points. Any smartcontract of Seascape Platform that requires Seascape Points, will also require the signature of seascape points. By that signature, smartcontract verifies that our backend generated it itself.

Path Parameters

Name	Type	Description
id	integer	NFT id

200 Example of successfule response for Nft ID 58 on rinkeby testnet.

{
   "id":"58",
   "scape_points":600,
   "signature":"0xa23a3101d845bfa2ee533afd5c755a3f3855dbc362490ab5f4c972e411be6f63622b5571d6b86a0390b528a8bbdd341ed526989c67ff986f8da99859edd3992301"
}

403 It is not allowed to have too many signatures for one NFT.

{
   "error":"403 too many signatures",
   "err_code":403
}

404 If Nft was not minted yet, then seascpe points will be 0. And signature will be empty string.

{
   "id":"3",
   "scape_points":0,
   "signature":""
}

500 An internal server error retuns anything, except JSON. So the following message will be back:

{
   "error":"500 json to string convert error",
   "err_code":500
}