Skip to main content
The Buildmarkets Postman collection gives you 124 ready-to-run requests organized across 23 folders — one for each API domain. Import it, set three environment variables, and you’re making live sandbox calls in under two minutes.

​
Quick setup

1

Import the collection

Open the Buildmarkets Postman Collection and click Run in Postman to import it directly into your Postman workspace.
2

Set environment variables

Create a new Postman environment and add these three variables:
VariableValue
baseUrlhttps://dev-tapp-api.tappengine.com/v1
apiKeyYour sandbox API key
apiSecretYour sandbox API secret
Select the environment from the dropdown in the top-right corner of Postman before sending any requests.
3

Run your first request

Open the Assets → List Assets request and click Send. You should see a paginated list of tradable assets returned from the sandbox.

​
Collection contents

The collection is organized by API domain, with folders that map directly to the OpenAPI tags — so the collection always stays in sync with the spec.
FolderRequests
InvestorsCreate, list, get, close investors; wallets, transactions, portfolio chart, trusted contact
ComplianceSubmit a check result, restart a workflow, poll workflow status
Funding SourcesList / connect / disconnect funding sources, Plaid Link token, PATCH wire-payout details
TransfersCreate, list, get, and cancel deposits and withdrawals; download wire-details PDF
TradingOrder estimates, place / list / get / cancel orders
PositionsList positions; get position detail
AssetsSearch, list, get-by-symbol, historical chart bars
MarketsReference data: status, calendar, halts, sessions
Market DataQuotes, snapshots, bars, search (paywalled)
Document ManagementUpload, list, get, download, delete documents
WebhooksRegister, list, update, delete webhooks; list event types
Investor Profile / Dependents / Risk Assessment / Goals / Life Events / External Accounts / Financial Plan / Investment PolicyWealth platform onboarding and planning
Portfolio Management / Auto-Invest / Insights & Recommendations / ReportsWealth platform portfolio management
Total: 23 folders, 124 requests.

​
Collection variables

The collection uses variables for resource IDs. After creating a resource, update the corresponding collection variable so subsequent requests in that flow reference it automatically:
VariableSet after
investor_idCreating an investor (prefixed inv_…)
document_idUploading a document (prefixed doc_…)
order_idPlacing an order (prefixed ord_…)
deposit_idCreating a deposit (prefixed dep_…)
withdrawal_idCreating a withdrawal (prefixed wdr_…)
idFunding source (prefixed fs_…) — used by PATCH / DELETE funding-source
webhook_idRegistering a webhook
portfolio_idCreating a portfolio
Use Postman’s Tests tab to write a post-request script that automatically extracts the ID from each response and sets the corresponding collection variable. This lets you chain requests without manual copy-pasting.

​
Switching environments

To switch from sandbox to production:
  1. Create a new Postman environment
  2. Set baseUrl to https://api.tappengine.com/v1
  3. Enter your production API key and secret
  4. Select the production environment from the dropdown before sending requests
Production requests create real accounts and execute real trades. Confirm you have completed sandbox testing and received production access approval before switching environments.