> ## Documentation Index
> Fetch the complete documentation index at: https://dev.phygitals.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Platform overview

> What Phygitals is, how the product works end-to-end, and the trust layer behind every API call.

## The infrastructure for digital collectibles

Partners sell digital packs backed by real physical cards. End users buy, instantly reveal, securely vault, and then ship or sell whenever they want. Phygitals operates **the most advanced B2B rails for digital collectibles**, and every number below is live traffic on the same endpoints you're about to integrate.

<CardGroup cols={3}>
  <Card title="$350M+" icon="chart-line">
    GMV
  </Card>

  <Card title="2.8M+" icon="box-open">
    Transactions
  </Card>

  <Card title="100K+" icon="users">
    Active users
  </Card>

  <Card title="85%" icon="arrow-rotate-left">
    Buyback guarantee on every card
  </Card>

  <Card title="24/7" icon="globe">
    Global marketplace, no regional limits
  </Card>

  <Card title="Multi-category" icon="layer-group">
    Sports, Pokemon, TCG, and more
  </Card>
</CardGroup>

## The four-step user flow

Every pack purchase follows the same lifecycle, on Phygitals' own storefront or a partner's white-label. Partner APIs plug into each stage.

<Steps>
  <Step title="Buy a pack">
    Purchased digitally with credit card or crypto. Each pack is backed by real physical cards held in partner-facing inventory.

    Powered by [`/api/v1/vm/buy/init`](/api-reference/purchase/init) and [`/api/v1/vm/buy/status`](/api-reference/purchase/status).
  </Step>

  <Step title="Instant reveal">
    The user watches their cards revealed live. No delayed fulfillment, no "what did I get" ambiguity. The outcome is known the moment the pack is opened.
  </Step>

  <Step title="Securely vaulted">
    Cards are stored in top-tier insured US facilities. The user owns the digital representation; the physical asset sits in the vault until they act on it.

    Holdings are surfaced through [`/api/v1/inventory/:user_id`](/api-reference/inventory).
  </Step>

  <Step title="Ship or sell">
    The user can redeem a vaulted card for physical shipping worldwide via [`/api/v1/ship/request`](/api-reference/shipping/request), or sell it back at 85% of FMV for instant liquidity via [`/api/v1/vm/buyback`](/api-reference/sellback).
  </Step>
</Steps>

## What the API unlocks

<CardGroup cols={2}>
  <Card title="All card categories" icon="layer-group">
    Sports, Pokemon, TCG, and adjacent collectibles on one unified rail.
  </Card>

  <Card title="Digital + physical parity" icon="cube">
    Every digital collectible is 1:1 backed by a real, graded, vaulted card. The API surfaces both sides.
  </Card>

  <Card title="Instant liquidity" icon="coins">
    85% buyback on every card. Partners never need to source a secondary market, and users can always cash out.
  </Card>

  <Card title="Always-on global trading" icon="globe">
    24/7 marketplace with no regional restrictions. Integrators don't need to solve cross-border logistics themselves.
  </Card>
</CardGroup>

## Vault, pricing, and logistics

All physical items backing the digital inventory sit in top-tier insured US vaults. Phygitals runs a **deep partnership with [Alt](https://www.alt.xyz/)** for both vaulting and pricing, with PSA and Fanatics as additional custodians.

|                          |                                                                                                                                                  |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Vault partners**       | Alt (primary), PSA, Fanatics                                                                                                                     |
| **Pricing oracle**       | Alt. Live FMV feed powers `buyback_price` on every item and every sellback transaction                                                           |
| **Dedicated vault team** | A team *inside* Alt's operations is dedicated to Phygitals. They handle all inbound grading, inventory moves, partner shipments, and redemptions |
| **Insurance**            | Full coverage across all stored items                                                                                                            |
| **Storage conditions**   | Climate-controlled facilities                                                                                                                    |
| **Fulfillment**          | Worldwide shipping, tracking and insurance included on every redemption                                                                          |

<Note>
  This matters for API consumers: inventory and vault fields in the API reference real physical locations under real custodians. The partner is not storing or fulfilling anything themselves. Phygitals operates the full physical stack end-to-end.
</Note>

## Phygitals funds the buybacks

The 85% buyback guarantee is underwritten by Phygitals, not by the partner. When a user calls [`/api/v1/vm/buyback`](/api-reference/sellback), the liquidity comes from us. Partners don't post capital, don't run a secondary market, and don't carry sellback risk. You route the call, we pay the user.

## White-label launches, fully managed

Phygitals operates as both a direct-to-consumer platform and infrastructure for partner brands. Partners can launch their own branded pack experience on top of the same rails the main Phygitals site runs on.

Depending on what the partner needs, a launch can include:

<CardGroup cols={2}>
  <Card title="Full frontend build" icon="browser">
    Phygitals designs and builds the complete branded storefront: pack catalog, checkout, reveal animations, inventory UI. You don't need to ship a line of code.
  </Card>

  <Card title="Full backend build" icon="server">
    Pack inventory management, user accounts, payment processing (card + crypto), fulfillment hooks, reporting. All wired to this API.
  </Card>

  <Card title="API-only integration" icon="code">
    If you already have an app, plug in directly via the endpoints in this docs and keep full control of the frontend.
  </Card>

  <Card title="Dedicated support" icon="headset">
    Every partner gets a dedicated point of contact for launch, live operations, incident response, and roadmap input. Not a shared support queue.
  </Card>
</CardGroup>

| Path                                        | What it is                             |
| ------------------------------------------- | -------------------------------------- |
| [`/claw`](https://phygitals.com/claw)       | End-user pack catalog on the main site |
| `/whitelabel/{partner-slug}`                | Partner-branded storefront             |
| [`/contact`](https://phygitals.com/contact) | Brand inquiry form                     |
|                                             |                                        |
|                                             |                                        |

## Contact and legal

* **Partnership inquiries:** [hello@phygitals.com](mailto:hello@phygitals.com)
* **Terms of service:** [docs.phygitals.com/user-agreements/terms-of-service](https://docs.phygitals.com/user-agreements/terms-of-service)
* **Privacy policy:** [docs.phygitals.com/user-agreements/privacy-policy](https://docs.phygitals.com/user-agreements/privacy-policy)