---
title: "Get a project"
method: GET
path: "/api/public/v1/projects/{slug}"
tags: ["Projects"]
---

# Get a project

`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.

## Path parameters

- `slug` string, required — URL-safe identifier of the project.

## Response `200`

The project and its stats.

- ProjectDetailResponse
  - `identity` object, required — Stable identifiers and handles for the project.
    - `slug` string, required — URL-safe identifier, used as the `{slug}` path parameter.
    - `displayName` string, required — Human-readable project name.
    - `fid` number — Farcaster ID of the project account, if any.
    - `xHandle` string, nullable, required — X (Twitter) handle without the leading @, or null.
    - `farcasterUsername` string — Farcaster username, if any.
  - `content` object, required — Display content for the project profile.
    - `bannerImageUrl` string — Absolute URL of the profile banner image.
    - `pfpUrl` string — Absolute URL of the profile picture.
    - `bio` string[], required — Profile bio, as an ordered list of paragraphs.
    - `telegramUrl` string, nullable — Telegram link, if any.
    - `websiteUrl` string, nullable — Project website, if any.
    - `teamMembers` object[] — Public team roster for the project.
      - `name` string, required — Team member’s name.
      - `pfpUrl` string, required — Absolute URL of the team member’s profile picture.
      - `followerCount` number, required — Farcaster follower count.
      - `roles` object[], required — Positions the member holds, across this and other projects.
        - `projectName` string, required
        - `title` string, required
      - `farcasterUrl` string, nullable — Link to the member’s Farcaster profile, if any.
      - `xUrl` string, nullable — Link to the member’s X profile, if any.
  - `expectedLaunch` union — When the project expects to launch, expressed as a precise datetime, a month, or a free-text label. The `kind` field discriminates the shape of `value`.
    - object
      - `kind` 'datetime', required
      - `value` string, required — ISO 8601 timestamp of the expected launch.
    - object
      - `kind` 'month', required
      - `value` string, required — Expected launch month, e.g. "2026-07".
    - object
      - `kind` 'label', required
      - `value` string, required — Free-text launch window, e.g. "Soon".
  - `status` object, required — Verification and protection status flags for the project.
    - `isProfileRegistered` boolean, required — Whether the project has registered a profile with AutoBoy.
    - `isLaunchVerified` boolean, required — Whether the project has verified its token deployment will support auto-buys via AutoBoy.
    - `hasSniperProtection` boolean, required — Whether the project has enabled Sniper Protection, deploying its token via AutoBoy at launch.
  - `defaultMinSpendUsdc` string — Owner-only. Minimum autobuy spend in USDC required from every user on this project, overriding the global floor. Present only when the requesting API key owns the project.
  - `launchConfig` object — Owner-only. The launchpad this project deploys on and its pool config, as `{ platform, config }`. For `platform: "clanker"` the config is the Clanker V4 deployment config (token admin, pool, fees); for `platform: "bankr"` it is the token symbol and the percent of supply vaulted. Present only when the requesting API key owns the project.
  - `stats` object, required
    - `buyerCount` integer, required — Number of accounts that have placed an order for the project.
    - `launch` object, nullable, required — Launch details once the token is live, or null before launch.
      - `tokenAddress` string, required — Contract address of the launched token.
      - `chain` 'base' | 'robinhood', required — Chain the launched token is on.
      - `launchedAt` string, required — ISO 8601 timestamp of the launch.
    - `simulatedMaxFdvUsdc` string — Owner-only. Simulated fully-diluted valuation in USD with AutoBoy buys.
    - `startingMcapUsdc` string — Owner-only. Starting market cap in USD from the deployment pool config.
    - `totalDepositedUsdc` string — Owner-only. USDC currently deposited across buyer smart wallets.
    - `totalBuysUsdc` string — Owner-only. Total committed buy spend in USDC across all buyers.
    - `averageBuyUsdc` string — Owner-only. Average committed buy spend in USDC per buyer.

## Other responses

- `401` — Missing or invalid API key.
- `404` — No project matches the slug.
- `429` — Rate limit exceeded. Wait `Retry-After` seconds before retrying.

## Changes

- **2026-09-03** `56f5091b8f06` — 2 warning
  - removed the optional property `defaultMaxSpendUsdc` from the response with the `200` status
  - removed the optional property `maxSpendOverrides` from the response with the `200` status
- **2026-07-26** `551d21683ba6` — 1 warning, 3 info
  - removed the optional property `clanker4DeploymentConfig` from the response with the `200` status
  - added the optional property `defaultMinSpendUsdc` to the response with the `200` status
  - added the optional property `launchConfig` to the response with the `200` status
  - added the required property `stats/launch/chain` to the response with the `200` status

[Change history](https://skmtc.dev/thefirm/apis/autoboy-public-api/changes/api/public/v1/projects/:slug/get.md)

---

[API](https://skmtc.dev/thefirm/apis/autoboy-public-api.md) · [All operations](https://skmtc.dev/thefirm/apis/autoboy-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thefirm/autoboy-public-api/revisions/56f5091b8f06/schema)