Skip to main content
POST
/
tokens
/
transfer
Transfer Token
curl --request POST \
  --url https://api.g2cplatform.com/v2/tokens/transfer \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "tokenId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "toWalletId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": 1.000001,
  "memo": "<string>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "type": "mint",
  "tokenId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "timestamp": "2023-11-07T05:31:56Z",
  "tokenType": "fungible",
  "symbol": "<string>",
  "amount": 123,
  "fromWalletId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "toWalletId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "memo": "<string>",
  "status": "pending",
  "blockchain": {
    "txId": "<string>",
    "confirmations": 123,
    "fee": 123
  }
}

Authorizations

​
X-API-Key
string
header
required

API key for authenticating requests. Include in X-API-Key header.

Body

application/json
​
tokenId
string<uuid>
required

ID of the token to transfer

​
toWalletId
string<uuid>
required

ID of the recipient wallet

​
amount
number<double>

Amount to transfer (required for fungible tokens)

Required range: x >= 0.000001
​
memo
string

Optional memo or description for the transfer

Maximum string length: 500

Response

Token transferred successfully

​
id
string<uuid>
required

Unique identifier for the transaction

​
type
enum<string>
required

Type of transaction

Available options:
mint,
transfer,
receive
​
tokenId
string<uuid>
required

ID of the token involved in the transaction

​
timestamp
string<date-time>
required

When the transaction occurred

​
tokenType
enum<string>

Type of token

Available options:
fungible,
nft
​
symbol
string

Symbol for fungible tokens

​
amount
number<double>

Amount transferred (for fungible tokens)

​
fromWalletId
string<uuid>

ID of the sender wallet (null for mint transactions)

​
toWalletId
string<uuid>

ID of the recipient wallet

​
memo
string

Optional memo or description for the transaction

​
status
enum<string>

Current status of the transaction

Available options:
pending,
completed,
failed
​
blockchain
object