Get transaction history

Returns the user's transaction history with date range, type, currency, direction, and amount filters plus cursor pagination. Timestamps are Unix seconds.

post

/api/v2/transactions

Authorizations

X-Api-SignaturestringRequired

Partner Auth: EIP-191 signature by the partner's registered backend key, with X-Api-Deadline and optional X-Api-PublicKey headers. See the Signature and verify guide.

Header parameters

tokenIdstringRequired

The user's URID (NFT token id).

networkstringRequired

Network identifier: 5000 for mainnet, 5003 for testnet.

signstringRequired

Signature generated by the user's wallet key (EIP-191).

hashstringRequired

SHA3/Keccak256 hash of the original request payload.

deadlinestringRequired

Signature expiry: server timestamp plus a validity window (max 20 minutes).

Body

pageSizeintegerOptional

Page size (default 50).

fromTimestampintegerOptional

Start timestamp (Unix seconds).

toTimestampintegerOptional

End timestamp (Unix seconds).

typestringOptional

Single transaction type, e.g. P2P, FRX, CTU, CRD, CDP. Mutually exclusive with transactionTypes.

transactionTypesstring[]Optional

Multiple transaction-type filter. Mutually exclusive with type.

currencysstring[]Optional

Currency filter, e.g. EUR, USD, CHF.

directionstringOptional

IN, OUT, or ALL.

minAmountstringOptional

Minimum amount filter.

maxAmountstringOptional

Maximum amount filter.

statusstringOptional

Transaction status filter.

chainIdstringOptional

CAIP-2 chain ID, e.g. eip155:5000.

tokenSymbolstringOptional

Token symbol, e.g. USDC.

cursorTimestampintegerOptional

Forward-pagination cursor timestamp.

cursorIdintegerOptional

Forward-pagination cursor ID.

idintegerOptional

Query a single transaction by record ID. Mutually exclusive with txHash.

txHashstringOptional

Query a single transaction by hash. Mutually exclusive with id.

Responses

200

Response envelope. For the user API, retCode 0 means success; for the partner API, code 0 means success. Business rejections return HTTP 200 with a non-zero code.

application/json

Standard response envelope for the user API (api.ur.app).

retCodeinteger · int64Required

0 on success; non-zero indicates failure.

retMsgstringRequired

Human-readable message; error details when retCode is non-zero.

resultanyOptional

Business payload. Shape depends on the endpoint; some endpoints return it as a JSON-encoded string.

timeNowinteger · int64Optional

Server timestamp in milliseconds.

post/api/v2/transactions

POST /api/v2/transactions HTTP/1.1
Host: api.ur.app
X-Api-Signature: YOUR_API_KEY
tokenId: text
network: text
sign: text
hash: text
deadline: text
Content-Type: application/json
Accept: */*
Content-Length: 67

{
  "pageSize": 50,
  "fromTimestamp": 1698300000,
  "toTimestamp": 1698500000
}

200

Response envelope. For the user API, retCode 0 means success; for the partner API, code 0 means success. Business rejections return HTTP 200 with a non-zero code.

{
  "retCode": 0,
  "retMsg": "ok",
  "result": {
    "transactions": [
      {
        "id": 42,
        "title": "Card spend",
        "subtitle": "Merchant ABC",
        "amount": "-15.50",
        "type": "CRD",
        "timestamp": 1698402600,
        "currency": "USD",
        "direction": "OUT",
        "chainId": "eip155:5000",
        "mcc": 5812
      }
    ]
  },
  "timeNow": 1698489000000
}