# Get transfer

Fetches all transfers for a client within the past 24 hours on the exchange.

Endpoint: GET /api/v1/transfers
Version: v1.0.3
Security: HMAC

## Header parameters:

  - `x-truex-auth-userid` (string, required)
    Client identifier.

  - `x-truex-auth-timestamp` (string, required)
    Timestamp when request was made in seconds since epoch.

  - `x-truex-auth-token` (string, required)
    The UUID affiliated with the HMAC key.

  - `x-truex-auth-signature` (string, required)
    The computed HMAC signature.

## Query parameters:

  - `size` (string)
    Number of transfers to return per page. Maximum allowed value is 100.

  - `skip` (string)
    Number of records to skip before returning results. Used for offset-based pagination.

  - `timestamp` (string, required)
    A Unix UTC timestamp in nanoseconds used as a reference point for fetching transfers.
    Example: "1741523275598727336"

## Response 200 fields (application/json):

  - `id` (string)
    Example: "799477925458083869"

  - `status` (string)
    Enum: "INITIALIZED", "PENDING", "COMPLETED", "FAILED", "REJECTED"

  - `request` (object)

  - `request.amount` (string, required)
    Amount of asset to transfer.
    Example: "1000000"

  - `request.asset_id` (string, required)
    Exchange assigned ID of asset.
    Example: "78901985055342602"

  - `request.client_id` (string, required)
    Exchange assigned ID of client.
    Example: "78901985048264710"

  - `request.type` (string, required)
    Direction of the transfer.
*  Place the amount specified on the exchange.
*  Remove the amount specified from the exchange.
    Enum: "DEPOSIT", "WITHDRAW"

  - `request.platform` (string, required)
    The type of service to use for the transfer. Must match with the corresponding instructions defined below.
*  Indicates the transfer should use the traditional banking system used to handle the corresponding fiat currency. Note, performing a transfer with fiat on a stablecoin asset will result in an automatic conversion.
*  Indicates the transfer uses a blockchain platform.
    Enum: "FIAT", "CRYPTO"

  - `request.instructions` (any)
    Platform specific instructions. The defined object must match with the platform value.
*  Must be used when setting the platform to 
*  Must be used when setting the platform to

  - `timestamp` (string)
    The UNIX UTC nanosecond timestamp of when the transfer was initiated.
    Example: "1740740509058376312"

  - `updated_timestamp` (string)
    The UNIX UTC nanosecond timestamp of the last update to the transfer.
    Example: "1740740509058376312"

## Response 400 fields (application/problem+json):

  - `type` (string, required)
    A URI reference that identifies the problem type.
    Example: "about:blank"

  - `title` (string, required)
    A short, human-readable summary of the problem type.
    Example: "An Error Occured"

  - `status` (integer, required)
    The HTTP status code generated by the origin server.
    Example: 400

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.
    Example: "A more detailed sentence about the error"

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem.
    Example: "/api/v1/endpoint"

  - `extensions` (object)
    A map for extension members (custom fields not defined by the RFC).

## Response 401 fields (application/problem+json):

  - `type` (string, required)
    A URI reference that identifies the problem type.
    Example: "about:blank"

  - `title` (string, required)
    A short, human-readable summary of the problem type.
    Example: "An Error Occured"

  - `status` (integer, required)
    The HTTP status code generated by the origin server.
    Example: 400

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.
    Example: "A more detailed sentence about the error"

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem.
    Example: "/api/v1/endpoint"

  - `extensions` (object)
    A map for extension members (custom fields not defined by the RFC).

## Response 403 fields (application/problem+json):

  - `type` (string, required)
    A URI reference that identifies the problem type.
    Example: "about:blank"

  - `title` (string, required)
    A short, human-readable summary of the problem type.
    Example: "An Error Occured"

  - `status` (integer, required)
    The HTTP status code generated by the origin server.
    Example: 400

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.
    Example: "A more detailed sentence about the error"

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem.
    Example: "/api/v1/endpoint"

  - `extensions` (object)
    A map for extension members (custom fields not defined by the RFC).

## Response 408 fields (application/problem+json):

  - `type` (string, required)
    A URI reference that identifies the problem type.
    Example: "about:blank"

  - `title` (string, required)
    A short, human-readable summary of the problem type.
    Example: "An Error Occured"

  - `status` (integer, required)
    The HTTP status code generated by the origin server.
    Example: 400

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.
    Example: "A more detailed sentence about the error"

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem.
    Example: "/api/v1/endpoint"

  - `extensions` (object)
    A map for extension members (custom fields not defined by the RFC).

## Response 415 fields (application/problem+json):

  - `type` (string, required)
    A URI reference that identifies the problem type.
    Example: "about:blank"

  - `title` (string, required)
    A short, human-readable summary of the problem type.
    Example: "An Error Occured"

  - `status` (integer, required)
    The HTTP status code generated by the origin server.
    Example: 400

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.
    Example: "A more detailed sentence about the error"

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem.
    Example: "/api/v1/endpoint"

  - `extensions` (object)
    A map for extension members (custom fields not defined by the RFC).

## Response 500 fields (application/problem+json):

  - `type` (string, required)
    A URI reference that identifies the problem type.
    Example: "about:blank"

  - `title` (string, required)
    A short, human-readable summary of the problem type.
    Example: "An Error Occured"

  - `status` (integer, required)
    The HTTP status code generated by the origin server.
    Example: 400

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.
    Example: "A more detailed sentence about the error"

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem.
    Example: "/api/v1/endpoint"

  - `extensions` (object)
    A map for extension members (custom fields not defined by the RFC).

## Response 503 fields (application/problem+json):

  - `type` (string, required)
    A URI reference that identifies the problem type.
    Example: "about:blank"

  - `title` (string, required)
    A short, human-readable summary of the problem type.
    Example: "An Error Occured"

  - `status` (integer, required)
    The HTTP status code generated by the origin server.
    Example: 400

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.
    Example: "A more detailed sentence about the error"

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem.
    Example: "/api/v1/endpoint"

  - `extensions` (object)
    A map for extension members (custom fields not defined by the RFC).