Trading REST

For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/gateway/get-organization-transaction-stats.md.

Get organization trading stats

Organization tokenNo token

GET
/organizations/{organization_id}/transactions/stats

Trading totals for every user the organization serves over a window that ends with the current UTC hour (24h) or day (7d, 30d). Volume and fees count every order with a fill, including partial fills of canceled orders, in the USD stablecoin it was quoted in.

Requires an organization token for this organization, or an admin member of it. TM-On-Behalf-Of is rejected.

Authorization

bearerAuth
headerAuthorizationBearer <JWT>

An access token from POST /v1/auth/api-key/token. An organization token lasts one hour and has no refresh token; a personal token can be refreshed.

Path Parameters

organization_id*string

Your organization's id: the tm.organization_id claim of an organization token, also shown on the console Overview.

Formatuuid

Query Parameters

window*string

24h has 24 hourly buckets; 7d and 30d have daily buckets.

Value in"24h""7d""30d"

Response Body

Stats retrieved successfully

application/json
  1. response

An organization's trading totals over a window

window*StatsWindow

24h has 24 hourly buckets; 7d and 30d have daily buckets.

Value in"24h""7d""30d"
volume*string

Filled notional in USD

orders*integer

Orders placed in the window

filled_orders*integer

Orders placed in the window with at least one fill

fees*string

Fees charged on filled orders, in USD

trading_users*integer

Served users with at least one fill in the window

last_order_at*|

The most recent order by any served user, at any time; null when there is none

Formatdate-time
series*array<>

Every bucket of the window, oldest first, the last holding now

top_assets*array<>

Up to 5 assets with a fill in the window, by volume, highest first; empty when nothing filled

Itemsitems <= 5
Example Request
curl -X GET 'https://api.truemarkets.co/v1/gateway/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/transactions/stats?window=7d'
Example Response
{  "window": "7d",  "volume": "15230.5",  "orders": 42,  "filled_orders": 37,  "fees": "15.23",  "trading_users": 9,  "last_order_at": "2019-08-24T14:15:22Z",  "series": [    {      "timestamp": "2026-11-09T00:00:00Z",      "volume": "1250.75",      "orders": 3    }  ],  "top_assets": [    {      "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4",      "asset_symbol": "BTC",      "volume": "9800.12"    }  ]}

List organization transactions GET

Orders, transfers and received transfers of every user the organization serves, newest first, each row naming its user. Ramps are not included.

Get asset availability for the caller's country GET

Returns the product types and asset classes the caller may trade, based on the country the request originates from. Both lists are allowlists, so a product type that is absent is not available. The response varies per caller, so it is not edge-cached, and the bearer token is optional but should be sent when the caller has one.