Nfts

Check if a user owns a validator NFT

get

Path parameters

ethosUserKeystringRequired

Responses

200

Successful response

application/json

contractAddressstringRequired

tokenIdstringRequired

nameany ofRequired

stringOptional

or

nullOptional

descriptionany ofRequired

stringOptional

or

nullOptional

imageUrlany ofRequired

stringOptional

or

nullOptional

thumbnailUrlany ofRequired

stringOptional

or

nullOptional

animationUrlany ofRequired

stringOptional

or

nullOptional

animationMimeany ofRequired

stringOptional

or

nullOptional

tokenUriany ofRequired

stringOptional

or

nullOptional

attributesJsonany ofRequired

anyOptional

or

nullOptional

mintedAtany ofRequired

stringOptional

or

nullOptional

acquiredAtany ofRequired

stringOptional

or

nullOptional

lastActivityAtany ofRequired

stringOptional

or

nullOptional

createdAtstringRequired

updatedAtstringRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/nfts/user/{ethosUserKey}/owns-validator

HTTPcURLJavaScriptPython

GET /api/v2/nfts/user/{ethosUserKey}/owns-validator HTTP/1.1
Host: api.ethos.network
Accept: */*

[
  {
    "contractAddress": "text",
    "tokenId": "text",
    "name": "text",
    "description": "text",
    "imageUrl": "text",
    "thumbnailUrl": "text",
    "animationUrl": "text",
    "animationMime": "text",
    "tokenUri": "text",
    "attributesJson": null,
    "mintedAt": "text",
    "acquiredAt": "text",
    "lastActivityAt": "text",
    "createdAt": "text",
    "updatedAt": "text",
    "NftOwners": [
      {
        "ownerAddress": "text"
      }
    ],
    "collection": {
      "slug": "text"
    }
  }
]

Get NFTs owned by a user

get

Path parameters

ethosUserKeystringRequired

Query parameters

limitinteger · min: -9007199254740991 · max: 1000OptionalDefault: 50

offsetnumberOptionalDefault: 0

Responses

200

Successful response

application/json

totalnumberRequired

limitnumberRequired

offsetnumberRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/nfts/user/{ethosUserKey}

HTTPcURLJavaScriptPython

GET /api/v2/nfts/user/{ethosUserKey} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "contractAddress": "text",
      "tokenId": "text",
      "name": "text",
      "description": "text",
      "imageUrl": "text",
      "thumbnailUrl": "text",
      "animationUrl": "text",
      "animationMime": "text",
      "tokenUri": "text",
      "attributesJson": null,
      "mintedAt": "text",
      "acquiredAt": "text",
      "lastActivityAt": "text",
      "createdAt": "text",
      "updatedAt": "text",
      "NftOwners": [
        {
          "ownerAddress": "text"
        }
      ],
      "collection": {
        "slug": "text"
      }
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

Track a new NFT collection (Admin only)

post

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

contractAddressstringRequired

Ethereum address (0x-prefixed, 20 bytes)

Responses

200

Successful response

application/json

anyOptional

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/nfts/track

HTTPcURLJavaScriptPython

POST /api/v2/nfts/track HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "contractAddress": "text"
}

No content

Get validator NFTs listed for sale on OpenSea

get

Query parameters

limitinteger · min: -9007199254740991 · max: 50OptionalDefault: 50

offsetnumberOptionalDefault: 0

Responses

200

Successful response

application/json

totalnumberRequired

limitnumberRequired

offsetnumberRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/nfts/validators/listings

HTTPcURLJavaScriptPython

GET /api/v2/nfts/validators/listings HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "orderHash": "text",
      "tokenId": "text",
      "name": "text",
      "imageUrl": "text",
      "priceWei": "text",
      "priceEth": "text",
      "currency": "text",
      "seller": "text",
      "openseaUrl": "text"
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}