Sign in
latestOpenAPI 3.1.02026-08-108094177.6 KB

087dcf516ce2

Managed Custody Mode

Fetch transaction history

Fetch paginated transaction history for reconciliation, or fetch a single transaction by sending exactly one of id, txHash, or reqId (mutually exclusive). The transaction webhook delivers the same transaction structure; parse detailsJson according to the transaction type.

post/api/fma/v1/transactions

Headers

X-Api-Signaturestring required

0x-prefixed 65-byte hex EIP-191 signature over the Partner Auth message. See the Signature and verify guide.

X-Api-Deadlinestring required

Unix seconds. UR rejects the request when the current time is past the deadline. Keep the validity window at or under 5 minutes.

X-Api-PublicKeystring required

0x-prefixed partner signer address registered with UR.

X-Ur-Idstring

Send at least one of X-Ur-Id or X-External-User-Id. When both are present, UR resolves the user by X-Ur-Id first.

X-External-User-Idstring

Send at least one of X-Ur-Id or X-External-User-Id. When both are present, UR resolves the user by X-Ur-Id first.

Request body

pageSizeinteger

Page size. Defaults to 50; maximum is 100.

typestring

Single transaction type filter. Do not send together with txTypes.

txTypesstring[]

Multiple transaction type filter. Do not send together with type.

currenciesstring[]

Currency filter. Values are normalized to lowercase by UR.

direction'IN' | 'OUT' | 'ALL'

Direction filter.

statusstring

Transaction status filter.

chainIdstring

Chain ID filter, for example eip155:5000.

tokenSymbolstring

Token symbol filter, for example USDC.

minAmountstring

Minimum amount filter.

maxAmountstring

Maximum amount filter.

fromTimestampinteger

Start timestamp filter.

toTimestampinteger

End timestamp filter.

cursorTimestampinteger

Next-page cursor timestamp from data.nextCursor.timestamp. Send only when hasNextPage is true.

cursorIdinteger

Next-page cursor ID from data.nextCursor.id. Send only when hasNextPage is true.

prevCursorTimestampinteger

Previous-page cursor timestamp from data.prevCursor.timestamp. Send only when hasPrevPage is true.

prevCursorIdinteger

Previous-page cursor ID from data.prevCursor.id. Send only when hasPrevPage is true.

idinteger

Exact lookup by UR internal transaction ID. Mutually exclusive with txHash and reqId.

txHashstring

Exact lookup by transaction hash. Mutually exclusive with id and reqId.

reqIdstring

Exact lookup by the idempotency key used when the transaction was created. Mutually exclusive with id and txHash.

Response

Standard envelope. Business errors return HTTP 200 with a non-zero code. For exact lookups, data.items is empty when no transaction matches.

codeinteger required

0 on success; non-zero business error code.

messagestring required

Human-readable explanation. May be empty on success.