NFT API
for AI Agents

Why AI Agents Need Native NFT Capabilities

Non-fungible tokens are no longer just profile pictures. They encode ownership of in-game assets, ENS domains, DeFi positions (Uniswap v3 LP positions are ERC-721 tokens), real-world asset certificates, and identity attestations. An agent that can interact with NFTs opens up an entirely new surface area of autonomous action.

Purple Flea's NFT API abstracts away the chain-specific complexity of interacting with ERC-721 and ERC-1155 contracts. You don't need to encode ABI calldata, manage gas estimation for safeTransferFrom, or integrate five different marketplace APIs to get floor prices. The API handles all of that, exposing clean JSON endpoints your agent can call with no additional dependencies.

Agents can use the NFT API to build a wide range of autonomous strategies: hold a collection until the floor rises and auto-sell via limit-floor orders, snipe mint launches by monitoring the mempool, acquire ENS domains for brand or resale, or manage in-game NFT inventories across multiple wallets.

Supported Chains

Cross-chain support means a single agent can manage NFT holdings across all five networks. The API normalizes chain-specific differences: Solana NFTs are handled through the Metaplex standard and queried via the same /nft/balance endpoint as their EVM counterparts.

Key Capabilities

NFT Sniping

• Mempool monitoring: Sub-100ms detection of mint transactions via dedicated node infrastructure
• Gas strategy: Configurable base-fee + priority-fee multipliers to control snipe aggressiveness
• Quantity control: Set max tokens to mint per launch to control capital deployment
• Allowlist support: Merkle-proof mints (allowlist/whitelist) are supported if you supply a valid proof
• Auto-list after mint: Optionally list the sniped NFT for sale at a floor-plus-margin price immediately after mint

API Endpoints

Code Examples

Check NFT Balance

const PURPLE_FLEA_KEY = 'pf_your_api_key_here';

async function getNftBalance(walletAddress) {
  const params = new URLSearchParams({
    address: walletAddress,
    chain: 'ethereum'
  });

  const res = await fetch(
    `https://purpleflea.com/api/nft/balance?${params}`,
    { headers: { 'Authorization': `Bearer ${PURPLE_FLEA_KEY}` } }
  );
  const { nfts, total } = await res.json();

  console.log(`Wallet holds ${total} NFTs`);
  nfts.forEach(nft => {
    console.log(`  ${nft.collection_name} #${nft.token_id}`);
  });

  return nfts;
}

Transfer an NFT

async function transferNft(from, to, contract, tokenId) {
  const res = await fetch('https://purpleflea.com/api/nft/transfer', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${PURPLE_FLEA_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ from: from, to: to, contract: contract, tokenId: tokenId, chain: 'ethereum' })
  });
  const { txHash, status } = await res.json();

  console.log(`Transfer submitted: ${txHash} — status: ${status}`);
  return txHash;
}

Get Collection Floor Price

async function getFloorPrice(contractAddress) {
  const res = await fetch(
    `https://purpleflea.com/api/nft/floor?contract=${contractAddress}&chain=ethereum`,
    { headers: { 'Authorization': `Bearer ${PURPLE_FLEA_KEY}` } }
  );
  const { floor_eth, floor_usd, change_24h } = await res.json();

  console.log(`Floor: ${floor_eth} ETH ($${floor_usd}) | 24h: ${change_24h}%`);
  return { floor_eth, floor_usd };
}

Register Auto-Mint Snipe

async function registerMintSnipe(contract) {
  const res = await fetch('https://purpleflea.com/api/nft/snipe/register', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${PURPLE_FLEA_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      contract: contract,
      chain: 'ethereum',
      quantity: 2,
      maxMintPriceEth: '0.08',
      gasMultiplier: 1.3,
      // webhook called when mint succeeds
      webhookUrl: 'https://my-agent.example.com/nft-minted'
    })
  });
  const { snipeId, status } = await res.json();
  console.log(`Snipe registered: ${snipeId}`);
}

Agent Use Cases

Related APIs and Tools

The NFT API integrates with Purple Flea's broader ecosystem of agent-native financial tools.