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

List organization transactions

Organization tokenNo token

GET
/organizations/{organization_id}/transactions

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

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 dashboard Overview.

Formatuuid

Query Parameters

user_id?array<>

Comma-separated user ids. Defaults to every user served.

Itemsitems <= 100
type?array<>

Comma-separated types to include: order, transfer, received_transfer. Defaults to all three; ramp is rejected.

status?array<>

Comma-separated statuses to include. Defaults to all.

external_ref_id?string

Your reference for one served user, as given when the user was created.

Match^[A-Za-z0-9_-]{1,64}$
asset_symbol?array<>

Comma-separated asset symbols, matched exactly.

Itemsitems <= 50
asset_type?array<>

Comma-separated asset types. Returns orders only.

order_type?array<>

Comma-separated order types. A take-profit or stop-loss order matches only its trigger type. Returns orders only.

asset_class?array<>

Comma-separated asset classes. Returns orders only.

id?string

One transaction's id.

Formatuuid
tx_hash?string

One transaction hash, matched regardless of case.

Lengthlength <= 128
from?string

Created at or after this instant.

Formatdate-time
to?string

Created before this instant. Must be after from.

Formatdate-time
cursor?string

Opaque pagination cursor from the previous page's next_cursor

limit?integer

Maximum number of transactions to return

Range1 <= value <= 100
Default50

Response Body

Transactions retrieved successfully

application/json
  1. response

Paginated feed across an organization's users

data?array<>

Transactions, newest first

pagination?

Cursor-based pagination metadata. The cursor is opaque and must be passed back verbatim; never parse or construct one.

Example Request
curl -X GET 'https://api.truemarkets.co/v1/gateway/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/transactions'
Example Response
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "type": "order",      "asset_flow": "in",      "status": "pending",      "created_at": "2019-08-24T14:15:22Z",      "completed_at": "2019-08-24T14:15:22Z",      "qty": "string",      "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4",      "asset_symbol": "string",      "tx_hash": "string",      "explorer_url": "string",      "failure_reason": "string",      "order": {        "order_id": "string",        "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4",        "economic_asset_id": "7f93aecf-1e3c-4189-b692-a8b4a0ef8e5b",        "asset_symbol": "string",        "base_asset": "string",        "quote_asset": "string",        "type": "market",        "side": "buy",        "price": "string",        "qty": "string",        "qty_unit": "base",        "executed_qty": "string",        "leaves_qty": "string",        "executed_vwap": "string",        "fee": "string",        "tx_hash": "string",        "explorer_url": "string",        "failure_reason": "string",        "venue": "defi",        "chain": "solana",        "status": "complete",        "created_at": "2019-08-24T14:15:22Z",        "asset_type": "spot",        "trigger": {          "type": "take_profit",          "price": "70000.00"        },        "placed_by": "user",        "strategy_managed": true      },      "transfer": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "status": "pending",        "venue": "defi",        "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4",        "asset_symbol": "string",        "chain": "string",        "network": "bitcoin",        "to": "string",        "qty": "string",        "qty_unit": "base",        "sent": "string",        "fee": "string",        "received": "string",        "tx_hash": "string",        "explorer_url": "string",        "payloads": [          {            "digest": "string",            "payload": "string"          }        ],        "created_at": "2019-08-24T14:15:22Z",        "updated_at": "2019-08-24T14:15:22Z"      },      "ramp": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "payment_method": "COINBASE",        "direction": "onramp",        "status": "created",        "amount": "string",        "chain": "solana",        "asset_symbol": "string",        "asset_amount": "string",        "fiat_currency": "string",        "fiat_amount": "string",        "fee_amount": "string",        "fee_currency": "string",        "exchange_rate": "string",        "wallet_address": "string",        "provider_wallet_address": "string",        "tx_hash": "string",        "redirect_url": "string",        "failure_reason": "string",        "created_at": "2019-08-24T14:15:22Z",        "updated_at": "2019-08-24T14:15:22Z",        "completed_at": "2019-08-24T14:15:22Z"      },      "received_transfer": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "chain": "solana",        "tx_hash": "string",        "from_address": "string",        "to_address": "string",        "token_address": "string",        "token_symbol": "USDC",        "amount": "25.5",        "observed_at": "2019-08-24T14:15:22Z"      },      "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",      "external_ref_id": "customer-4821"    }  ],  "pagination": {    "next_cursor": "string",    "limit": 0  }}