# Portir

> US stocks on BNB Chain, bought at a fair price. Plans, Loan Guard and an agent on BNB Agent Studio.

- [Portir Docs](https://docs.portir.xyz/index.md): US stocks on BNB Chain, bought at a fair price. Start here.
- [Introduction](https://docs.portir.xyz/get-started/introduction.md): What Portir is, the problem it solves, and who it is for.
- [How it works](https://docs.portir.xyz/get-started/how-it-works.md): The path from a tap on Buy (or a due plan) to a recorded transaction.
- [FAQ](https://docs.portir.xyz/get-started/faq.md): Short answers to the questions people ask first.
- [Quickstart for investors](https://docs.portir.xyz/get-started/quickstart-users.md): Your first guarded buy and your first plan, on testnet, in five minutes.
- [Quickstart for developers](https://docs.portir.xyz/get-started/quickstart-developers.md): Plug Portir into Claude or your own agent in one command, through MCP.
- [Supported chains and assets](https://docs.portir.xyz/resources/supported-assets.md): Where Portir runs and what you can buy, pay with and borrow against.
- [Contract addresses](https://docs.portir.xyz/resources/contract-addresses.md): Every Portir contract, verified on BscScan, plus the external contracts it talks to.
- [Fees](https://docs.portir.xyz/resources/fees.md): Portir charges nothing. Here is everything you do pay, and to whom.
- [Roadmap](https://docs.portir.xyz/resources/roadmap.md): What is live, what is next, and what comes after.
- [Changelog](https://docs.portir.xyz/resources/changelog.md): Notable changes, newest first.
- [Brand and links](https://docs.portir.xyz/resources/brand-and-links.md): Logos, colors and every official Portir link.
- [The Guard](https://docs.portir.xyz/learn/the-guard.md): Four checks before every order, and how GO, WARN and BLOCK are decided.
- [Plans](https://docs.portir.xyz/learn/plans.md): Recurring buys and one-time 'buy when fair' orders that the agent runs from PlanRegistry.
- [Baskets](https://docs.portir.xyz/learn/baskets.md): Four curated baskets bought as one guarded swap per holding, at fixed weights.
- [Sell rules](https://docs.portir.xyz/learn/sell-rules.md): Take-profit and stop-loss orders the agent executes when the real price crosses your trigger.
- [Loan Guard](https://docs.portir.xyz/learn/loan-guard.md): Borrow USDT against your stocks on Venus, with an automatic, capped rescue before liquidation.
- [The agent](https://docs.portir.xyz/learn/the-agent.md): The Portir agent on BNB Agent Studio: what it automates, its three faces, and its two brains.
- [News check](https://docs.portir.xyz/learn/news-check.md): An LLM reads recent headlines before every buy, and may only hold the buy back.
- [Testnet and mainnet](https://docs.portir.xyz/learn/testnet-and-mainnet.md): What runs where today, and what testnet mode actually simulates.
- [Access points](https://docs.portir.xyz/learn/access-points.md): Every way to reach Portir: the app, MCP, x402, A2A and Telegram.
- [Security model](https://docs.portir.xyz/learn/security-model.md): Who can do what, where your money sits, and what a leaked key can and cannot do.
- [Risks](https://docs.portir.xyz/learn/risks.md): What can go wrong, and what Portir does about each risk.
- [Audits](https://docs.portir.xyz/learn/audits.md): Security reviews of the Portir contracts and agent, newest first.
- [KYC and eligibility](https://docs.portir.xyz/learn/kyc-and-eligibility.md): Portir does not collect identity data. Here is who does apply rules, and where.
- [Disclaimer](https://docs.portir.xyz/learn/disclaimer.md): Portir is software, not financial advice.
- [Glossary](https://docs.portir.xyz/learn/glossary.md): Terms used across Portir.
- [Connect a wallet](https://docs.portir.xyz/guides/connect-wallet.md): Use any browser wallet on BNB Chain. No account, no sign-up.
- [Switch between testnet and mainnet](https://docs.portir.xyz/guides/switch-mode.md): Try everything with free test money first.
- [Buy a stock](https://docs.portir.xyz/guides/buy-a-stock.md): A guarded one-tap buy, signed by your wallet.
- [Create a plan](https://docs.portir.xyz/guides/create-a-plan.md): Set a recurring investment that the agent runs only when the price is fair.
- [Buy when it's fair](https://docs.portir.xyz/guides/buy-when-fair.md): Leave a one-time order that the agent fills the moment the price clears.
- [Set a sell rule](https://docs.portir.xyz/guides/set-a-sell-rule.md): Take profit or stop a loss automatically.
- [Portfolio](https://docs.portir.xyz/guides/portfolio.md): Live balances, history and dividends.
- [Borrow with Loan Guard](https://docs.portir.xyz/guides/borrow-with-loan-guard.md): Buy, supply, borrow and protect in one batch.
- [Ask the agent](https://docs.portir.xyz/guides/ask-the-agent.md): Chat with the Portir agent in the app, or bring your own Claude.
- [Telegram reports](https://docs.portir.xyz/guides/telegram-reports.md): Get a message for every run and every rescue.
- [Run your own agent](https://docs.portir.xyz/guides/run-your-own-agent.md): Keep every key yourself: your Claude schedules, Portir checks, your Agentic Wallet trades.
- [Troubleshooting](https://docs.portir.xyz/guides/troubleshooting.md): Common problems and their fixes.
- [Architecture](https://docs.portir.xyz/developers/architecture.md): How the app, the agent, the Guard and the contracts fit together.
- [MCP server](https://docs.portir.xyz/developers/mcp-server.md): Twelve read-only tools for Claude or any MCP client at agent.portir.xyz/mcp.
- [x402 and A2A](https://docs.portir.xyz/developers/x402-and-a2a.md): Talk to the Portir agent over HTTP or as another agent.
- [PlanRegistry](https://docs.portir.xyz/developers/plan-registry.md): Plans, sell rules, capped funding pulls and run history. UUPS upgradeable.
- [LoanGuard](https://docs.portir.xyz/developers/loan-guard-contract.md): Capped, on-chain-checked repayments of Venus loans from the borrower's own wallet.
- [Testnet fixtures](https://docs.portir.xyz/developers/testnet-fixtures.md): Test doubles that make BSC testnet behave like mainnet: tUSDT, TestExchange, MockStocks, StockLendingPool.
- [The executor](https://docs.portir.xyz/developers/executor.md): How the agent runs plans, sell rules and Loan Guard, step by step.

## Optional

- [App](https://app.portir.xyz)
- [Website](https://portir.xyz)
- [Agent card](https://agent.portir.xyz/.well-known/agent-card.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.