Retrieve notifications for a device with pagination
offset | number Example: offset=0 Pagination offset |
limit | number Example: limit=50 Pagination limit |
device-id required | string Unique identifier of the device |
{- "items": [
- {
- "id": "123e4567-e89b-12d3-a456-426614174000",
- "title": "Transaction Confirmed",
- "message": "Your transaction has been confirmed",
- "type": "transaction_confirmed",
- "read": false,
- "createdAt": "2023-01-01T00:00:00.000Z"
}
], - "total": 2
}
Retrieve notifications for a device with pagination
offset | number Example: offset=0 Pagination offset |
limit | number Example: limit=50 Pagination limit |
device-id required | string Unique identifier of the device |
{- "items": [
- {
- "id": "123e4567-e89b-12d3-a456-426614174000",
- "title": "Transaction Confirmed",
- "message": "Your transaction has been confirmed",
- "type": "transaction_confirmed",
- "read": false,
- "createdAt": "2023-01-01T00:00:00.000Z"
}
], - "total": 2
}
Retrieve a specific notification by ID
id required | string <uuid> Example: 123e4567-e89b-12d3-a456-426614174000 Notification ID |
device-id required | string Unique identifier of the device |
{- "id": "123e4567-e89b-12d3-a456-426614174000",
- "type": "transaction",
- "title": "Transaction Confirmed",
- "message": "Your transfer of 1.5 ETH has been confirmed",
- "read": false,
- "createdAt": "2024-01-20T10:30:00Z"
}
Retrieve a specific notification by ID
id required | string <uuid> Example: 123e4567-e89b-12d3-a456-426614174000 Notification ID |
device-id required | string Unique identifier of the device |
{- "id": "123e4567-e89b-12d3-a456-426614174000",
- "type": "transaction",
- "title": "Transaction Confirmed",
- "message": "Your transfer of 1.5 ETH has been confirmed",
- "read": false,
- "createdAt": "2024-01-20T10:30:00Z"
}
Mark a notification as read
id required | string <uuid> Example: 123e4567-e89b-12d3-a456-426614174000 Notification ID |
device-id required | string Unique identifier of the device |
{- "id": "123e4567-e89b-12d3-a456-426614174000",
- "read": true,
- "updatedAt": "2024-01-20T10:35:00Z"
}
Mark a notification as read
id required | string <uuid> Example: 123e4567-e89b-12d3-a456-426614174000 Notification ID |
device-id required | string Unique identifier of the device |
{- "id": "123e4567-e89b-12d3-a456-426614174000",
- "read": true,
- "updatedAt": "2024-01-20T10:35:00Z"
}
Get list of supported blockchain platforms
includeDisabled | boolean Example: includeDisabled=false Include disabled platforms in the response |
[- {
- "id": "ethereum",
- "name": "Ethereum",
- "enabled": true,
- "nativeToken": {
- "symbol": "ETH",
- "decimals": 18
}
}, - {
- "id": "polygon",
- "name": "Polygon",
- "enabled": true,
- "nativeToken": {
- "symbol": "MATIC",
- "decimals": 18
}
}
]
Get list of supported blockchain platforms
includeDisabled | boolean Example: includeDisabled=false Include disabled platforms in the response |
[- {
- "id": "ethereum",
- "name": "Ethereum",
- "enabled": true,
- "nativeToken": {
- "symbol": "ETH",
- "decimals": 18
}
}, - {
- "id": "polygon",
- "name": "Polygon",
- "enabled": true,
- "nativeToken": {
- "symbol": "MATIC",
- "decimals": 18
}
}
]
Get priority fee information for a platform
id required | string Example: ethereum Platform ID |
{- "slow": {
- "maxFeePerGas": "20000000000",
- "maxPriorityFeePerGas": "1000000000"
}, - "standard": {
- "maxFeePerGas": "25000000000",
- "maxPriorityFeePerGas": "1500000000"
}, - "fast": {
- "maxFeePerGas": "30000000000",
- "maxPriorityFeePerGas": "2000000000"
}
}
Get priority fee information for a platform
id required | string Example: ethereum Platform ID |
{- "slow": {
- "maxFeePerGas": "20000000000",
- "maxPriorityFeePerGas": "1000000000"
}, - "standard": {
- "maxFeePerGas": "25000000000",
- "maxPriorityFeePerGas": "1500000000"
}, - "fast": {
- "maxFeePerGas": "30000000000",
- "maxPriorityFeePerGas": "2000000000"
}
}
Estimate transaction fees for a platform
id required | string Example: ethereum Platform ID |
Transaction data
from required | string Sender address |
to required | string Recipient address |
value required | string Transaction value in wei |
data | string Transaction data |
{- "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
- "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
- "value": "1000000000000000000",
- "data": "0x"
}
{- "gasLimit": "21000",
- "maxFeePerGas": "25000000000",
- "maxPriorityFeePerGas": "1500000000"
}
Estimate transaction fees for a platform
id required | string Example: ethereum Platform ID |
Transaction data
from required | string Sender address |
to required | string Recipient address |
value required | string Transaction value in wei |
data | string Transaction data |
{- "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
- "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
- "value": "1000000000000000000",
- "data": "0x"
}
{- "gasLimit": "21000",
- "maxFeePerGas": "25000000000",
- "maxPriorityFeePerGas": "1500000000"
}
Retrieve a list of tokens or token contracts with pagination
platformId required | string Example: platformId=ethereum ID of the blockchain platform |
offset | number Example: offset=0 Pagination offset |
limit | number Example: limit=50 Pagination limit |
includeDisabled | boolean Example: includeDisabled=false Include disabled tokens in the response |
returnContracts | boolean Example: returnContracts=false Return token contract information instead of tokens |
{- "items": [
- {
- "id": "123e4567-e89b-12d3-a456-426614174000",
- "name": "Ethereum",
- "symbol": "ETH",
- "decimals": 18,
- "contractAddress": null,
- "platformId": "ethereum",
- "enabled": true,
}, - {
- "id": "123e4567-e89b-12d3-a456-426614174001",
- "name": "USD Coin",
- "symbol": "USDC",
- "decimals": 6,
- "contractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
- "platformId": "ethereum",
- "enabled": true,
}
], - "total": 2
}
Retrieve a list of tokens or token contracts with pagination
platformId required | string Example: platformId=ethereum ID of the blockchain platform |
offset | number Example: offset=0 Pagination offset |
limit | number Example: limit=50 Pagination limit |
includeDisabled | boolean Example: includeDisabled=false Include disabled tokens in the response |
returnContracts | boolean Example: returnContracts=false Return token contract information instead of tokens |
{- "items": [
- {
- "id": "123e4567-e89b-12d3-a456-426614174000",
- "name": "Ethereum",
- "symbol": "ETH",
- "decimals": 18,
- "contractAddress": null,
- "platformId": "ethereum",
- "enabled": true,
}, - {
- "id": "123e4567-e89b-12d3-a456-426614174001",
- "name": "USD Coin",
- "symbol": "USDC",
- "decimals": 6,
- "contractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
- "platformId": "ethereum",
- "enabled": true,
}
], - "total": 2
}
Register a new device with the application
Device registration details
devicePlatform required | object Enum: "ios" "android" Device platform (ios or android) |
appVersion required | string App version |
deviceToken | string Device token that is used for push notifications |
{- "devicePlatform": "ios",
- "appVersion": "1.2.0",
- "deviceToken": "c4d6e8f0-a2b4-4c6d-8e0f-2a4b6c8d0e2f"
}
{- "deviceId": "b2c4d6e8-f0a2-4b6c-8e0f-2a4b6c8d0e2f",
- "devicePlatform": "ios",
- "createdAt": "2025-06-19T19:38:02.000Z"
}
Register a new device with the application
Device registration details
devicePlatform required | object Enum: "ios" "android" Device platform (ios or android) |
appVersion required | string App version |
deviceToken | string Device token that is used for push notifications |
{- "devicePlatform": "ios",
- "appVersion": "1.2.0",
- "deviceToken": "c4d6e8f0-a2b4-4c6d-8e0f-2a4b6c8d0e2f"
}
{- "deviceId": "b2c4d6e8-f0a2-4b6c-8e0f-2a4b6c8d0e2f",
- "devicePlatform": "ios",
- "createdAt": "2025-06-19T19:38:02.000Z"
}
Update device usage information and get version requirements
device-id required | string <uuid> Example: b2c4d6e8-f0a2-4b6c-8e0f-2a4b6c8d0e2f Unique identifier of the device |
Device usage details
appVersion required | string App version |
deviceToken | string Device token |
{- "appVersion": "1.2.0",
- "deviceToken": "c4d6e8f0-a2b4-4c6d-8e0f-2a4b6c8d0e2f"
}
{- "devicePlatform": "ios",
- "minRequiredVersion": "1.0.0"
}
Update device usage information and get version requirements
device-id required | string <uuid> Example: b2c4d6e8-f0a2-4b6c-8e0f-2a4b6c8d0e2f Unique identifier of the device |
Device usage details
appVersion required | string App version |
deviceToken | string Device token |
{- "appVersion": "1.2.0",
- "deviceToken": "c4d6e8f0-a2b4-4c6d-8e0f-2a4b6c8d0e2f"
}
{- "devicePlatform": "ios",
- "minRequiredVersion": "1.0.0"
}
Save a list of wallet addresses associated with a device
device-id required | string Unique identifier of the device |
List of wallet addresses to save
required | Array of objects (WalletAddressDto) List of wallet addresses | ||||
Array
|
{- "addresses": [
- {
- "address": "string",
- "platformId": "string"
}
]
}
Save a list of wallet addresses associated with a device
device-id required | string Unique identifier of the device |
List of wallet addresses to save
required | Array of objects (WalletAddressDto) List of wallet addresses | ||||
Array
|
{- "addresses": [
- {
- "address": "string",
- "platformId": "string"
}
]
}
Retrieve balances for a specific wallet address
address required | string Wallet address |
platformId required | string Platform identifier |
contracts | string Comma-separated list of token contract IDs |
device-id required | string Unique identifier of the device |
Retrieve balances for a specific wallet address
address required | string Wallet address |
platformId required | string Platform identifier |
contracts | string Comma-separated list of token contract IDs |
device-id required | string Unique identifier of the device |
address required | string |
device-id required | string |
platformId required | string Platform ID |
txData required | string Hex transaction data |
{- "platformId": "string",
- "txData": "string"
}
Get a quote for swapping tokens
fromTokenId required | string Example: fromTokenId=123e4567-e89b-12d3-a456-426614174000 ID of the source token |
toTokenId required | string Example: toTokenId=123e4567-e89b-12d3-a456-426614174001 ID of the destination token |
amount required | string Example: amount=1000000000000000000 Amount of source token to swap (in wei) |
slippage | number Example: slippage=0.5 Maximum allowed slippage percentage |
inputToken required | string Input token |
outputToken required | string Output token |
amount required | number Amount |
slippage required | number Slippage |
{- "inputToken": "string",
- "outputToken": "string",
- "amount": 0,
- "slippage": 0
}
{- "fromToken": {
- "id": "123e4567-e89b-12d3-a456-426614174000",
- "symbol": "ETH",
- "decimals": 18
}, - "toToken": {
- "id": "123e4567-e89b-12d3-a456-426614174001",
- "symbol": "USDC",
- "decimals": 6
}, - "fromAmount": "1000000000000000000",
- "toAmount": "1850000000",
- "exchangeRate": "1850.00",
- "priceImpact": "0.15",
- "fee": "0.003",
- "route": [
- {
- "protocol": "Uniswap V3",
- "fromToken": "ETH",
- "toToken": "USDC",
- "share": 100
}
]
}
Get transaction data for a token swap
device-id required | string |
userPublicKey required | string User public key |
platformId required | string Platform ID |
required | object Swap quote (received from /swap/quote) |
{- "userPublicKey": "string",
- "platformId": "string",
- "quote": {
- "inputAsset": "string",
- "inAmount": "string",
- "outputAsset": "string",
- "outAmount": "string",
- "otherAmountThreshold": "string",
- "swapMode": "string",
- "slippageBps": 0,
- "priceImpactPct": "string",
- "platformFee": {
- "amount": "string",
- "feeBps": 0
}, - "swapRoutes": [
- {
- "swapInfo": {
- "ammKey": "string",
- "label": "string",
- "inputAsset": "string",
- "outputAsset": "string",
- "inAmount": "string",
- "outAmount": "string",
- "feeAmount": "string",
- "feeAsset": "string"
}, - "percent": 0
}
]
}
}
{- "data": "string",
- "value": "string",
- "to": "string",
- "gasLimit": "string"
}
Get a quote for swapping tokens
fromTokenId required | string Example: fromTokenId=123e4567-e89b-12d3-a456-426614174000 ID of the source token |
toTokenId required | string Example: toTokenId=123e4567-e89b-12d3-a456-426614174001 ID of the destination token |
amount required | string Example: amount=1000000000000000000 Amount of source token to swap (in wei) |
slippage | number Example: slippage=0.5 Maximum allowed slippage percentage |
inputToken required | string Input token |
outputToken required | string Output token |
amount required | number Amount |
slippage required | number Slippage |
{- "inputToken": "string",
- "outputToken": "string",
- "amount": 0,
- "slippage": 0
}
{- "fromToken": {
- "id": "123e4567-e89b-12d3-a456-426614174000",
- "symbol": "ETH",
- "decimals": 18
}, - "toToken": {
- "id": "123e4567-e89b-12d3-a456-426614174001",
- "symbol": "USDC",
- "decimals": 6
}, - "fromAmount": "1000000000000000000",
- "toAmount": "1850000000",
- "exchangeRate": "1850.00",
- "priceImpact": "0.15",
- "fee": "0.003",
- "route": [
- {
- "protocol": "Uniswap V3",
- "fromToken": "ETH",
- "toToken": "USDC",
- "share": 100
}
]
}
Get transaction data for a token swap
device-id required | string |
userPublicKey required | string User public key |
platformId required | string Platform ID |
required | object Swap quote (received from /swap/quote) |
{- "userPublicKey": "string",
- "platformId": "string",
- "quote": {
- "inputAsset": "string",
- "inAmount": "string",
- "outputAsset": "string",
- "outAmount": "string",
- "otherAmountThreshold": "string",
- "swapMode": "string",
- "slippageBps": 0,
- "priceImpactPct": "string",
- "platformFee": {
- "amount": "string",
- "feeBps": 0
}, - "swapRoutes": [
- {
- "swapInfo": {
- "ammKey": "string",
- "label": "string",
- "inputAsset": "string",
- "outputAsset": "string",
- "inAmount": "string",
- "outAmount": "string",
- "feeAmount": "string",
- "feeAsset": "string"
}, - "percent": 0
}
]
}
}
{- "data": "string",
- "value": "string",
- "to": "string",
- "gasLimit": "string"
}
Retrieve detailed information about a specific transaction
txId required | number Transaction ID |
address required | string Wallet address |
device-id required | string Device ID |
{- "id": 0,
- "hash": "string",
- "status": "pending",
- "tokenContractId": 0,
- "fromAddress": "string",
- "toAddress": "string",
- "amount": "string",
- "fee": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
Retrieve detailed information about a specific transaction
txId required | number Transaction ID |
address required | string Wallet address |
device-id required | string Device ID |
{- "id": 0,
- "hash": "string",
- "status": "pending",
- "tokenContractId": 0,
- "fromAddress": "string",
- "toAddress": "string",
- "amount": "string",
- "fee": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
Retrieve transaction history for a device or address
address | string Wallet address |
tokenContractId | number Token contract ID |
platformId | string Platform ID |
offset | number Example: offset=0 Pagination offset |
limit | number Example: limit=50 Pagination limit |
device-id required | string Device ID |
{- "items": [
- {
- "id": 0,
- "hash": "string",
- "status": "pending",
- "tokenContractId": 0,
- "fromAddress": "string",
- "toAddress": "string",
- "amount": "string",
- "fee": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "total": 0
}
Retrieve transaction history for a device or address
address | string Wallet address |
tokenContractId | number Token contract ID |
platformId | string Platform ID |
offset | number Example: offset=0 Pagination offset |
limit | number Example: limit=50 Pagination limit |
device-id required | string Device ID |
{- "items": [
- {
- "id": 0,
- "hash": "string",
- "status": "pending",
- "tokenContractId": 0,
- "fromAddress": "string",
- "toAddress": "string",
- "amount": "string",
- "fee": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "total": 0
}
{- "minVersions": [
- {
- "devicePlatform": "ios",
- "minRequiredVersion": "1.0.0"
}, - {
- "devicePlatform": "android",
- "minRequiredVersion": "1.1.0"
}
], - "supportedPlatforms": [
- {
- "id": "ethereum",
- "name": "Ethereum",
- "enabled": true,
- "nativeToken": {
- "symbol": "ETH",
- "decimals": 18
}
}, - {
- "id": "polygon",
- "name": "Polygon",
- "enabled": true,
- "nativeToken": {
- "symbol": "MATIC",
- "decimals": 18
}
}
]
}
{- "minVersions": [
- {
- "devicePlatform": "ios",
- "minRequiredVersion": "1.0.0"
}, - {
- "devicePlatform": "android",
- "minRequiredVersion": "1.1.0"
}
], - "supportedPlatforms": [
- {
- "id": "ethereum",
- "name": "Ethereum",
- "enabled": true,
- "nativeToken": {
- "symbol": "ETH",
- "decimals": 18
}
}, - {
- "id": "polygon",
- "name": "Polygon",
- "enabled": true,
- "nativeToken": {
- "symbol": "MATIC",
- "decimals": 18
}
}
]
}