# Archipelago

> Archipelago is a live market radar and trading terminal for Arc (chain 5042), the Layer 1 blockchain built by Circle where USDC pays for gas. It reads trades on Arc's Uniswap v3 and v4 pools as they happen, shows the fees and the round-trip cost before a buy, and trades from a wallet in the user's own browser. Programs and AI agents can buy a report on any token it tracks for 0.01 USDC over x402, and, at the same price, what buying and selling a token costs at sizes they choose and a wallet's balances.

Each trade pays Archipelago a fee in USDC, sent to a public multisig treasury: 0.05% on pools whose own fee is 0.1% or less (usually majors and stables; a hook's cut is not counted), 0.25% on every other pool, at most $25 on a sell up to $250,000 and 0.01% above that; nothing for a wallet holding 1,000,000 ISLE or more. Archipelago's own token is $ISLE, contract 0x3945df1f8dd8f753fb62e428f3aaeb2c185a6e26 on Arc. A ticker is not an identity: on Arc many tokens share one, so name a token by its contract address.

## Docs

- [FAQ](https://archipelagodex.xyz/faq.html): the trading wallet, funding it from an exchange, where the key is kept, the fees, and what the warnings mean
- [Whitepaper](https://archipelagodex.xyz/whitepaper.html): how the terminal and $ISLE work, the treasury, who controls what, and the risks, with every contract address ([PDF](https://archipelagodex.xyz/whitepaper.pdf))
- [Token reports for AI agents](https://archipelagodex.xyz/agents.html): buy a report on an Arc token for 0.01 USDC over x402, with no signup and no API key; setup in TypeScript, Python or as an MCP server
- [Use it from an AI assistant (MCP)](https://archipelagodex.xyz/agents.html#mcp): an MCP server that buys these answers from a wallet you set up, within a per-call cap and a daily budget you set; npm package @archipelagodex/archipelago-x402-mcp (pin a version), listed in the MCP Registry as io.github.RunTimeAdmin/archipelago-x402-mcp

## API

- [OpenAPI description](https://idx.archipelagodex.xyz/openapi.json): the three paid routes
- [x402 listing](https://idx.archipelagodex.xyz/.well-known/x402): the same terms, in the shape x402 directories read, with the routes left to the OpenAPI description
- [API notes for agents](https://idx.archipelagodex.xyz/llms.txt): their price, the payment flow and what a buyer is promised, on one page
- [Paid token report](https://idx.archipelagodex.xyz/x402/report/0x3945df1f8dd8f753fb62e428f3aaeb2c185a6e26): GET /x402/report/<token address> answers 402 with the x402 payment terms, then the report once paid
- [Paid exit cost](https://idx.archipelagodex.xyz/x402/exit/0x3945df1f8dd8f753fb62e428f3aaeb2c185a6e26): GET /x402/exit/<token address>?usd=100,1000 answers 402 with the x402 payment terms, then what buying and selling that much of the token costs, at one to 3 sizes you choose, once paid
- [Paid wallet balances](https://idx.archipelagodex.xyz/x402/balances/0xdcf7a2683acaac06e85a50c15baf59c8e8b1e681): GET /x402/balances/<wallet address>?tokens=<token address>,<token address> answers 402 with the x402 payment terms, then the wallet's USDC and its balance of each token, valued and flagged, once paid
- [Tokens sharing a ticker](https://idx.archipelagodex.xyz/tickers?q=ISLE): free; every token Archipelago tracks whose ticker reads the same, with an official asset's own contract first

## Optional

- [Sitemap](https://archipelagodex.xyz/sitemap.xml): the site's pages and its token pages, at /token/<address>
- [Security contact](https://archipelagodex.xyz/.well-known/security.txt)