Skip to content

Postman Collection

A ready-to-run Postman collection that simulates TradesMarter calling into your wallet API. Every signed request gets its HMAC headers generated automatically by a collection-level pre-request script — no manual signature work.

⬇ Download collection (.json)

What's inside

#RequestSigned
1Step 1 — launch (GET to TS index)
2/authenticate (Step 2)unsigned by design
3/getbalanceHMAC
4/opentrade — TapHMAC
5/closetrade — Tap (win)HMAC
6/closetrade — Tap (loss)HMAC
7/closetrade — Tap (tie / cancel)HMAC
8Smoke test — bad signature (expects rejection)tampered

Setup

  1. Import the file into Postman (File → Import → drag the .json).
  2. Set the collection variables:
    • CUSTODIAL_URL — base URL of your wallet API.
    • HMAC_SECRET — the shared secret TradesMarter sent you via secure channel.
  3. Run /authenticate first — its test script captures the returned wallet token into the walletToken variable automatically; subsequent requests pick it up.

Notes

  • The pre-request script signs POST requests only, and skips /authenticate (unsigned by vendor contract — the launch token is the credential).
  • X-Sig-Version is sent as the literal string v2.
  • The bad-signature smoke test must be rejected by your endpoint. If it passes, your HMAC verification is broken — fix before requesting sign-off.