Embedded Integration Guide
Releasing Soon The Embedded integration is in active development and will be available soon. Interested in early access? Contact engineering@tradepost.co.
For third-party marketplaces, platforms, and services that want to embed Tradepost's instant liquidity engine directly into their own user experience.
Your users get instant cash offers without ever leaving your app. You bring the supply. Tradepost brings the Liquidity Providers, offer engine, and settlement rails.
How It Works
Instead of sending your users to Tradepost, you integrate the offer infrastructure behind the scenes. The end user sees an "instant offer" or "sell now" experience that feels native to your platform.
| Component | Your platform | Tradepost |
|---|---|---|
| Supply | Your users submit inventory through your UI | Items flow into the Tradepost matching engine |
| Offers | Transparent to your users — they see instant cash offers | Offer engine matches items against Liquidity Provider bids in real-time |
| Settlement | Your users see payouts in your platform | Tradepost handles payment processing and transfers |
Step 1: Get Access
Contact Tradepost to set up an Enterprise partnership. You'll receive:
- API credentials for the GraphQL endpoint
- A dedicated partner configuration
- Access to Terminal for monitoring and management
Step 2: Set Up Authentication
Generate API credentials in the Enterprise Portal. Include your API key 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: Integrate the Offer Flow
Embed the offer flow into your product:
- Submit items on behalf of your users via the API when they want to sell
- Display offers returned by the matching engine in your native UI
- Handle acceptance when a user accepts an offer, trigger the order creation flow
- Manage transfers — guide users through sending their items to the buyer
Step 4: Handle Webhooks
Subscribe to lifecycle events so your platform stays in sync:
- Offer received / updated / expired
- Transfer initiated / confirmed
- Payout completed
Your backend receives these events and updates your user-facing UI accordingly.
Step 5: Settlement
Tradepost handles the financial settlement. You configure how payouts flow to your users — either through Tradepost's payout rails or your own payment infrastructure.
Use Cases
- A ticketing platform offering "sell your tickets instantly" to fans
- A trading card marketplace embedding instant cash offers for sellers
- A horizontal marketplace wanting to give users another alternative to listing
Questions? Reach out to engineering@tradepost.co to discuss your integration.