# Join the waitlist Source: https://docs.thefirm.biz/accessing-the-app 𝐀𝐮𝐭𝐨𝑩𝒐𝒚© by The Firm is currently in **closed beta.** Access to the app is gated to select allowlisted users. Take a ticket ☞ [https://thefirm.biz/autoboy/waiting-room](https://thefirm.biz/autoboy/waiting-room) Waiting Room Meta 1200x630 You will receive your position in the queue - the current wait time is *63 business weeks*. But please remain calm - **you can get in sooner by cutting the line**. Follow the on-screen instructions to share a tweet and get direct access to an exclusive Telegram group. 𝕏 [@TheFirmPressHQ](https://x.com/TheFirmPressHQ) 𝕏 [@firmjeff](https://x.com/firmjeff)  Kindly [contact Jeffrey (Computer Operator) directly](/contact) Want to understand how AutoBoy works? See [How it works](/order-execution) Quickstart: Projects # Create an API key Source: https://docs.thefirm.biz/api-reference/api-keys/create-an-api-key https://thefirm.biz/api/public/v1/openapi.json post /api/public/v1/api-keys Creates a new API key, its associated AutoBoy user and wallet. Call this first — it needs no credentials, and every other endpoint takes the key it returns. - The plaintext `apiKey` is returned **exactly once** and is never recoverable afterwards. - Provisioning takes **~1–2s** as it creates a Privy account and an on-chain smart wallet. - `label` must be unique across all keys. If it is taken you get a `409` — retry with a different one. - Rate limited per IP. Over the limit returns a `429`. # Get AutoBoy wallet Source: https://docs.thefirm.biz/api-reference/autoboy-wallet/get-autoboy-wallet https://thefirm.biz/api/public/v1/openapi.json get /api/public/v1/wallet Returns the AutoBoy smart wallet address associated with the API key, along with native ETH and the ERC-20 tokens it holds that AutoBoy has indexed, keyed by chain. Held tokens AutoBoy has not indexed are omitted. Each chain lists its spend currency first. # Withdraw an asset Source: https://docs.thefirm.biz/api-reference/autoboy-wallet/withdraw-an-asset https://thefirm.biz/api/public/v1/openapi.json post /api/public/v1/wallet/withdrawals Withdraws an ERC-20 token or native ETH from the AutoBoy smart wallet associated with the API key to any destination address. - `chain` selects the network to withdraw from, and defaults to `base` when omitted. - `tokenAddress` must be a contract on that chain — the same address on a different chain is a different asset. - The endpoint waits for the on-chain receipt and returns the final transaction hash. # Create buy orders Source: https://docs.thefirm.biz/api-reference/buy-orders/create-buy-orders https://thefirm.biz/api/public/v1/openapi.json post /api/public/v1/orders Creates one or more pre-launch buy orders for the listed projects — each buy order auto-buys that project's future token at launch. - Each item is processed independently. The response is always HTTP 200 once authenticated and the body is valid — check the per-item `ok` flag in `results` (index-aligned to your request) for each outcome. - Re-ordering a project that already has an active buy order is idempotent (`status: "unchanged"`). # Delete buy orders Source: https://docs.thefirm.biz/api-reference/buy-orders/delete-buy-orders https://thefirm.biz/api/public/v1/openapi.json delete /api/public/v1/orders Deletes one or more of the caller's buy orders, keyed by project slug. - Idempotent: deleting a project that has no active buy order returns `status: "already_deleted"` instead of an error. - Each item is processed independently. The response is always HTTP 200 once authenticated and the body is valid — check the per-item `ok` flag in `results` (index-aligned to your request) for each outcome. # List buy orders Source: https://docs.thefirm.biz/api-reference/buy-orders/list-buy-orders https://thefirm.biz/api/public/v1/openapi.json get /api/public/v1/orders Returns a cursor-paginated page of the API key owner's buy orders, ordered by spend amount. Excludes deleted buy orders unless `?status=deleted` is passed. # Update buy orders Source: https://docs.thefirm.biz/api-reference/buy-orders/update-buy-orders https://thefirm.biz/api/public/v1/openapi.json patch /api/public/v1/orders Updates the spend cap, FDV cap, or expiry of one or more active buy orders. Each item is processed independently. The response is always HTTP 200 once authenticated and the body is valid — check the per-item `ok` flag in `results` (index-aligned to your request) for each outcome. # Send feedback Source: https://docs.thefirm.biz/api-reference/feedback/send-feedback https://thefirm.biz/api/public/v1/openapi.json post /api/public/v1/feedback Send feedback to The Firm. No API key required - the Computer Operations Division reads each note and reaches out via the contact provided when a reply is warranted. # Get current identity Source: https://docs.thefirm.biz/api-reference/identity/get-current-identity https://thefirm.biz/api/public/v1/openapi.json get /api/public/v1/me Returns the identity behind the API key used to make the request: its AutoBoy smart wallet, label, and the slugs of the projects it owns. # Get a project Source: https://docs.thefirm.biz/api-reference/projects/get-a-project https://thefirm.biz/api/public/v1/openapi.json get /api/public/v1/projects/{slug} Returns a project profile and its current stats. If your API key is associated with the project, the response includes additional owner-only stats. # List a project's buyers Source: https://docs.thefirm.biz/api-reference/projects/list-a-projects-buyers https://thefirm.biz/api/public/v1/openapi.json get /api/public/v1/projects/{slug}/buyers Returns a cursor-paginated page of a project's buyers, ordered by follower count (highest first). When the request's API key owns the project, each buyer additionally carries `maxSpendUsdc` & `maxFdvUsdc`. # List projects Source: https://docs.thefirm.biz/api-reference/projects/list-projects https://thefirm.biz/api/public/v1/openapi.json get /api/public/v1/projects Returns a cursor-paginated list of public project profiles. Pass the `meta.nextCursor` from a response as the `cursor` of the next request to page forward. # Register a project Source: https://docs.thefirm.biz/api-reference/projects/register-a-project https://thefirm.biz/api/public/v1/openapi.json post /api/public/v1/projects Submit a project or agent for registration with AutoBoy. No API key required - Jeffrey (Computer Operator) reviews each submission and responds via the contact provided. On approval you receive your API key. # Quickstart Source: https://docs.thefirm.biz/auto-boy-api The AutoBoy Public API is a REST API for browsing projects, tracking your own launch, placing pre-launch buy orders, and managing your AutoBoy smart wallet. The full API reference - every endpoint, request schema, and response example - is available in the interactive [API reference](https://thefirm.biz/api/public/v1/docs). ## What you can do * **Browse projects** – list projects and read detailed stats for a single launch. * **See a project's buyers** – view the accounts buying a project's future token. * **Register a project** – submit your project or agent to AutoBoy. * **Place buy orders** – create, update, and cancel your pre-launch buy orders. * **Manage your wallet** – read your AutoBoy smart wallet balances and withdraw assets. *** ## Base URL All requests are made over HTTPS to: ```text theme={null} https://thefirm.biz/api/public/v1 ``` ## Get an API key Most endpoints require an API key. Keys aren't self-serve – Jeffrey (Computer Operator) reviews each request and you'll hear back via the contact you provide. ### **Buying tokens:** Request a key directly: [**API Reference: Request an API key**](https://docs.thefirm.biz/api-reference/api-keys/request-an-api-key) ```text theme={null} POST https://thefirm.biz/api/public/v1/api-key-requests ``` ### **Launching a token:** Register your project - (approval comes with your API key): [**API Reference: Register a project**](https://docs.thefirm.biz/api-reference/projects/register-a-project) ```text theme={null} POST https://thefirm.biz/api/public/v1/projects ``` *** ## Authenticate requests Send your key as a bearer token on every authenticated request: ```text theme={null} Authorization: Bearer autoboy_… ``` ## Verify your key List projects to confirm your key works: ```bash theme={null} curl https://thefirm.biz/api/public/v1/projects \ -H "Authorization: Bearer autoboy_…" ``` A `200` with a JSON list of projects means you're set up. *** ## API reference Browse every endpoint, request schema, and response example in the interactive [API reference](https://thefirm.biz/api/public/v1/docs). # Contact Source: https://docs.thefirm.biz/contact Contact Jeffrey (Computer Operator) for all queries. ## Jeffrey (Computer Operator) * [https://x.com/firmjeff](https://x.com/firmjeff) * [https://farcaster.xyz/firmjeff](https://farcaster.xyz/firmjeff) ## Registering your project For project registration, please contact [Jeffrey (Computer Operator) on Telegram](https://telegram.me/firmjeff?text=Hi%20Jeff%0AI%20have%20a%20project%20I%20would%20love%20to%20register%20with%20AutoBoy.%0A%0AProject%20Name%3A%0AProject%20URL\(s\)%3A%0AProject%20Details%3A%0AContact%20Email%3A%0AFounder\(s\)%20social%20account\(s\)%3A%0A%0A%5Binsert%20business%20sign-off%20here%5D), completing the following message: ```text theme={null} Hi Jeff I have a project I would love to register with AutoBoy. Project Name: Project URL(s): Project Details: Contact Email: Founder(s) social account(s): [insert business sign-off here] ``` ## Requesting access to the user app * For access to AutoBoy, join [the Telegram channel](https://t.me/thefirmwelcome) for a notification when allowlist opens up, or contact [Jeffrey (Computer Operator) on Telegram](https://t.me/firmjeff) if you think you'd be a good closed beta candidate. # Dev Buys Source: https://docs.thefirm.biz/dev-buys Projects can use AutoBoy to coordinate a dev buy for their token. Currently this requires projects to use AutoBoy to deploy their token via Clanker or Liquid. AutoBoy executes the deployment transaction which includes a dev buy in the same tx. Every user buys in block zero and is sniper-protected. > Every AutoBoy user gets *the same price*, in *block zero —* before snipers even get a whiff. Buyers [place an order for the project](/orders), choosing how much to spend. Before deployment, the committed funds (USDC etc) are collected to the deployer address. The deployment transaction includes the dev buy, so every order executes in block zero at the same price — before snipers can act. AutoBoy redistributes the dev-bought tokens pro-rata to each user's [AutoBoy wallet](/wallets-and-funds), automatically. **Dev Buy projects are curated.** Deployments are done by the ENS [autoboy.eth](http://app.ens.domains/autoboy.eth) — it can be expected that snipers are monitoring this address, so The Firm curates projects that launch with this method. Launching with a dev buy? You can also lock and vest your buyers' tokens # Fees Source: https://docs.thefirm.biz/fees ## Platform Fee * AutoBoy charges a **3% platform fee** for every successful buy. * The platform fee is taken *in the project token you bought.* * The platform fee is taken *after* the swap, so it isn't part of the [effective market cap](/mcap-calculation) AutoBoy evaluates your order against. ## Gas Fee * AutoBoy **sponsors all gas fees** on Base & Robinhood. ## Sniper Fees * Executed swaps incur Sniper fees & LP fees as defined by the pool. * Sniper & LP Fees are factored into the current token price when AutoBoy evaluates whether a user's order parameters are met. See [Market cap calculation](/mcap-calculation) # Introduction Source: https://docs.thefirm.biz/index 𝐀𝐮𝐭𝐨𝑩𝒐𝒚© by The Firm© is **the pre-launch order book for upcoming tokens**, enabling users to **line up buy orders for a project's token *before the token even launches***. ☞ [https://thefirm.biz/autoboy/welcome](https://thefirm.biz/autoboy/welcome) It works with any launchpad. *** ## For Projects AutoBoy is a brand new tool in your TGE toolkit. It means you **launch with an order book of committed buys**, it turns buyers into **distribution before & after TGE**, and gives you real insights before you launch: who will buy, how much, and at what price. Quickstart: **Projects** ☞ ## For Buyers Discover pre-TGE projects, create orders for their future tokens, and wait for the launch: AutoBoy executes their auto-buy *the moment the token goes live*. Quickstart: **Buyers** ☞ *** ## How does AutoBoy work? Projects register their launch, sharing their **token creator address and launch method** with AutoBoy. See: [Registering a Token Launch](/register-a-launch) Users browse registered projects and create buy orders for any token they want: setting how much to spend and the highest market cap they're willing to buy at. See: [Creating Buy Orders](/orders) See: [Wallets & Funds](/wallets-and-funds) AutoBoy’s realtime indexer detects the launch and swaps each user’s stablecoins into the token's Uniswap pool according to their order parameters. See: [What happens when a project deploys their token?](/order-execution) # Links Source: https://docs.thefirm.biz/links ## Web * [https://thefirm.biz/autoboy](https://thefirm.biz/autoboy) ## Social channels * `Telegram ` [https://t.me/thefirmwelcome](https://t.me/thefirmwelcome) * `X ` [https://x.com/TheFirmPressHQ](https://x.com/TheFirmPressHQ) * `Farcaster` [https://farcaster.xyz/thefirm](https://farcaster.xyz/thefirm) # Market Cap calculation Source: https://docs.thefirm.biz/mcap-calculation AutoBoy prices tokens by calculating the *effective market cap* of a buy. This is the market cap a user is *effectively* paying when you account for pool fees that reduce how many tokens they actually receive - most importantly sniper taxes, but also LP fees. Here’s an example of a calculation: * Token A is a Clanker launch with an absolute market cap of \$200k. * It’s currently within the *sniper tax period:* swaps in the next block incur a *50% sniper tax,* meaning half of the user’s swap goes to sniper fees, not to buying the token. Swaps for this token are effectively paying *twice the price*. * AutoBoy therefore calculates the *effective market cap* as \$400k. * Any orders with a max market cap of *\$400k or higher* are valid and AutoBoy will attempt to execute them. Note - the 3% [platform fee](/fees) is taken in the token you bought, after the swap - it's separate from this calculation and from your [Max Price (MCap)](/setting-max-price). ## When it's recalculated After launch, AutoBoy reevaluates the effective market cap by getting the current price of the most liquid Uniswap pool: 1. Every time there is a swap from the pool 2. Every block during fee periods where time is a modifier (i.e. during the Clanker sniper tax period) Each time, if your order's conditions are met, AutoBoy executes the buy. # Order Execution Source: https://docs.thefirm.biz/order-execution What happens when a project deploys their token? AutoBoy’s realtime indexer picks up the launch using information the project shared in advance. See: [How fast is AutoBoy?](/speed) AutoBoy continuously tracks the token’s market cap to see which orders are ready to fill. See: [Market Cap Calculation](/mcap-calculation) When an order’s conditions are met (see [Creating buy orders](/orders)), AutoBoy swaps the user’s stablecoin funds for the token via its Uniswap pool. The tokens sit in the user’s AutoBoy wallet, ready to withdraw anytime. See: [Wallets & Funds](/wallets-and-funds) *** ## Order Prioritization AutoBoy always aims to give priority to 'good' holders. Order submission prioritisation will adapt over time and is subject to change. AutoBoy can control the order in which it submits transactions to the RPC - but we cannot control the order in which the RPC or L2 sequencers order those transactions. For auto-buys on the open market, AutoBoy prioritizes transaction submission based on the order's parameters: 1. **Spend amount descending**: i.e. bigger orders fill first. 2. **Market cap descending**: i.e. execution is attempted for orders willing to buy at the highest market cap first (where ‘No limit’ is the highest). Market cap is a tiebreaker when two orders share the same spend amount. **Examples:** * A buy order for 200 USDC will be prioritized over a buy order for 100 USDC. * A buy order for 200 USDC with a max 500K MCap will be prioritised over a buy order for 200 USDC with a max 100K MCap. # Order expiry Source: https://docs.thefirm.biz/order-validity Users control how long their AutoBoy orders are valid for once a token launches. Order expiry determines **how long AutoBoy will keep trying to fill an order after the token launches**. If the order's parameters are not met before the expiry time, the order will be invalidated and AutoBoy will stop trying to buy the token for you. Example: You set an order to expire 4 hours after launch, AutoBoy will monitor the token price and keep reevaluating whether to buy (executing once your buy conditions are met) for up to 4 hours after the launch, then invalidate the order so it doesn’t accidentally auto-buy later. *** ## If your order doesn't fill before the expiry period If the token's price stays above your [Max Price (MCap)](/setting-max-price) until order expiry, the order expires unfilled and AutoBoy stops trying. Your stablecoin funds stay in your wallet. *** ## If the token hasn't launched yet Your order just waits — there's no pre-launch expiry, so it stays active until the token launches or you cancel the order. # Creating buy orders Source: https://docs.thefirm.biz/orders ## How do users create buy orders in AutoBoy? AutoBoy lets users create a buy order for a project's future token. These buy orders **will be automatically executed when the token launches**. ### Order Parameters How much you want to **spend** on the token. [Spend (USD)](/spend); The **Max Price** (measured in MCap) you’re willing to pay. [Max Price (MCap)](/setting-max-price); How long *after* launch the order **remains valid** for. [Order expiry](/order-validity). AutoBoy will then prompt you to deposit funds to your AutoBoy wallet if you haven't already. (see '[Funding your wallet](/wallets-and-funds)') *** ## What happens when a project launches? Assuming you have funds in [your AutoBoy wallet](/wallets-and-funds) - AutoBoy will automatically attempt your buy based on the order parameters you set. Your buy order won’t be executed until/unless these parameters are met. See: [How it works.](/order-execution) # OTC Buys Source: https://docs.thefirm.biz/otc-buys AutoBoy is an inherently flexible system designed to solve problems on both sides of the token launching marketplace. Users want to participate in the best token launches on Base. Therefore, AutoBoy can broker *a single pooled buy* of the project’s token directly with the project, on behalf of its users. Buyers [place an order for the project](/orders), choosing how much to spend. AutoBoy strikes a deal directly with the project on behalf of its committed buyers. Rather than many separate swaps, AutoBoy makes one pooled buy of the project's token. Each user receives their share in their [AutoBoy wallet](/wallets-and-funds). This suits launches where a project wants to place a block of tokens with quality holders directly. # Registering a token launch Source: https://docs.thefirm.biz/register-a-launch Create an AutoBoy profile for your project's upcoming token launch ## Registering unlocks: * Your project's unique shareable AutoBoy profile e.g. [https://thefirm.biz/autoboy/charms](https://thefirm.biz/autoboy/charms). * Users can **create buy orders for your project's future token**. * Users can **discover & search for your project** in-app. * AutoBoy may **feature your launch in-app.** * AutoBoy may **amplify your launch via socials and direct notifications.** * Users are incentivised to **amplify your TGE on their socials** when they create a buy order. * **TGE insights**: who will buy your token, how much and at what price. You don't need every detail finalised, speak to Jeffrey TODAY ☞ Contact Rep (1) ## How to register: [Contact Jeffrey on Telegram](https://telegram.me/firmjeff?text=Hi%20Jeff%0AI%20have%20a%20project%20I%20would%20love%20to%20register%20with%20AutoBoy.%0A%0AProject%20Name%3A%0AProject%20URL\(s\)%3A%0AProject%20Details%3A%0AContact%20Email%3A%0AFounder\(s\)%20social%20account\(s\)%3A%0A%0A%5Binsert%20business%20sign-off%20here%5D) with your project details and whatever you know about your launch: ```text theme={null} Hi Jeff I have a project I would love to register with AutoBoy. Project Name: Project URL(s): Project Details: Contact Email: Founder(s) social account(s): [insert business sign-off here] ``` You can also tell your agent to register [via our REST API](https://docs.thefirm.biz/api-reference/projects/register-a-project) We check that AutoBoy [supports your launchpad](/supported-launchpads) and that we have all the essential information. Your profile goes live with a **Verified Launch** stamp and users can start creating buy orders for your token immediately. # Max MCap (Price) Source: https://docs.thefirm.biz/setting-max-price AutoBoy calculates an [effective market cap](/mcap-calculation): factoring in all pool fees, including sniper taxes, when evaluating a token's price. The 3% [platform fee](/fees) is taken *after* a successful swap. The 'Max MCap (Price)' is **the maximum market cap you’re willing to buy the token at:** in other words. **the highest price you’re willing to pay** for the token. It doesn’t mean you *will* pay this much to buy the token, it’s just the upper limit. ### Setting Max MCap (Open Market Orders) When creating or adjusting an open market order, you can choose a custom Max MCap, or choose a default. Max MCap Input Hit "Clear" to enter Expert Mode (NO LIMIT): this means your auto-buy will happen as quickly as possible after launch, regardless of high prices. Max MCap No Limit ### What Max MCap (Price) should I set? * Choosing a Max MCap is your decision. For reference, tap the ? icon above the input box to see the current MCaps of some other tokens. * Still not sure? Choose one of the defaults; the higher default will give your order a better chance at success at a potentially higher price. * A note on NO LIMIT: The effective MCap of a token is often higher than you may expect for a brief period after launch (see "Sniper Tax" in [Market Cap Calculation](mcap-calculation)), so although **NO LIMIT** virtually guarantees an early buy, it may come at a high price. *Set a Max MCap if you're price-sensitive.* See also: Market Cap Calculation # Speed Source: https://docs.thefirm.biz/speed ## How Fast is AutoBoy? AutoBoy currently **lands swaps within 4-6s of deployment**. We are always bringing that number down. *** # Spend (USD) Source: https://docs.thefirm.biz/spend The amount you want to spend on the project's token, measured in a USD stablecoin. AutoBoy can only spend funds deposited to your AutoBoy wallet. See: [Wallets & funds](/wallets-and-funds) At launch, AutoBoy spends up to your Spend amount, capped by your wallet balance (assuming your other order parameters are met). ## Not enough funds? AutoBoy spends as much of your balance as it can, up to your Spend amount. ## No funds? If your wallet is empty, no buy is attempted when the project launches. # Supported launchpads Source: https://docs.thefirm.biz/supported-launchpads ## **✅ Currently supported** * Clanker * Bankr * Liquid ## **🏗️ Support being built right now** * ... *** ### Don’t see the launchpad you want to launch with? AutoBoy is the orderbook for *any* launchpad - a flexible system designed to work regardless of your launch method. [Let us know](/contact) if you want to launch with something we don’t support yet. # Wallets & funds Source: https://docs.thefirm.biz/wallets-and-funds Your AutoBoy wallet is a kernel smart wallet, managed by Privy, that holds both your funds and the tokens AutoBoy buys for you. ## Funding your wallet Deposit Base USDC or Robinhood USDG into your AutoBoy wallet. You can fund it whenever you like — before you place any orders, or when you place your first buy order (AutoBoy will prompt you if you haven't yet). Your deposited funds stay in your wallet until AutoBoy use them to fulfil one of your orders, on your behalf, once that order's conditions are met. *** ## One balance, shared across orders All your orders on a chain draw from the same pool of funds: your USDC on Base, for example, isn't locked to a single order. But don't worry; AutoBoy lets you know each time it makes a buy, so you can top up your wallet again to be ready for your next auto-buy. *** ## After a buy Tokens AutoBoy buys for you are held in the same AutoBoy wallet, alongside any funds you haven't spent. You can withdraw your funds or your purchased tokens to any wallet, at any time. # Why use AutoBoy Source: https://docs.thefirm.biz/why-launch AutoBoy is the missing link in your TGE toolkit. It works with any launchpad. 𝐀𝐮𝐭𝐨𝑩𝒐𝒚© is currently in **closed beta** with a select group of the best early token holders on Base. [Register your token launch](/register-a-launch) to get your TGE front of them. ## **Amplification & Distribution** * **AutoBoy amplifies you** – Get 'featured' by AutoBoy to reach the right eyeballs both in-app and via direct notifications: influential, high-signal users active in early token launches on Base. * **Your buyers amplify you –** AutoBoy turns your committed buyers into a distribution channel for your TGE. Each buyer gets custom, shareable assets and an incentive to post them, putting your launch in front of their followers - before *and* after launch: Pre-buy checks Social Receipt Sharing ## **Monitor & build demand** * **Build real demand** – **Launch with an order book of committed buys,** rather than praying your community shows up. * **Turn your community into buyers –** Your community already wants your token. AutoBoy lets them act on that demand before you launch, turning latent interest into committed buys. Dashboard Edge * **Buyer insights** – See who will buy your token, how much they will buy, and at what price. Dashboard Buyers * **Preview your launch** – See a simulation of your token’s market cap at launch, based on AutoBoy’s committed auto-buys. Dashboard Launch Simulation ## **Quality holders** * **High-value user base** – AutoBoy is in closed beta with a selected allowlist of high-signal users - the kind you want as early token holders. * **Allowlist your buyers (optional) –** You may allowlist certain users to place orders for your project, further increasing your control over your launch. * **Locking and vesting (optional)** – You may lock and vest your buyers' tokens via a Sablier NFT if you use AutoBoy as the token deployer to execute a block-zero [dev buy](/dev-buys).