List withdrawals

Withdrawal history, most recent first, enriched with the payment method and the provider’s reason for each transaction.

GET

https://demo.stxapp.iohttps://demo.stxapp.cahttps://api.on.stxapp.ca/api/v1/portfolio/withdrawals

Try it ▶

Try it

Base URL

Key ID stx_access_keyPrivate key (PEM or base64 seed) stx_private_key

Request

Send requestShow signed headersClear saved key

Every endpoint, in one place: the full Try it.

Signing happens in your browser with WebCrypto. Your private key is never sent anywhere; Send request sends your key ID and the signature to the demo host above. Only demo hosts are offered. The key ID and private key are saved in this browser's local storage, per jurisdiction, until you click Clear saved key. Use a demo key here, never a production one.

In the SDKs

• TypeScript: STX.withdrawals()
• Python: STX.withdrawals()

Parameters

Name	In	Type	Required	Description
limit	query	integer	no	Rows per page. Defaults to 100 and is silently clamped to 200; a larger value is not an error.
cursor	query	string	no	Cursor from the previous response. Omit for the first page.

Responses

Status	Description	Schema
200	Success	object
401	Missing, malformed or unrecognized signature, or a timestamp outside the 30-second window. Body: {“error”:“Missing or invalid API key credentials”}	Error
403	The account behind this key is not active, for example it is pending approval or suspended. Body: {“error”:“Your account is suspended. Contact support.”}, the message naming the account’s status.	Error

Example

Request:

curl --request GET \
  --url 'https://demo.stxapp.io/api/v1/portfolio/withdrawals' \
  --header 'X-STX-ACCESS-KEY: <key-id>' \
  --header 'X-STX-ACCESS-TIMESTAMP: <unix-ms>' \
  --header 'X-STX-ACCESS-SIGNATURE: <base64-ed25519>'

Response 200:

{
  "cursor": null,
  "withdrawals": [
    {
      "account_id": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "amount": "0.6700",
      "event_id": null,
      "fee_id": null,
      "id": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "inserted_at": 0,
      "market_id": null,
      "method": null,
      "payment_id": null,
      "points": null,
      "reason": null,
      "settlement_id": null,
      "sub_method": null,
      "time": "2026-08-25T04:42:46.242093Z",
      "type": "deposit"
    }
  ]
}

Response fields

Field	Type	Description
cursor	string	Opaque cursor for the next page. Pass the value from the previous response; omit for the first page. null once there are no more pages.
account_id	uuid	The account the record belongs to.
amount	decimal	The monetary value the entry was calculated from. In dollars.
event_id	uuid	The event the market belongs to.
fee_id	uuid	The fee that generated this entry, when it came from one.
id	uuid	Unique identifier for the record.
inserted_at	int64	Creation time, as UNIX microseconds.
market_id	uuid	The market this record relates to.
method	string	The payment method the provider reports for this transaction.
payment_id	uuid	The payment that generated this entry, when it came from one.
points	number	Points added by this entry. Negative when points were spent.
reason	string	The provider’s reason or description for the transaction.
settlement_id	uuid	The settlement that generated this entry, when it came from one.
sub_method	string	For Interac, whether the transfer was a Send or a Request.
time	date-time	When the entry was recorded.
type	string	What moved the money or the points, for example a deposit, a trade fee, a referral, or a manual adjustment. Each endpoint returns only its own subset of these.