REST API

Tensor provides a simple REST API to query NFT prices across both Solana and Ethereum.

Please reach out to [email protected] to ask for the API endpoint / API key.

Endpoints

List collections

GET https://api.tensor.so/:chain/collections

Lists currently supported collections.

Note: currently only blue chip collections on Solana & Ethereum are supported.

Examples:

https://api.tensor.so/eth/collections/

https://api.tensor.so/sol/collections/

Path Parameters

Name	Type	Description
:chain*	String	sol or eth

200: OK List of collection names and IDs

[
  {
    "name": "Solanauts",
    "onchainId": "BDYYJ1VzPDXwJoARMZNnN4MX4cZNjVvc5DfFaKzgrruz"
  },
  {
    "name": "Solana Monkey Business",
    "onchainId": "9uBX3ASjxWvNBAD1xjbVaKA74mWGZys3RGSF7DdeDD3F"
  },
  {
    "name": "Degen Ape Academy",
    "onchainId": "9BKWqDHfHZh9j39xakYVMdr6hXmCLHH5VfCpeq2idU9L"
  },
  {
    "name": "Taiyo Robotics",
    "onchainId": "AsbhrsY4posEBmZ8vyAooKtpvyJoWQWTqsSnnZpDmChn"
  },
  {
    "name": "DeGods",
    "onchainId": "9MynErYQ5Qi6obp4YwwdoDmXkZ1hYVtPUqYmJJ3rZ9Kn"
  },
  {
    "name": "Boryoku Dragonz",
    "onchainId": "DRGNjvBvnXNiQz9dTppGk1tAsVxtJsvhEmojEfBU3ezf"
  },
  {
    "name": "Shadowy Super Coder",
    "onchainId": "71ghWqucipW661X4ht61qvmc3xKQGMBGZxwSDmZrYQmf"
  },
  {
    "name": "Stone Ape Crew",
    "onchainId": "7RCBr3ZQ8yhY4jHpFFo3Kmh7MnaCPi1bFuUgXUB9WURf"
  },
  {
    "name": "Aurory",
    "onchainId": "9vwYtcJsH1MskNaixcjgNBnvBDkTBhyg25umod1rgMQL"
  },
  {
    "name": "Portals",
    "onchainId": "5grvMeoBqv5ZdHq9JMy5RrxLPNAt1nzc9cpqYWFUwizz"
  },
  {
    "name": "Nyan Heroes",
    "onchainId": "FpDKQ92HJYXvNBjLLvejh4gvVZwR28oGoaz36GdupcPp"
  },
  {
    "name": "Lfinity Flames",
    "onchainId": "EWyWxSkxWHWGzxfCd9kG7zGrKTUDbZGiV6VbFJF8YfqN"
  },
  {
    "name": "Mindfolk",
    "onchainId": "4wTTi885HkQ6awqRGQkHAdXXzE46DyqLNXtfo1uz5ub3"
  },
  {
    "name": "Famous Fox Federation",
    "onchainId": "D3XrkNZz6wx6cofot7Zohsf2KSsu2ArngNk8VqU9cTY3"
  },
  {
    "name": "Catalina Whale Mixer",
    "onchainId": "DvZfhaWCjA2uCWgimRm6F59vHkeXyGvEvvVQPhiqosn2"
  },
  {
    "name": "The Remnants",
    "onchainId": "4WoKtYvL2XG4Rbcmux2oWKw9QxXbXCvTRm6LcHMYDmB6"
  },
  {
    "name": "Thugbirds",
    "onchainId": "AvkbtawpmMSy571f71WsWEn41ATHg5iHw27LoYJdk8QA"
  },
  {
    "name": "Galactic Geckos",
    "onchainId": "FEg3mmpcrcRsVTuc2n3oghHpRvAtEJJau4KWjaPpLKcA"
  },
  {
    "name": "Quantum Traders",
    "onchainId": "7YXM2jx3psc7qTFmN25CDkjumqq8V9jcWAQwCZaK5Cws"
  },
  {
    "name": "SolGods",
    "onchainId": "ALNcW6QDNf7H4iNiTM3FD16LZ4zMGyEeCYQiE1AbCoXk"
  },
  {
    "name": "The Suites",
    "onchainId": "AQ98oUJQuTsX446cYJgEJJRTnQL4b2LiaFTp95nfa2qc"
  },
  {
    "name": "DeGods2",
    "onchainId": "8RMqBV79p8sb51nMaKMWR94XKjUvD2kuUSAkpEJTmxyx"
  }
]

500: Internal Server Error API is down or something went wrong!

{
    // Response
}

List mints

GET https://api.tensor.so/:chain/collections/:collection

Lists mints that are part of the collection.

For a 10k collection returns 10k mints with links to their metadata.

Examples:

https://api.tensor.so/eth/collections/0xed5af388653567af2f388e6224dc7c4b3241c544

https://api.tensor.so/sol/collections/AsbhrsY4posEBmZ8vyAooKtpvyJoWQWTqsSnnZpDmChn

Path Parameters

Name	Type	Description
:chain*	String	sol or eth
:collection*	String	pick one from list collections endpoint

200: OK List of mints (onchain ID and metadata)

[
    {
        "onchainId": "7TBMvbqGeK3gpL4tYvc56nCWCzapnhkVGywa6WKDuSnj",
        "metadataUri": "https://arweave.net/AzmyEwV1pVtHFkSihvMO4ULmNfgSbvdk4chlycMlQbM"
    },
    {
        "onchainId": "Aqce4RLidqv8BZRkYvqQfGrexAbdpNVEvAuBU7iKkDfR",
        "metadataUri": "https://arweave.net/Po4HLYrxRsWvYzZe8tqwh22DjmGugK_jd3ZoOUyMgik"
    },
    {
        "onchainId": "GDtEf911eD5inJdkiJy1e5nCQAavB3T2gdvdKdCtCyUj",
        "metadataUri": "https://arweave.net/Q5e2iaHtkXz5xazVyqhvJ2nxs59q8K3VwduxX9PD78Q"
    },
    // ...
]

404: Not Found No NFTs (mints) for this collection (maybe collection ID is invalid)

NFTs for this collection not found

500: Internal Server Error API is down or something went wrong!

{
    // Response
}

Get collection's "smart floor price"

GET https://api.tensor.so/:chain/collections/:collection/floor?at=:ts

Gets Tensor's "smart floor price" for a given collection.

"Smart" floor prices are a version of the standard floor prices robust to manipulation. See https://docs.tensor.so/smart-floor-price/introduction for more detail.

Examples:

https://api.tensor.so/eth/collections/0xed5af388653567af2f388e6224dc7c4b3241c544/floor?at=1648413731

https://api.tensor.so/sol/collections/AsbhrsY4posEBmZ8vyAooKtpvyJoWQWTqsSnnZpDmChn/floor

Path Parameters

Name	Type	Description
:chain*	String	sol or eth
:collection*	String	pick one from list collections endpoint

Query Parameters

Name	Type	Description
:ts	Int	unix timestamp for desired floor price, optional

200: OK Smart floor price for collection at given time

{
  "upper": 228004088560,
  "price": 224002810884.875,
  "lower": 220001533209.75,
  "priceUnit": "SOL_LAMPORT",
  "generatedFor": "2022-03-29T22:58:14.000Z"
}

404: Not Found No floor prices yet or incorrect collection ID

Floor for collection not found

500: Internal Server Error API is down or something went wrong!

{
    // Response
}

Get NFT estimated price

GET https://api.tensor.so/:chain/collections/:collection/:nft?at=:ts

Gets Tensor's best estimate of an NFT's price.

The price is calculated using our proprietary models that take into account rarities and historical prices for all transactions.

Note: prices are usually least accurate for the top 10% of rarities in a collection. We're still working on that :)

Examples:

https://api.tensor.so/eth/collections/0xed5af388653567af2f388e6224dc7c4b3241c544/1234

https://api.tensor.so/sol/collections/AsbhrsY4posEBmZ8vyAooKtpvyJoWQWTqsSnnZpDmChn/8xr7ae9kCSjQmXYRVgcK9sSiSeVwBxazt19vpgQL1NDm?at=1648413731

Path Parameters

Name	Type	Description
:chain*	String	sol or eth
:collection*	String	pick one from list collections endpoint
:nft*	String	pick one from list nfts endpoint

Query Parameters

Name	Type	Description
:ts	Int	unix timestamp for desired NFT price, optional

200: OK Estimated price for the NFT

{
    // Response
}

404: Not Found No estimated price for this NFT

Price for NFT not found

500: Internal Server Error API is down or something went wrong!

Endpoint missing?

Tensor is in early phases of its development. If there is an endpoint that you require that is missing - please let us know.