For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /trading-api/faq.md.

Trading API FAQs

Is there a test mode?

Not yet. We don't have a fully working sandbox, so every trade is a real on-chain transaction. Keep your first trades small; a real trade also proves the whole flow. The Go live checklist covers what to try first.

Is my API account separate from my app account?

No. The key you create at app.truemarkets.co trades the same account and the same wallet you use in the app.

Do I have to sign again when my token expires?

No. Minting a token also returns a refresh token. Post it to POST /v1/auth/token/refresh to get a new pair without signing. Create your API key has the call.

Why did execute return quote_stale?

The quote expired, or the price moved, before the transaction landed. Place the order again and execute it right away.

Why did placing an order return no order_id?

Your wallet can't fund the buy. The response is still 201, but order_id is empty and quote.issues says why. Fund the wallet and place the order again. Funding shows where.

What happens if I send too many requests?

We answer 429. Wait the seconds in X-RateLimit-Reset, then retry. Your token stays valid until it expires, so there's nothing to mint again. Rate limits lists the limits and which endpoints have their own.

What should I send when I contact support?

Every error response carries a request_id. Include it when you email [email protected].

Was this page helpful?YesNo