Tensor

Traditional NFT Marketplace:
User A lists at 100 SOL → Waits → User B purchases
(May wait days or weeks)

Tensor AMM:
User → AMM Pool (Instant execution)
├─ Buy: Extract NFT from pool, pay SOL
└─ Sell: Deposit NFT into pool, receive SOL

AMM Pricing Formula:
Price = Floor Price x (1 + Price Impact)
Price Impact = f(NFTs in pool, trade quantity)

Seller sets price → On-chain listing
    ↓
Buyer sees listing → Accepts price to buy
    ↓
Instant execution, NFT transferred

Buyer places bid → On-chain bid order
    ↓
Seller sees bid → Accepts bid to sell
    ↓
Instant execution, SOL transferred

Buyer bids on entire collection → Any NFT can be matched
    ↓
Seller accepts → Price adjusted based on rarity
    ↓
Fair execution

Tensor aggregates multiple sources:
├─ Tensor listings
├─ Magic Eden listings
├─ Tensor AMM pools
├─ Private bids
└─ Other marketplaces

Automatically selects the best price for execution

import { TensorClient } from '@tensor-hq/tensor-sdk'
import { Connection, PublicKey } from '@solana/web3.js'

const connection = new Connection('https://api.mainnet-beta.solana.com')
const tensorClient = new TensorClient({ connection, wallet })

// Get collection info (using DeGods as example)
const collectionId = new PublicKey('DeGods_Collection_Mint')
const collection = await tensorClient.getCollection(collectionId)

console.log('Collection Info:')
console.log('Floor Price:', collection.floorPrice / 1e9, 'SOL')
console.log('Volume (24h):', collection.volume24h / 1e9, 'SOL')
console.log('Listed Count:', collection.listedCount)

// Buy floor price NFT
const buyTx = await tensorClient.buyNFT({
  collection: collectionId,
  maxPrice: collection.floorPrice * 1.05, // Allow 5% slippage
})

console.log('Purchase successful:', buyTx.signature)

// List an NFT for sale
const nftMint = new PublicKey('Your_NFT_Mint_Address')
const listTx = await tensorClient.listNFT({
  mint: nftMint,
  price: 150 * 1e9, // 150 SOL
})

console.log('Listing successful:', listTx.signature)

import { TensorClient } from '@tensor-hq/tensor-sdk'

const tensorClient = new TensorClient({ connection, wallet })

// Sweep floor: Buy 10 floor price NFTs
const sweepTx = await tensorClient.sweepFloor({
  collection: collectionId,
  count: 10, // Buy 10
  maxPricePerNFT: 100 * 1e9, // Max 100 SOL each
  maxTotalPrice: 950 * 1e9, // Max 950 SOL total
})

console.log('Floor sweep successful, bought', sweepTx.nfts.length, 'NFTs')

// Batch listing: List all NFTs at floor price + 10%
const userNFTs = await tensorClient.getUserNFTs(wallet.publicKey, collectionId)
const floorPrice = (await tensorClient.getCollection(collectionId)).floorPrice

const bulkListTx = await tensorClient.bulkList({
  nfts: userNFTs.map(nft => ({
    mint: nft.mint,
    price: floorPrice * 1.1, // Floor + 10%
  })),
})

console.log('Batch listing successful:', bulkListTx.signature)

import { TensorClient } from '@tensor-hq/tensor-sdk'

const tensorClient = new TensorClient({ connection, wallet })

// Create collection bid
const collectionBidTx = await tensorClient.createCollectionBid({
  collection: collectionId,
  price: 80 * 1e9, // Bid 80 SOL
  quantity: 5, // Willing to buy 5
  expiryTime: Date.now() + 7 * 24 * 3600 * 1000, // Expires in 7 days
})

console.log('Collection bid created:', collectionBidTx.signature)

// Trait bid: Only buy NFTs with specific traits
const traitBidTx = await tensorClient.createTraitBid({
  collection: collectionId,
  traits: {
    'Background': 'Gold',
    'Eyes': 'Laser',
  },
  price: 150 * 1e9, // 150 SOL
  quantity: 2,
})

console.log('Trait bid created:', traitBidTx.signature)

// Query my bids
const myBids = await tensorClient.getUserBids(wallet.publicKey)
console.log('My bids:', myBids)

// Cancel bid
const cancelBidTx = await tensorClient.cancelBid({
  bidId: myBids[0].id,
})

console.log('Bid cancelled:', cancelBidTx.signature)

import { TensorClient } from '@tensor-hq/tensor-sdk'

const tensorClient = new TensorClient({ connection, wallet })

// Create AMM pool
const createPoolTx = await tensorClient.createAMMPool({
  collection: collectionId,
  curveType: 'exponential', // Exponential curve
  delta: 5, // 5% price change per trade
  spotPrice: 90 * 1e9, // Starting price 90 SOL
  depositNFTs: [nft1, nft2, nft3], // Deposit 3 NFTs
  depositSOL: 270 * 1e9, // Deposit 270 SOL
})

console.log('AMM pool created:', createPoolTx.poolAddress)

// AMM pricing example:
// Starting price: 90 SOL
// Delta: 5%
// Buy prices:
//   1st: 90 SOL
//   2nd: 90 * 1.05 = 94.5 SOL
//   3rd: 94.5 * 1.05 = 99.2 SOL
// Sell prices:
//   1st: 90 / 1.05 = 85.7 SOL
//   2nd: 85.7 / 1.05 = 81.6 SOL

// Manage AMM pool
const pool = await tensorClient.getPool(createPoolTx.poolAddress)

console.log('Pool Status:')
console.log('NFT Count:', pool.nftCount)
console.log('SOL Balance:', pool.solBalance / 1e9)
console.log('Accumulated Fees:', pool.accumulatedFees / 1e9, 'SOL')

// Withdraw earnings
const withdrawTx = await tensorClient.withdrawFromPool({
  pool: createPoolTx.poolAddress,
  withdrawNFTs: true,
  withdrawSOL: true,
})

console.log('Earnings withdrawn:', withdrawTx.signature)

import { TensorClient } from '@tensor-hq/tensor-sdk'

const tensorClient = new TensorClient({ connection, wallet })

// Get trending collections
const trendingCollections = await tensorClient.getTrendingCollections({
  period: '24h',
  limit: 10,
})

console.log('24h Trending Collections:')
trendingCollections.forEach((col, index) => {
  console.log(`${index + 1}. ${col.name}`)
  console.log(`   Floor Price: ${col.floorPrice / 1e9} SOL`)
  console.log(`   Volume: ${col.volume24h / 1e9} SOL`)
  console.log(`   Change: ${col.change24h > 0 ? '+' : ''}${col.change24h}%`)
})

// Get detailed collection stats
const stats = await tensorClient.getCollectionStats(collectionId, {
  period: '7d',
})

console.log('7-Day Stats:')
console.log('Volume:', stats.volume / 1e9, 'SOL')
console.log('Sales:', stats.sales)
console.log('Unique Buyers:', stats.uniqueBuyers)
console.log('Unique Sellers:', stats.uniqueSellers)
console.log('Floor Price Change:', stats.floorPriceChange, '%')

// Get rarity ranking
const rarity = await tensorClient.getRarityRanking(collectionId)
const myNFT = new PublicKey('Your_NFT_Mint')

const myNFTRank = rarity.find(r => r.mint.equals(myNFT))
console.log('My NFT Rarity Rank:', myNFTRank.rank, '/', rarity.length)
console.log('Rarity Score:', myNFTRank.score)

import { TensorClient } from '@tensor-hq/tensor-sdk'

const tensorClient = new TensorClient({ connection, wallet })

// Stake TNSR tokens
const stakeTx = await tensorClient.stakeTNSR({
  amount: 10000 * 1e9, // Stake 10,000 TNSR
  lockPeriod: 365, // Lock for 1 year
})

// Returns calculation:
// Base APR: 15%
// Lock bonus: +5% (1-year lock)
// Volume bonus: +3% (high-volume user)
// Total APR: 23%

console.log('Estimated annual return:', 10000 * 0.23, 'TNSR')