Selling Integration Guide
Releasing Soon The Selling API is in active development and will be available soon. Interested in early access? Contact engineering@tradepost.co.
Everything you need to go from zero to live as a Supply Provider on Tradepost — submitting inventory, receiving instant cash offers, and getting paid.
Step 1: Get Access
Contact Tradepost to become an approved Supply Provider. Once approved, you'll receive:
- A Terminal account at terminal.tradepost.co
- Access to the GraphQL API at
https://platform-api.tradepost.co/graphql
Step 2: Set Up Authentication
Generate an API key in Terminal under Settings > API Keys.
Include it in every request as the X-API-Key header:
curl -X POST https://platform-api.tradepost.co/graphql \
-H "Content-Type: application/json" \
-H "X-API-Key: tp_live_your_api_key_here" \
-d '{ "query": "mutation { ... }" }'
See Authentication for error codes and details.
Step 3: Submit Inventory
Push items into the marketplace so they can be matched against Liquidity Provider bids. You can submit items individually or in bulk.
Each item needs:
- Asset type — what category (tickets, sealed TCG, etc.)
- Asset identification — external IDs or Tradepost asset config IDs to identify the specific product
- Quantity and condition — how many units, item condition
- Asking price (optional) — your floor price; offers below this are filtered out
Items can be submitted via the API programmatically or through Terminal manually.
See Selling API for the full endpoint reference.
Step 4: Receive Instant Cash Offers
Once your inventory is live, Tradepost automatically matches it against standing Conditional Bids from Liquidity Providers. When a match is found, you receive an instant cash offer.
Offers appear in your portfolio in Terminal and can be delivered to your system via webhooks. Each offer includes:
- Offer amount — the price a Liquidity Provider is willing to pay
- Expiration — how long the offer is valid
- Buyer details — where to transfer the item if accepted
Offers update in real-time as market conditions change — if a better bid becomes available, your offer price adjusts automatically.
Step 5: Accept and Transfer
When you accept an offer:
- Orders and money movements are created
- You receive transfer instructions (where to send the item)
- You initiate the transfer — either a digital transfer (tickets) or physical shipment (cards, collectibles)
| Asset type | Transfer method | Timeline |
|---|---|---|
| Digital (tickets) | Transfer via originating platform (Ticketmaster, AXS, etc.) | 10-60 minutes |
| Physical (cards, collectibles) | Ship to Liquidity Provider's address | 3-7 days |
After transferring, confirm the transfer via the API or Terminal.
Step 6: Get Paid
Payment is released after the Liquidity Provider confirms receipt of the item.
| Asset type | Payout timing |
|---|---|
| Digital (tickets) | Held until after the event passes |
| Physical (cards, collectibles) | Released after delivery confirmation |
Instant payout — available for eligible sellers to receive funds immediately rather than waiting for the standard settlement window.
Step 7: You're Live
Your inventory is in the marketplace, matched against Liquidity Provider demand 24/7. From here:
- Monitor offers and their status via webhooks or Terminal
- Manage inventory — add, update, or remove items as your stock changes
- Track transfers and payouts through the API or Terminal
- Scale — automate inventory submission and offer handling for high-volume operation
Questions? Reach out to engineering@tradepost.co for technical support.