List account cashflows

GET

https://api.staging.trypredict.com/v1/accounts/:address/cashflows

GET

/v1/accounts/:address/cashflows

curl https://api.staging.trypredict.com/v1/accounts/address/cashflows

{
  "data": [
    {
      "cashflow_id": "string",
      "type": "trade",
      "asset": "string",
      "amount": "string",
      "fee_amount": "string",
      "amount_usdc": "string",
      "transaction_hash": "string",
      "account": {
        "main_account": {
          "address": "string",
          "username": "string",
          "image_url": "string",
          "hyperliquid_name": "string",
          "account_type": "main"
        },
        "subaccount": {
          "address": "string",
          "username": "string",
          "image_url": "string",
          "hyperliquid_name": "string",
          "account_type": "main"
        }
      },
      "from": {
        "address": "string",
        "username": "string",
        "image_url": "string",
        "hyperliquid_name": "string",
        "account_type": "main"
      },
      "to": {
        "address": "string",
        "username": "string",
        "image_url": "string",
        "hyperliquid_name": "string",
        "account_type": "main"
      },
      "occurred_at": "2024-01-15T09:30:00Z"
    }
  ],
  "next_cursor": "string"
}

List newest account cash-flow records with optional type filtering and cursor pagination.

Path parameters

addressstringRequired

EVM wallet address encoded as a 0x-prefixed hexadecimal string.

Query parameters

typeenumOptional

deposit, withdrawal, or transfer. Other AccountActivityType values are a 400.

limitintegerOptional

cursorstringOptional

Opaque pagination cursor returned by the previous page.

start_timedatetimeOptional

Inclusive lower bound on occurred_at. Not Event.start_time.

end_timedatetimeOptional

Inclusive upper bound on occurred_at. Not Event.start_time.

Response

datalist of objectsOptional

next_cursorstringOptional

Opaque pagination cursor returned by the previous page.

Errors

400

Bad Request Error

404

Not Found Error

405

Method Not Allowed Error

500

Internal Server Error

503

Service Unavailable Error