Skip to main content

Selling API

Releasing Soon The Selling API is in active development and will be available soon. Interested in early access? Contact engineering@tradepost.co.

The Selling API gives Supply Providers and Enterprise partners programmatic access to the sell side of the Tradepost marketplace — creating instant cash offers, accepting them, managing transfers, and tracking payouts.

  • Endpoint: https://platform-api.tradepost.co/graphql
  • Authentication: X-API-Key header (see Authentication)
  • Field naming: camelCase recommended, snake_case also accepted

Offer Creation​

CreatePartnerInstantCashOffers​

Submit items and receive instant cash offers in real-time. Send item identifiers (external IDs, asset config IDs, key IDs) along with an optional limit price to auto-accept and an auto-subscribe flag for real-time updates. Returns offer objects with pricing and status. Limited to a set number of items per request for real-time responses.

BulkCreatePartnerInstantCashOffers​

Same as above with no per-request limit. Responses are delivered asynchronously via webhooks.

Offer Management​

AcceptInstantCashOffer​

Accept an offer with a slippage check against a limit price. Optionally flag whether Tradepost should generate shipping labels. Returns the final executed price, quantity, and transfer details.

BulkAcceptInstantCashOffers​

Accept multiple offers at once. Results delivered via webhooks with success/fail notifications and transfer details.

GetOffer​

Retrieve a single offer by offer ID or external reference ID.

ListInstantCashOffers​

Query offers with filtering by status, date, price, and external IDs.

Transfers​

GetTransferDetails​

Retrieve transfer instructions for one or more accepted offers by offer ID or external reference ID.

SubmitTransferConfirmations​

Confirm that items have been sent. Optionally include a tracking number and request additional shipping labels. Accepts a list to confirm multiple transfers in one request. Returns updated transfer objects with new status.

Payouts & Financials​

FetchPayoutMethods​

Retrieve your connected payout methods.

FetchMoneyMovements​

Query money movements with filtering by status, date, and other criteria.

InitiatePayout​

Trigger a payout for completed offers. Supports an accelerate flag for faster settlement (fees may apply).

Market Data​

GetLiquidity​

See where the liquidity is across the Tradepost marketplace. Filter by asset type, brand, subject, or specific asset configurations. Returns an ordered list of the biggest markets by buy and sell side volume.

Real-Time Updates​

Offer Subscriptions​

Subscribe to an offer by ID to receive real-time updates via WebSocket or webhook on price, quantity, or status changes.

Enterprise Notes​

Enterprise partners integrating on behalf of their users can pass an optional customer ID to associate offers, transfers, and payouts with specific end users on their platform.

Support​

Selling Integration Guide | Offer Lifecycle

Last updated on by Parker Stevenson