Looking for partner integrations (listing packs, purchasing on behalf of your users, inventory, shipping)? See the Enterprise API tab.
What you can do
List available packs
Fetch pack catalog, pricing, EV, and rarity tiers — no API key required.
Get chase cards
Preview high-value cards for a pack before opening it.
Browse marketplace listings
Search, filter, and paginate buy-now cards — no API key required.
Buy packs with crypto
Submit signed payment transactions and poll for fulfillment on claw machines.
Sell back claw items
Accept instant buyback offers on items you own from claw pulls.
Base URL
| Environment | Base URL |
|---|---|
| Production | https://api.phygitals.com |
/api/vm/* and /api/marketplace/* do not require a key. Authenticated purchase and sellback endpoints use the same path prefixes with a user API key.
How it works
Check eligibility
Open Settings → API keys on phygitals.com. You need API keys enabled on your account and a linked external Solana wallet.
Create a key
Name your key and choose an optional expiration. Copy the secret immediately — it is shown only once.
Call an endpoint
Send the key on every request via
X-API-Key or Authorization: Bearer. Build and sign the on-chain transactions client-side, then submit them to the API.Endpoint summary
| Method | Path | Scope | Description |
|---|---|---|---|
GET | /api/vm/available | — | List available packs |
GET | /api/vm/chase/:slug | — | Get chase cards for a pack |
GET | /api/marketplace/marketplace-listings | — | List marketplace listings |
GET | /api/marketplace/filters | — | Get marketplace filter facets |
POST | /api/vm/buy/crypto | vm.buy.crypto | Submit a crypto pack purchase |
POST | /api/vm/buy/status | vm.buy.crypto | Poll purchase fulfillment |
POST | /api/marketplace/transaction/take-claw-bid-init | marketplace.take-claw-bid | Start a claw buyback |
POST | /api/marketplace/transaction/take-claw-bid-finish | marketplace.take-claw-bid | Complete a claw buyback |
Public API vs Enterprise API
| Public API | Enterprise API | |
|---|---|---|
| Who | Individual Phygitals users | Partners and platforms |
| Keys | Self-service (phy_… prefix) | Issued by Phygitals (X-API-Key) |
| Scope | Your account and wallets | Your end users via user_id |
| Use cases | Bots, scripts, custom tooling | Embedded pack storefronts, vault apps |