Skip to main content
GET
/
v1
/
accountTransferUpdates
curl
ADDR=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
curl "https://api.testnet.arcus.xyz/v1/accountTransferUpdates?address=${ADDR}&limit=1000"
{
  "accountTransferUpdates": [
    {
      "id": "<string>",
      "amount": "<string>",
      "netQuoteBalance": "<string>",
      "globalSequenceId": 123,
      "createdAt": 123,
      "address": "<string>",
      "accountIndex": 123,
      "rejectReason": "<string>",
      "sourceAccountId": "<string>",
      "destinationAccountId": "<string>"
    }
  ]
}
Returns deposits, withdrawals, and transfers for the requesting account, newest-first. Each entry is an AccountTransferUpdate object. The matching engine rejects a withdrawal or transfer before it is persisted when either of the following conditions holds:
  • Non-positive amount — amount must be strictly greater than zero.
  • Insufficient free collateral — amount exceeds accountEquity − requiredMargin. The engine does not perform partial pulls; the entire request is rejected and account state is left unchanged.
No authentication header is required.

Query Parameters

​
address
string
required

Master Ethereum address for this API key (must match address from POST /createApiKey for the same key). Required on REST for account-scoped reads and for place/cancel. Invalid hex → 400; mismatch with key → 403.

20-byte EVM address as hex: optional 0x or 0X prefix and exactly 40 hexadecimal digits. API responses normalize to lowercase a–f after 0x.

Pattern: ^(0x|0X)?[0-9a-fA-F]{40}$
​
limit
integer
default:1000

Maximum number of entries to return. Defaults to the cap.

Required range: 1 <= x <= 1000
​
from
integer<int64>

Start timestamp filter (epoch ms, inclusive).

Required range: x >= 0
​
to
integer<int64>

End timestamp filter (epoch ms, inclusive).

Required range: x >= 0

Response

List of account transfer updates (deposits, withdrawals, and transfers), newest-first.

​
accountTransferUpdates
object[]
required