Transfer

Get transfer by ID

get

Returns a specific transfer by ID.

Authorizations

Detached-JWS-SignatureGNAP

Path parameters

transferIdstringRequired

Header parameters

x-client-idstringRequired

x-connection-idstringRequired

The provider connection through which the resource is accessed

AuthorizationstringOptional

Responses

200

The transfer details were successfully retrieved.

application/json

400

Invalid request parameters

application/json

401

Authentication is required

application/json

403

Insufficient permissions

application/json

404

Resource not found

application/json

409

Resource conflict

application/json

422

Unable to process the contained instructions

application/json

500

Internal server error

application/json

502

Bad gateway

application/json

get

HTTPcURLJavaScriptPython

GET /v1/provider/transfers/{transferId} HTTP/1.1
Host: auth.armory.playnarval.com
detached-jws: YOUR_API_KEY
x-client-id: text
x-connection-id: text
Accept: */*

{
  "data": {
    "transferRequestId": "text",
    "transferId": "text",
    "clientId": "text",
    "status": "created",
    "createdAt": null,
    "provider": "anchorage",
    "connectionId": "text",
    "source": {
      "wallet": {
        "clientId": "text",
        "connectionId": "text",
        "createdAt": null,
        "externalId": "text",
        "label": "text",
        "provider": "anchorage",
        "updatedAt": null,
        "walletId": "text"
      },
      "account": {
        "accountId": "text",
        "addresses": [
          {
            "accountId": "text",
            "address": "text",
            "addressId": "text",
            "clientId": "text",
            "connectionId": "text",
            "createdAt": null,
            "externalId": "text",
            "provider": "anchorage",
            "updatedAt": null
          }
        ],
        "clientId": "text",
        "connectionId": "text",
        "createdAt": null,
        "externalId": "text",
        "label": "text",
        "networkId": "text",
        "provider": "anchorage",
        "updatedAt": null,
        "walletId": "text"
      },
      "address": {
        "accountId": "text",
        "address": "text",
        "addressId": "text",
        "clientId": "text",
        "connectionId": "text",
        "createdAt": null,
        "externalId": "text",
        "provider": "anchorage",
        "updatedAt": null
      }
    },
    "asset": {
      "asset": {
        "assetId": "text",
        "decimals": 1,
        "name": "text",
        "networkId": "text",
        "onchainId": "text",
        "symbol": "text",
        "createdAt": null,
        "externalAssets": [
          {
            "externalId": "text",
            "provider": "anchorage"
          }
        ]
      },
      "network": {
        "networkId": "text",
        "coinType": 1,
        "evmChainId": 1,
        "name": "text",
        "createdAt": null,
        "externalNetworks": [
          {
            "externalId": "text",
            "provider": "anchorage",
            "supportsStake": false,
            "supportsEvm": false,
            "supportsTransfer": false,
            "customStakingValidator": false
          }
        ]
      },
      "externalAsset": {
        "externalId": "text",
        "provider": "anchorage"
      },
      "externalNetwork": {
        "externalId": "text",
        "provider": "anchorage",
        "supportsStake": false,
        "supportsEvm": false,
        "supportsTransfer": false,
        "customStakingValidator": false
      },
      "externalAssetId": "text"
    },
    "destination": {
      "account": {
        "accountId": "text",
        "addresses": [
          {
            "accountId": "text",
            "address": "text",
            "addressId": "text",
            "clientId": "text",
            "connectionId": "text",
            "createdAt": null,
            "externalId": "text",
            "provider": "anchorage",
            "updatedAt": null
          }
        ],
        "clientId": "text",
        "connectionId": "text",
        "createdAt": null,
        "externalId": "text",
        "label": "text",
        "networkId": "text",
        "provider": "anchorage",
        "updatedAt": null,
        "walletId": "text"
      },
      "address": {
        "accountId": "text",
        "address": "text",
        "addressId": "text",
        "clientId": "text",
        "connectionId": "text",
        "createdAt": null,
        "externalId": "text",
        "provider": "anchorage",
        "updatedAt": null
      },
      "wallet": {
        "clientId": "text",
        "connectionId": "text",
        "createdAt": null,
        "externalId": "text",
        "label": "text",
        "provider": "anchorage",
        "updatedAt": null,
        "walletId": "text"
      }
    },
    "grossAmount": "text",
    "customerRefId": "text",
    "idempotenceId": "text",
    "providerSpecific": null,
    "memo": "text",
    "networkFeeAttribution": "on_top",
    "createTransferRequest": {
      "transferRequestId": "text",
      "transferId": "text",
      "source": {
        "type": "account",
        "id": "text"
      },
      "destination": {
        "type": "account",
        "id": "text"
      },
      "amount": "text",
      "asset": {
        "assetId": "text",
        "externalAssetId": "text",
        "address": "text",
        "networkId": "text"
      },
      "networkFeeAttribution": "on_top",
      "customerRefId": "text",
      "idempotenceId": "text",
      "memo": "text",
      "provider": "anchorage",
      "providerSpecific": null
    },
    "externalId": "text",
    "externalStatus": "text",
    "transferStatus": "text",
    "fees": [
      {
        "type": "text",
        "attribution": "text",
        "amount": "text",
        "assetId": "text"
      }
    ]
  }
}

Create transfer

post

Creates a new transfer request and sends it to the provider.

Authorizations

Detached-JWS-SignatureGNAP

Header parameters

x-client-idstringRequired

x-connection-idstringRequired

The provider connection through which the resource is accessed

AuthorizationstringOptional

Body

transferRequestIdstringOptional

Sets the transfer ID to an arbitrary value

transferIdstringOptional

Sets the transfer ID to an arbitrary value

sourceone ofRequired

or

destinationone ofRequired

or

amountstringRequired

Amount of the transfer, expressed in asset units (e.g. 1.1 for 1.1 ETH)

Pattern: ^-?\d+(\.\d+)?$

networkFeeAttributionstring · enumOptional

Controls how network fees are charged. Example: a request to transfer 1 ETH with networkFeeAttribution=ON_TOP would result in exactly 1 ETH received to the destination and just over 1 ETH spent by the source. Note: This property is optional and its default always depend on the underlying provider.

Possible values:

customerRefIdstringOptional

idempotenceIdstringRequired

memostringOptional

providerstring · enumOptionalPossible values:

providerSpecificanyOptional

Responses

201

The transfer was successfully sent.

application/json

400

Invalid request parameters

application/json

401

Authentication is required

application/json

403

Insufficient permissions

application/json

404

Resource not found

application/json

409

Resource conflict

application/json

422

Unable to process the contained instructions

application/json

500

Internal server error

application/json

502

Bad gateway

application/json

post

HTTPcURLJavaScriptPython

POST /v1/provider/transfers HTTP/1.1
Host: auth.armory.playnarval.com
detached-jws: YOUR_API_KEY
x-client-id: text
x-connection-id: text
Content-Type: application/json
Accept: */*
Content-Length: 377

{
  "transferRequestId": "text",
  "transferId": "text",
  "source": {
    "type": "account",
    "id": "text"
  },
  "destination": {
    "type": "account",
    "id": "text"
  },
  "amount": "text",
  "asset": {
    "assetId": "text",
    "externalAssetId": "text",
    "address": "text",
    "networkId": "text"
  },
  "networkFeeAttribution": "on_top",
  "customerRefId": "text",
  "idempotenceId": "text",
  "memo": "text",
  "provider": "anchorage",
  "providerSpecific": null
}

{
  "data": {
    "transferRequestId": "text",
    "transferId": "text",
    "clientId": "text",
    "status": "created",
    "createdAt": null,
    "provider": "anchorage",
    "connectionId": "text",
    "source": {
      "wallet": {
        "clientId": "text",
        "connectionId": "text",
        "createdAt": null,
        "externalId": "text",
        "label": "text",
        "provider": "anchorage",
        "updatedAt": null,
        "walletId": "text"
      },
      "account": {
        "accountId": "text",
        "addresses": [
          {
            "accountId": "text",
            "address": "text",
            "addressId": "text",
            "clientId": "text",
            "connectionId": "text",
            "createdAt": null,
            "externalId": "text",
            "provider": "anchorage",
            "updatedAt": null
          }
        ],
        "clientId": "text",
        "connectionId": "text",
        "createdAt": null,
        "externalId": "text",
        "label": "text",
        "networkId": "text",
        "provider": "anchorage",
        "updatedAt": null,
        "walletId": "text"
      },
      "address": {
        "accountId": "text",
        "address": "text",
        "addressId": "text",
        "clientId": "text",
        "connectionId": "text",
        "createdAt": null,
        "externalId": "text",
        "provider": "anchorage",
        "updatedAt": null
      }
    },
    "asset": {
      "asset": {
        "assetId": "text",
        "decimals": 1,
        "name": "text",
        "networkId": "text",
        "onchainId": "text",
        "symbol": "text",
        "createdAt": null,
        "externalAssets": [
          {
            "externalId": "text",
            "provider": "anchorage"
          }
        ]
      },
      "network": {
        "networkId": "text",
        "coinType": 1,
        "evmChainId": 1,
        "name": "text",
        "createdAt": null,
        "externalNetworks": [
          {
            "externalId": "text",
            "provider": "anchorage",
            "supportsStake": false,
            "supportsEvm": false,
            "supportsTransfer": false,
            "customStakingValidator": false
          }
        ]
      },
      "externalAsset": {
        "externalId": "text",
        "provider": "anchorage"
      },
      "externalNetwork": {
        "externalId": "text",
        "provider": "anchorage",
        "supportsStake": false,
        "supportsEvm": false,
        "supportsTransfer": false,
        "customStakingValidator": false
      },
      "externalAssetId": "text"
    },
    "destination": {
      "account": {
        "accountId": "text",
        "addresses": [
          {
            "accountId": "text",
            "address": "text",
            "addressId": "text",
            "clientId": "text",
            "connectionId": "text",
            "createdAt": null,
            "externalId": "text",
            "provider": "anchorage",
            "updatedAt": null
          }
        ],
        "clientId": "text",
        "connectionId": "text",
        "createdAt": null,
        "externalId": "text",
        "label": "text",
        "networkId": "text",
        "provider": "anchorage",
        "updatedAt": null,
        "walletId": "text"
      },
      "address": {
        "accountId": "text",
        "address": "text",
        "addressId": "text",
        "clientId": "text",
        "connectionId": "text",
        "createdAt": null,
        "externalId": "text",
        "provider": "anchorage",
        "updatedAt": null
      },
      "wallet": {
        "clientId": "text",
        "connectionId": "text",
        "createdAt": null,
        "externalId": "text",
        "label": "text",
        "provider": "anchorage",
        "updatedAt": null,
        "walletId": "text"
      }
    },
    "grossAmount": "text",
    "customerRefId": "text",
    "idempotenceId": "text",
    "providerSpecific": null,
    "memo": "text",
    "networkFeeAttribution": "on_top",
    "createTransferRequest": {
      "transferRequestId": "text",
      "transferId": "text",
      "source": {
        "type": "account",
        "id": "text"
      },
      "destination": {
        "type": "account",
        "id": "text"
      },
      "amount": "text",
      "asset": {
        "assetId": "text",
        "externalAssetId": "text",
        "address": "text",
        "networkId": "text"
      },
      "networkFeeAttribution": "on_top",
      "customerRefId": "text",
      "idempotenceId": "text",
      "memo": "text",
      "provider": "anchorage",
      "providerSpecific": null
    },
    "externalId": "text",
    "externalStatus": "text",
    "transferStatus": "text",
    "fees": [
      {
        "type": "text",
        "attribution": "text",
        "amount": "text",
        "assetId": "text"
      }
    ]
  }
}