Skip to content
APIs
/
/Trading

True Markets DeFi REST (v2026_01_14)

API for the True Markets DeFi service

Download OpenAPI description
v2026_01_14.json
v2026_01_14.yaml
Languages
Servers
Mock server

https://docs.truemarkets.co/_mock/apis/defi-direct/v2026_01_14/

Local server

http://localhost:7072/

Assets

Query available assets and their metadata across supported chains.

Operations

Balances

Query wallet balances for the authenticated user.

Operations

Trading

Fetch quotes and execute trades on supported chains.

Operations

Fetch a quote

Request

Security
bearerAuth
Bodyapplication/jsonrequired
chainstringrequired
base_assetstringrequired
quote_assetstringrequired
order_sidestringrequired
Enum"buy""sell"
qtystringrequired
curl -i -X POST \
  https://docs.truemarkets.co/_mock/apis/defi-direct/v2026_01_14/v1/defi/core/quote \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "chain": "string",
    "base_asset": "string",
    "quote_asset": "string",
    "order_side": "buy",
    "qty": "string"
  }'

Responses

A quote response

Bodyapplication/json
quote_idstring
base_assetstring
quote_assetstring
order_sidestring
amountstring
feestring
payloadsArray of objects(UnsignedPayload)
issuesArray of strings
Response
application/json
{
  "quote_id": "string",
  "base_asset": "string",
  "quote_asset": "string",
  "order_side": "string",
  "amount": "string",
  "fee": "string",
  "payloads": [
    { … }
  ],
  "issues": [
    "string"
  ]
}

Execute a trade

Request

Security
bearerAuth
Bodyapplication/jsonrequired
quote_idstringrequired

The quote ID returned from the quote endpoint

signaturesArray of stringsnon-emptyrequired

Signatures for the payloads returned from the quote endpoint (in order)

auth_typestringrequired

The authentication type used for signing

Enum"web_authn""api_key"
curl -i -X POST \
  https://docs.truemarkets.co/_mock/apis/defi-direct/v2026_01_14/v1/defi/core/trade \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "quote_id": "string",
    "signatures": [
      "string"
    ],
    "auth_type": "web_authn"
  }'

Responses

The trade response

Bodyapplication/json
order_idstring(uuid)

The created order ID

tx_hashstring

The blockchain transaction hash

Response
application/json
{
  "order_id": "93101167-9065-4b9c-b98b-5d789a3ed9fe",
  "tx_hash": "string"
}

Transfers

Prepare and execute on-chain token transfers.

Operations

Wallets

Create wallets and export private keys.

Operations

Profile

Retrieve authenticated user profile and wallet information.

Operations

Watchlists

Browse curated asset watchlists.

Operations

History

Unified transaction history across trades, transfers, and on-ramps.

Operations

Onramp

Initiate and track fiat-to-crypto on-ramp transactions via Coinbase.

Operations