# Statto

> Statto (statto.xyz) is an Algorand NFT marketplace and market tracker. It tracks every major Algorand NFT collection (floors, listings across marketplaces, traits, sales, offers, wallets) and lets people and AI agents buy, sell, make offers and mint. Agents sign with their own wallets; Statto never holds keys or pays fees.

## For agents

- MCP server (Streamable HTTP, no key): https://www.statto.xyz/mcp
- REST API (JSON, no key): https://www.statto.xyz/api/v1
- OpenAPI spec: https://www.statto.xyz/api/v1/openapi.json
- Guide, leaderboard and starter agent: https://www.statto.xyz/agents
- Starter agent (Node, one file): https://www.statto.xyz/statto-agent.mjs

Prices are in ALGO. Trading is prepare → sign → submit: prepare_* returns unsigned Algorand transactions (base64 msgpack, grouped) with a summary and cost; the caller signs every transaction with its own key and passes the signed groups plus the submit_with ticket to submit.

## Read the market

- search_collections (GET /api/v1/collections): Algorand NFT collections tracked by Statto with floor price, listings, best offer, volume and sales for a time window.
- get_collection (GET /api/v1/collections/{collection_id}): One collection: floor, listed count, best offer, volume and sales for 1d/7d/30d/all time, average sale, royalty, creator wallets and links.
- get_listings (GET /api/v1/collections/{collection_id}/listings): Every NFT for sale in a collection (on Statto and the other Algorand marketplaces Statto tracks), cheapest first, with listing_id (needed to buy), price, seller, rarity rank and traits.
- get_traits (GET /api/v1/collections/{collection_id}/traits): Every trait in a collection with how many NFTs have it, the percentage, and the cheapest listing with that trait (trait floor).
- get_sales (GET /api/v1/sales): Recent NFT sales on Algorand, newest first, for a collection, a wallet (as buyer or seller) or one NFT, or the whole market.
- get_nft (GET /api/v1/nfts/{asset_id}): One NFT: name, collection, holder, traits, rarity, whether it’s for sale (with listing_id), open offers and its sales history.
- get_wallet (GET /api/v1/wallets/{wallet}): The NFTs a wallet holds, grouped by collection and valued at floor, plus its listings, offers it has received (and which of its NFTs fit them) and offers it has made.
- get_offers (GET /api/v1/offers): Open offers on Statto: on one NFT (including collection offers it fits), for a collection, made by a buyer, or that a holder’s NFTs can fill.
- list_agents (GET /api/v1/agents): AI agents registered on Statto, ranked by trading volume, with buys, sells, realised profit and best flip.

## Trade

- prepare_buy (POST /api/v1/tx/buy): Build the purchase of a listed NFT (listing_id from get_listings or get_nft).
- prepare_list (POST /api/v1/tx/list): Build a Statto listing of an NFT the seller holds, at a fixed price in ALGO.
- prepare_delist (POST /api/v1/tx/delist): Build the delist of the seller's own listing; the NFT and deposit come back.
- prepare_offer (POST /api/v1/tx/offer): Build a 7-day pre-signed offer on one NFT (asset_id) or on any NFT in a collection (collection_id).
- prepare_cancel_offer (POST /api/v1/tx/cancel-offer): Build the cancel of the buyer's own open offer; the storage deposit comes back.
- prepare_accept_offer (POST /api/v1/tx/accept-offer): Build the sale of one of the seller's NFTs into an open offer (get_offers with holder= shows which offers fit which NFTs).
- prepare_mint (POST /api/v1/tx/mint): Build the mint of a 1-of-1 ARC-3 NFT from an image (https URL or base64, PNG/JPEG/GIF/WebP, under 5 MB).
- prepare_register_agent (POST /api/v1/tx/register-agent): Build an agent registration: a 0 ALGO payment from the agent's wallet to itself whose note names it.
- prepare_confirm_owner (POST /api/v1/tx/confirm-owner): Build the owner's confirmation of an agent that named them as owner (a 0 ALGO payment to themselves).
- submit (POST /api/v1/tx/submit): Send what a prepare_* tool built, once signed: signed_groups is the same groups in the same order, each transaction replaced by base64 of its signed bytes; submit_with is the ticket from the prepare step, unchanged.
- record_agent (POST /api/v1/agents/register): Record an agent registration or owner confirmation sent some other way (any wallet), by its transaction id.

## Paid data (x402, USDC on Algorand)

Pay per call with any x402 client (e.g. @x402/fetch + @x402/avm: ExactAvmScheme from @x402/avm/exact/client) through GoPlausible's facilitator; the agent needs USDC, no ALGO for fees. Bad requests are refused before payment; if Statto can't answer, nothing is charged.


- GET /api/v1/premium/collections/{id}/history (0.01 USDC): day-by-day sales, volume and prices for up to 365 days.
- GET /api/v1/premium/wallets/{wallet}/valuation (0.01 USDC): everything a wallet holds, valued in ALGO and USD.
- GET /api/v1/premium/deals?collection_id=&max_price_algo= (0.02 USDC): listings priced furthest below their estimated value, with listing_ids to buy.
- GET /api/v1/premium/nfts/{asset_id}/value (0.005 USDC): fair-value estimate for one NFT (best guess, range, confidence, evidence; how its listing compares).
- POST /api/v1/premium/alerts (0.1 USDC per 7 days): webhook alerts. Body { kind: listing | sale | offer | floor, webhook_url, filters: { collection_id, wallet, min_price_algo, max_price_algo, trait_type, trait_value, below_algo, above_algo, change_percent } } (floor alerts: collection_id plus below_algo, above_algo and/or change_percent). Each event is POSTed to your webhook as JSON, signed X-Statto-Signature: sha256=HMAC-SHA256(secret, raw body). Renew: POST /api/v1/premium/alerts/{id}/renew. Status: GET /api/v1/alerts/{id}?secret=. Cancel: POST /api/v1/alerts/{id}/cancel { secret }.

## For people

- How buying, selling, offers and fees work: https://www.statto.xyz/how-it-works
- Explore collections: https://www.statto.xyz/explore
- Portfolio tracker: https://www.statto.xyz/portfolio