API Reference
Wallets
- POSTCreate Wallet
- GETGet Wallet By Locator
- GETGet Wallet Balance
- POSTFund Wallet
- GETGet NFTs from Wallet
- POSTCreate Transaction
- GETGet Transaction
- GETGet Wallet Transactions
- POSTApprove Transaction
- POSTCreate Signature
- GETGet All Signatures
- GETGet Signature
- POSTApprove Signature
- POSTRegister Delegated Signer
- GETGet Delegated Signer
NFTs
IP
NFT Collections
NFT Templates
Verifiable Credentials
Verifiable Credential Types
Headless Checkout
Action Status
Admin
Subscriptions
Get Wallet Transactions
Retrieves all transactions associated with the specified wallet.
API scope required: wallets:transactions.read
curl --request GET \
--url https://staging.crossmint.com/api/2022-06-09/wallets/{walletLocator}/transactions \
--header 'X-API-KEY: <x-api-key>'{
"transactions": [
{
"id": "tx-b984491a-5785-43c0-8811-45d46fe6e520",
"walletType": "evm-smart-wallet",
"status": "awaiting-approval",
"approvals": {
"pending": [
{
"signer": "evm-keypair:0xdeadbeef",
"message": "Please sign this transaction"
}
],
"submitted": []
},
"params": {
"calls": [
{
"to": "0x1234567890123456789012345678901234567890",
"value": "1000000000000000000",
"data": "0x"
}
],
"chain": "base",
"signer": "evm-keypair:0xdeadbeef"
},
"onChain": {
"userOperation": "... full user operation object",
"userOperationHash": "0xf719f9570671c6eb016f1f4a95ada4278b8e91f55bc384d70c69fd756919a41c"
},
"createdAt": "2024-01-01T00:00:00Z"
}
]
}Headers
API key required for authentication
Path Parameters
A wallet locator can be of the format:
<walletAddress>email:<email>:<walletType>userId:<userId>:<walletType>userId:<userId>:<walletType>(white label user example)phoneNumber:<phoneNumber>:<walletType>twitter:<handle>:<walletType>x:<handle>:<walletType>
Response
List of transactions with their status, signing requirements, and wallet type specific data
Complete transaction response including status, signing requirements, and wallet type specific data
The type of wallet that created this transaction
evm-smart-wallet EVM smart wallet transaction parameters
Array of transaction calls to execute
Transaction data to execute
The recipient address for this transaction call
The name of the function to call
The arguments to pass to the function
The amount of native token to send in wei
The chain on which the transaction will be executed
base, polygon, optimism, arbitrum, mode, story, base-sepolia, polygon-amoy, optimism-sepolia, arbitrum-sepolia, mode-sepolia, story-testnet The locator for the signer who will submit this transaction
[
"evm-keypair:0x1234567890123456789012345678901234567890",
"evm-passkey:credential-id-123",
"evm-fireblocks-custodial:0x1234567890123456789012345678901234567890",
"solana-keypair:DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ",
"solana-fireblocks-custodial:DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ"
]
EVM smart wallet transaction data including input parameters and chain specific details
Unique identifier for the transaction
Current status of the transaction
awaiting-approval, pending, failed, success ISO timestamp when the transaction was created
"2024-01-01T00:00:00.000Z"
Complete approval data including requirements, pending and submitted signatures
Record of all submitted signatures
The cryptographic signature
When the signature was submitted
"2024-01-01T00:00:00.000Z"
The locator of the signer who submitted this signature
[
"evm-keypair:0x1234567890123456789012345678901234567890",
"evm-passkey:credential-id-123",
"evm-fireblocks-custodial:0x1234567890123456789012345678901234567890",
"solana-keypair:DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ",
"solana-fireblocks-custodial:DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ"
]
The message that was signed
Number of required approvals for the transaction
ISO timestamp when the transaction reached finality
"2024-01-01T00:00:00.000Z"
Was this page helpful?
curl --request GET \
--url https://staging.crossmint.com/api/2022-06-09/wallets/{walletLocator}/transactions \
--header 'X-API-KEY: <x-api-key>'{
"transactions": [
{
"id": "tx-b984491a-5785-43c0-8811-45d46fe6e520",
"walletType": "evm-smart-wallet",
"status": "awaiting-approval",
"approvals": {
"pending": [
{
"signer": "evm-keypair:0xdeadbeef",
"message": "Please sign this transaction"
}
],
"submitted": []
},
"params": {
"calls": [
{
"to": "0x1234567890123456789012345678901234567890",
"value": "1000000000000000000",
"data": "0x"
}
],
"chain": "base",
"signer": "evm-keypair:0xdeadbeef"
},
"onChain": {
"userOperation": "... full user operation object",
"userOperationHash": "0xf719f9570671c6eb016f1f4a95ada4278b8e91f55bc384d70c69fd756919a41c"
},
"createdAt": "2024-01-01T00:00:00Z"
}
]
}