Transfers

Wallet-to-wallet crypto transfers.

Create Transfer

Create a wallet transfer

post

Authorizations

ApiKeyAuth & BearerAuth

x-api-keystringRequired

Project API key (or CopterPay API key for webhooks).

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

user_idstring · uuidRequiredExample: 550e8400-e29b-41d4-a716-446655440000

chainstring · enumRequiredPossible values:

assetstring · enumRequiredPossible values:

to_addressstringRequiredExample: 0x8ba1f109551bD432803012645Ac136ddd64DBA72

amountnumberRequiredExample: 1500.5

Responses

200

Transfer created

application/json

400

Bad request

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

501

Not implemented

application/json

post

/mint/v1/accounts/wallets/transfers

HTTPcURLJavaScriptPython

POST /mint/v1/accounts/wallets/transfers HTTP/1.1
Host: arsx.io
x-api-key: YOUR_API_KEY
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "user_id": "550e8400-e29b-41d4-a716-446655440000",
  "chain": "base",
  "asset": "arsx",
  "to_address": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
  "amount": 1500.5
}

{
  "status": 200,
  "message": "Ok",
  "data": {
    "transactionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  }
}

List Project Transfers

List wallet transfers for a project

get

Authorizations

ApiKeyAuth & BearerAuth

x-api-keystringRequired

Project API key (or CopterPay API key for webhooks).

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

limitinteger · min: 1Optional

Number of items per page.

Default: 10

pageintegerOptional

Page index starting at 0.

Default: 0

assetstring · enumOptionalPossible values:

chainstring · enumOptionalPossible values:

user_idstringOptional

tx_idstringOptional

addressstringOptional

wallet_idstringOptional

Responses

200

Transfer list

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

get

/mint/v1/accounts/wallets/transfers

HTTPcURLJavaScriptPython

GET /mint/v1/accounts/wallets/transfers HTTP/1.1
Host: arsx.io
x-api-key: YOUR_API_KEY
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": 200,
  "message": "Ok",
  "data": [
    {
      "wallet_transaction_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "wallet_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "from_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8bE21",
      "to_address": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
      "amount": "1500.50000000",
      "status": "Pending",
      "tx_hash": "0x9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
      "asset": "arsx",
      "chain": "base",
      "user_id": "550e8400-e29b-41d4-a716-446655440000",
      "started_at": "2025-01-15T14:30:00Z"
    }
  ]
}

List User Transfers

List wallet transfers for a user

get

Authorizations

ApiKeyAuth & BearerAuth

x-api-keystringRequired

Project API key (or CopterPay API key for webhooks).

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

user_idstringRequired

Query parameters

limitinteger · min: 1Optional

Number of items per page.

Default: 10

pageintegerOptional

Page index starting at 0.

Default: 0

assetstring · enumOptionalPossible values:

chainstring · enumOptionalPossible values:

Responses

200

Transfer list

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

get

/mint/v1/accounts/wallets/transfers/{user_id}

HTTPcURLJavaScriptPython

GET /mint/v1/accounts/wallets/transfers/{user_id} HTTP/1.1
Host: arsx.io
x-api-key: YOUR_API_KEY
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": 200,
  "message": "Ok",
  "data": [
    {
      "wallet_transaction_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "wallet_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "from_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8bE21",
      "to_address": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
      "amount": "1500.50000000",
      "status": "Pending",
      "tx_hash": "0x9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
      "asset": "arsx",
      "chain": "base",
      "user_id": "550e8400-e29b-41d4-a716-446655440000",
      "started_at": "2025-01-15T14:30:00Z"
    }
  ]
}

Get Transfer by ID

Get a transfer by id or tx hash

get

Authorizations

ApiKeyAuth & BearerAuth

x-api-keystringRequired

Project API key (or CopterPay API key for webhooks).

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

user_idstringRequired

tx_id_hashstringRequired

Wallet transaction id or tx hash.

Responses

200

Transfer details

application/json

401

Unauthorized

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/mint/v1/accounts/wallets/transfers/{user_id}/{tx_id_hash}

HTTPcURLJavaScriptPython

GET /mint/v1/accounts/wallets/transfers/{user_id}/{tx_id_hash} HTTP/1.1
Host: arsx.io
x-api-key: YOUR_API_KEY
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": 200,
  "message": "Ok",
  "data": {
    "wallet_transaction_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "wallet_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "from_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8bE21",
    "to_address": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
    "amount": "1500.50000000",
    "status": "Pending",
    "tx_hash": "0x9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
    "asset": "arsx",
    "chain": "base",
    "user_id": "550e8400-e29b-41d4-a716-446655440000",
    "started_at": "2025-01-15T14:30:00Z"
  }
}