Skip to main content
GET
/
api
/
accounts
/
{accountId}
/
transfers
List Transfers
curl --request GET \
  --url https://trade.predexon.com/api/accounts/{accountId}/transfers \
  --header 'x-api-key: <api-key>'
{
  "transfers": [
    {
      "transferId": "<string>",
      "accountId": "<string>",
      "from": {
        "wallet": "<string>",
        "chain": 123,
        "token": "<string>",
        "address": "<string>"
      },
      "to": {
        "wallet": "<string>",
        "chain": 123,
        "token": "<string>",
        "address": "<string>"
      },
      "amount": "<string>",
      "amountReceived": "<string>",
      "txHashes": {
        "source": "<string>",
        "dest": "<string>",
        "approve": "<string>",
        "unwrap": "<string>",
        "wrap": "<string>",
        "safeExtract": "<string>",
        "safeDeposit": "<string>",
        "swap": "<string>"
      },
      "explorerLink": "<string>",
      "clientReferenceId": "<string>",
      "createdAt": "<string>",
      "completedAt": "<string>",
      "error": "<string>",
      "errorCode": "<string>"
    }
  ],
  "nextCursor": "<string>"
}
Returns every transfer the account has initiated - deposit funding, venue drains, and external withdrawals - in one list. Filters: ?status=pending|completed|failed, ?from=<wallet>, ?to=<wallet>, ?direction=in|out|internal (in = external→deposit, out = deposit→external, internal = between deposit and venues). Paginate with ?cursor=<nextCursor>. pending matches in-flight transfers and transfers in active recovery (substatus: "recoveryInProgress"). failed matches both fail states (substatus: "escalated" and bare failures). Each item is the same envelope returned by Create Transfer and Get Transfer - single source of truth for transfer state.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
accountId
string
required

Query Parameters

​
status
enum<string>

Filter on the partner-facing status enum. pending matches in-flight and in-recovery transfers; failed matches both fail states.

Available options:
pending,
completed,
failed
​
from
string

Filter by source wallet.

​
to
string

Filter by destination wallet.

​
direction
enum<string>

in — external→deposit. out — deposit→external. internal — between deposit and venues.

Available options:
in,
out,
internal
​
limit
integer
default:50
Required range: x <= 200
​
cursor
string

Response

Transfer list

​
transfers
object[]
​
nextCursor
string | null

Pagination cursor; pass to the next request as ?cursor=.