API Documentation

APIs List:

Get transactions

curl --location 'https://partner-test.saakuru.com/api/verre/transactions?chainId=247253&address=0xb6612afebfea051cd972abf1c1830fa32861c73c' \
--header 'x-api-key: partner-api-key'

Supported query params:

  • address - wallet address in String format

  • contract - contract address in String format (optional)

  • chainId - chain Id in Number format

  • limit - Number of records (optional - default 10, max 20)

  • offset - Skip Number of records (optional - default 0)

Response:

{
    "responseCode": "ok",
    "data": {
        "offset": 0,
        "limit": 1,
        "entries": [
            {
                "timeFields": {
                    "month": 3,
                    "weekOfMonth": 5,
                    "week": 18,
                    "day": 29,
                    "minute": 50,
                    "year": 2024,
                    "hour": 2,
                    "dayOfWeek": 2,
                    "dayOfYear": 120
                },
                "type": "contract",
                "blockHash": "0x6a04f32f4185da09ee5e774ffe9c4c330e6dad35ccd87519137376b90cd6e54c",
                "from": "0xB8E4c5717620F6bdd5903E3ef2BB1f6973285682",
                "blockNum": 26617,
                "data": "complete",
                "requestTime": 1714402258133,
                "wallets": [
                    "0xb8e4c5717620f6bdd5903e3ef2bb1f6973285682"
                ],
                "tokens": [
                    "685_247253_0xfaf2ee6359eff0b13252069720aba10a04e522c4"
                ],
                "eventCount": 5,
                "memo": null,
                "bip44": "685",
                "txData": {
                    "method": "signTransaction",
                    "id": 1714402244636,
                    "params": {
                        "data": "0x3ccfd60b",
                        "gas": "0x11967",
                        "to": "0x6c4b5c8dbd650811087879677cb540edef983376",
                        "from": "0xb8e4c5717620f6bdd5903e3ef2bb1f6973285682"
                    },
                    "sourceUrl": "https://aag-new-website-next-test.herokuapp.com/portal",
                    "name": "signTransaction",
                    "object": {
                        "data": "0x3ccfd60b",
                        "gas": "0x11967",
                        "to": "0x6c4b5c8dbd650811087879677cb540edef983376",
                        "from": "0xb8e4c5717620f6bdd5903e3ef2bb1f6973285682"
                    }
                },
                "chainId": "247253",
                "contracts": [
                    "0x6c4b5c8dbd650811087879677cb540edef983376",
                    "0xfaf2ee6359eff0b13252069720aba10a04e522c4"
                ],
                "hash": "0x05a0f7343854dda1ed1ed6c2721552f91e95af63d406b5fa4b24fe2ff470ad96",
                "sourceUrl": "aag-new-website-next-test.herokuapp.com",
                "status": 1,
                "tags": [
                    "COIN",
                    "INTERNAL",
                    "EVM",
                    "ERC20",
                    "TOKEN"
                ],
                "time": 1714402257000,
                "nonce": "0x02",
                "value": {
                    "bigNumber": "0x00",
                    "number": 0
                },
                "byzantium": true,
                "to": "0x6C4b5c8DBD650811087879677CB540eDEF983376",
                "func": "withdraw()",
                "_id": "685_247253_0x05a0f7343854dda1ed1ed6c2721552f91e95af63d406b5fa4b24fe2ff470ad96",
                "_seq_no": 5128,
                "_primary_term": 1,
                "events": [
                    {
                        "topics": [
                            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                            "0x0000000000000000000000006c4b5c8dbd650811087879677cb540edef983376",
                            "0x000000000000000000000000b8e4c5717620f6bdd5903e3ef2bb1f6973285682"
                        ],
                        "logIndex": 0,
                        "token": {
                            "token": {
                                "contractAddress": "0xfaF2ee6359EFf0b13252069720aBA10a04E522C4",
                                "name": "Saakuru",
                                "symbol": "SKR",
                                "decimals": 18,
                                "chainId": "247253",
                                "bip44": "685",
                                "_id": "685_247253_0xfaf2ee6359eff0b13252069720aba10a04e522c4",
                                "_seq_no": 126614,
                                "_primary_term": 1,
                                "verified": 0
                            },
                            "transferAmount": {
                                "bigNumber": "0x23a86eb7192f90bc37",
                                "number": 657.7728819444444
                            }
                        },
                        "tags": [
                            "ERC20",
                            "TOKEN",
                            "EVM"
                        ],
                        "from": "0x6c4b5c8dbd650811087879677cb540edef983376",
                        "to": "0xb8e4c5717620f6bdd5903e3ef2bb1f6973285682",
                        "type": "transfer",
                        "time": 1714402257000,
                        "blockHash": "0x6a04f32f4185da09ee5e774ffe9c4c330e6dad35ccd87519137376b90cd6e54c",
                        "blockNum": 26617,
                        "txnHash": "0x05a0f7343854dda1ed1ed6c2721552f91e95af63d406b5fa4b24fe2ff470ad96",
                        "status": 1,
                        "bip44": "685",
                        "chainId": "247253",
                        "ledger": {
                            "bigNumber": "0x23a86eb7192f90bc37",
                            "number": "657.772881944444451895",
                            "decimals": 18
                        },
                        "tokens": [
                            "685_247253_0xfaf2ee6359eff0b13252069720aba10a04e522c4"
                        ],
                        "timeFields": {
                            "year": 2024,
                            "month": 3,
                            "day": 29,
                            "dayOfWeek": 2,
                            "dayOfYear": 120,
                            "hour": 2,
                            "minute": 50,
                            "weekOfMonth": 5,
                            "week": 18
                        },
                        "wallets": [
                            "0xb8e4c5717620f6bdd5903e3ef2bb1f6973285682"
                        ],
                        "contracts": [
                            "0x6c4b5c8dbd650811087879677cb540edef983376",
                            "0xfaf2ee6359eff0b13252069720aba10a04e522c4"
                        ],
                        "_id": "685_247253_0x05a0f7343854dda1ed1ed6c2721552f91e95af63d406b5fa4b24fe2ff470ad96_l0",
                        "_seq_no": 10760,
                        "_primary_term": 1
                    },
                    {
                        "topics": [
                            "0xf279e6a1f5e320cca91135676d9cb6e44ca8a08c0b88342bcdb1144f6511b568",
                            "0x000000000000000000000000b8e4c5717620f6bdd5903e3ef2bb1f6973285682",
                            "0x000000000000000000000000000000000000000000000023a86eb7192f90bc37",
                            "0x00000000000000000000000000000000000000000000000000000000662fb3d1"
                        ],
                        "logIndex": 1,
                        "from": "0xB8E4c5717620F6bdd5903E3ef2BB1f6973285682",
                        "to": "0x6C4b5c8DBD650811087879677CB540eDEF983376",
                        "type": "custom",
                        "time": 1714402257000,
                        "blockHash": "0x6a04f32f4185da09ee5e774ffe9c4c330e6dad35ccd87519137376b90cd6e54c",
                        "blockNum": 26617,
                        "txnHash": "0x05a0f7343854dda1ed1ed6c2721552f91e95af63d406b5fa4b24fe2ff470ad96",
                        "status": 1,
                        "bip44": "685",
                        "chainId": "247253",
                        "tags": [
                            "EVM"
                        ],
                        "ledger": {
                            "bigNumber": "0x0",
                            "number": "0",
                            "decimals": 18
                        },
                        "timeFields": {
                            "year": 2024,
                            "month": 3,
                            "day": 29,
                            "dayOfWeek": 2,
                            "dayOfYear": 120,
                            "hour": 2,
                            "minute": 50,
                            "weekOfMonth": 5,
                            "week": 18
                        },
                        "wallets": [
                            "0xb8e4c5717620f6bdd5903e3ef2bb1f6973285682"
                        ],
                        "contracts": [
                            "0x6c4b5c8dbd650811087879677cb540edef983376"
                        ],
                        "_id": "685_247253_0x05a0f7343854dda1ed1ed6c2721552f91e95af63d406b5fa4b24fe2ff470ad96_l1",
                        "_seq_no": 10906,
                        "_primary_term": 1
                    },
                    {
                        "logIndex": 2,
                        "fee": {
                            "from": "0xB8E4c5717620F6bdd5903E3ef2BB1f6973285682",
                            "transferAmount": {
                                "bigNumber": "0x00",
                                "number": 0.0
                            },
                            "decimals": 18
                        },
                        "tags": [
                            "COIN",
                            "EVM"
                        ],
                        "type": "fee",
                        "time": 1714402257000,
                        "blockHash": "0x6a04f32f4185da09ee5e774ffe9c4c330e6dad35ccd87519137376b90cd6e54c",
                        "blockNum": 26617,
                        "txnHash": "0x05a0f7343854dda1ed1ed6c2721552f91e95af63d406b5fa4b24fe2ff470ad96",
                        "status": 1,
                        "bip44": "685",
                        "chainId": "247253",
                        "ledger": {
                            "bigNumber": "0x00",
                            "number": "0",
                            "decimals": 18
                        },
                        "timeFields": {
                            "year": 2024,
                            "month": 3,
                            "day": 29,
                            "dayOfWeek": 2,
                            "dayOfYear": 120,
                            "hour": 2,
                            "minute": 50,
                            "weekOfMonth": 5,
                            "week": 18
                        },
                        "wallets": [
                            "0xb8e4c5717620f6bdd5903e3ef2bb1f6973285682"
                        ],
                        "_id": "685_247253_0x05a0f7343854dda1ed1ed6c2721552f91e95af63d406b5fa4b24fe2ff470ad96_l2",
                        "_seq_no": 10702,
                        "_primary_term": 1
                    },
                    {
                        "from": "0xb8e4c5717620f6bdd5903e3ef2bb1f6973285682",
                        "to": "0x6c4b5c8dbd650811087879677cb540edef983376",
                        "type": "transfer",
                        "tags": [
                            "COIN",
                            "INTERNAL",
                            "EVM"
                        ],
                        "eventIndex": 0,
                        "time": 1714402257000,
                        "blockHash": "0x6a04f32f4185da09ee5e774ffe9c4c330e6dad35ccd87519137376b90cd6e54c",
                        "blockNum": 26617,
                        "txnHash": "0x05a0f7343854dda1ed1ed6c2721552f91e95af63d406b5fa4b24fe2ff470ad96",
                        "status": 1,
                        "bip44": "685",
                        "chainId": "247253",
                        "ledger": {
                            "bigNumber": "0x0",
                            "number": "0",
                            "decimals": 18
                        },
                        "timeFields": {
                            "year": 2024,
                            "month": 3,
                            "day": 29,
                            "dayOfWeek": 2,
                            "dayOfYear": 120,
                            "hour": 2,
                            "minute": 50,
                            "weekOfMonth": 5,
                            "week": 18
                        },
                        "wallets": [
                            "0xb8e4c5717620f6bdd5903e3ef2bb1f6973285682"
                        ],
                        "contracts": [
                            "0x6c4b5c8dbd650811087879677cb540edef983376"
                        ],
                        "_id": "685_247253_0x05a0f7343854dda1ed1ed6c2721552f91e95af63d406b5fa4b24fe2ff470ad96_e0",
                        "_seq_no": 10915,
                        "_primary_term": 1,
                        "coin": {
                            "from": "0xb8e4c5717620f6bdd5903e3ef2bb1f6973285682",
                            "to": "0x6c4b5c8dbd650811087879677cb540edef983376",
                            "transferAmount": {
                                "bigNumber": "0x0",
                                "number": 0.0
                            },
                            "decimals": 18
                        }
                    }
                ],
                "fee": {
                    "gasLimit": "11000000",
                    "gasPrice": "0",
                    "gasUsed": "67056",
                    "maxFeePerGas": "0",
                    "maxPriorityFeePerGas": "0",
                    "effectiveGasPrice": "0",
                    "cumulativeGasUsed": "67056",
                    "amount": "0"
                }
            }
        ],
        "aggregates": {},
        "total": 4
    }
}

Get Token balances

curl --location 'https://partner-test.saakuru.com/api/verre/balances?address=0xb6612afebfea051cd972abf1c1830fa32861c73c' \
--header 'x-api-key: partner-api-key'

Supported query params:

  • address - wallet address in String format

  • contract - contract address in String format (optional)

  • chainId - chain Id in Number format (optional)

Response:

{
    "responseCode": "ok",
    "data": [
        {
            "currencyName": "USD Coin",
            "currencySymbol": "USDC",
            "balance": "17542.106295",
            "verified": 1,
            "assetRef": "LEJJXS238223",
            "stakedBalance": "0",
            "decimals": 6,
            "details": {
                "coingecko": {}
            },
            "wallets": [
                {
                    "_id": "60_5_0xb6612afebfea051cd972abf1c1830fa32861c73c",
                    "name": "Ethereum (Goerli) (ETH)",
                    "address": "0xb6612afebfea051cd972abf1c1830fa32861c73c",
                    "externalWalletId": "500090812",
                    "externalCurrencyId": "60",
                    "addressRegex": "^0x[a-fA-F0-9]{40}$",
                    "image": {
                        "thumb": "https://dlfpra32kw4xu.cloudfront.net/cryptoassetref/ethereum/media/thumb.png",
                        "small": "https://dlfpra32kw4xu.cloudfront.net/cryptoassetref/ethereum/media/small.png",
                        "large": "https://dlfpra32kw4xu.cloudfront.net/cryptoassetref/ethereum/media/large.png"
                    },
                    "network": {
                        "chainId": "5",
                        "externalCurrencyId": "60",
                        "currency": "ETH",
                        "name": "Ether",
                        "decimals": 18,
                        "rpcUrl": "https://goerli.infura.io/v3/9aa3d95b3bc440fa88ea12eaa4456161",
                        "addressRegex": "^0x[a-fA-F0-9]{40}$"
                    },
                    "balance": "17542.106295",
                    "hexBalance": "0x16253080d169600",
                    "stakedBalance": "0",
                    "contractAddress": "0x07865c6e87b9f70255377e024ace6630c1eaa37f"
                }
            ]
        },
        {
            "externalCurrencyId": "60",
            "currency": "ETH",
            "decimals": 18,
            "rpcUrl": "https://goerli.infura.io/v3/9aa3d95b3bc440fa88ea12eaa4456161",
            "assetRef": "ethereum",
            "balance": "0.099733435800000000",
            "stakedBalance": "0",
            "currencyName": "Ethereum",
            "currencySymbol": "ETH",
            "details": {
                "coingecko": {
                    "image": {
                        "thumb": "https://dlfpra32kw4xu.cloudfront.net/cryptoassetref/ethereum/media/thumb.png",
                        "small": "https://dlfpra32kw4xu.cloudfront.net/cryptoassetref/ethereum/media/small.png",
                        "large": "https://dlfpra32kw4xu.cloudfront.net/cryptoassetref/ethereum/media/large.png"
                    }
                }
            },
            "wallets": [
                {
                    "_id": "60_5_0xb6612afebfea051cd972abf1c1830fa32861c73c",
                    "name": "Ethereum (Goerli) (ETH)",
                    "address": "0xb6612afebfea051cd972abf1c1830fa32861c73c",
                    "externalWalletId": "500090812",
                    "externalCurrencyId": "60",
                    "addressRegex": "^0x[a-fA-F0-9]{40}$",
                    "image": {
                        "thumb": "https://dlfpra32kw4xu.cloudfront.net/cryptoassetref/ethereum/media/thumb.png",
                        "small": "https://dlfpra32kw4xu.cloudfront.net/cryptoassetref/ethereum/media/small.png",
                        "large": "https://dlfpra32kw4xu.cloudfront.net/cryptoassetref/ethereum/media/large.png"
                    },
                    "network": {
                        "chainId": "5",
                        "externalCurrencyId": "60",
                        "currency": "ETH",
                        "name": "Ether",
                        "decimals": 18,
                        "rpcUrl": "https://goerli.infura.io/v3/9aa3d95b3bc440fa88ea12eaa4456161",
                        "addressRegex": "^0x[a-fA-F0-9]{40}$"
                    },
                    "balance": "0.099733435800000000",
                    "hexBalance": "0x16253080d169600",
                    "stakedBalance": "0"
                }
            ],
            "price": "3365.51"
        },
        {
            "currencyName": "Wrapped Ether",
            "currencySymbol": "WETH",
            "balance": "0E-18",
            "verified": 0,
            "assetRef": "HDJT8223J223",
            "stakedBalance": "0",
            "decimals": 18,
            "details": {
                "coingecko": {}
            },
            "wallets": [
                {
                    "_id": "60_5_0xb6612afebfea051cd972abf1c1830fa32861c73c",
                    "name": "Ethereum (Goerli) (ETH)",
                    "address": "0xb6612afebfea051cd972abf1c1830fa32861c73c",
                    "externalWalletId": "500090812",
                    "externalCurrencyId": "60",
                    "addressRegex": "^0x[a-fA-F0-9]{40}$",
                    "image": {
                        "thumb": "https://dlfpra32kw4xu.cloudfront.net/cryptoassetref/ethereum/media/thumb.png",
                        "small": "https://dlfpra32kw4xu.cloudfront.net/cryptoassetref/ethereum/media/small.png",
                        "large": "https://dlfpra32kw4xu.cloudfront.net/cryptoassetref/ethereum/media/large.png"
                    },
                    "network": {
                        "chainId": "5",
                        "externalCurrencyId": "60",
                        "currency": "ETH",
                        "name": "Ether",
                        "decimals": 18,
                        "rpcUrl": "https://goerli.infura.io/v3/9aa3d95b3bc440fa88ea12eaa4456161",
                        "addressRegex": "^0x[a-fA-F0-9]{40}$"
                    },
                    "balance": "0E-18",
                    "hexBalance": "0x16253080d169600",
                    "stakedBalance": "0",
                    "contractAddress": "0xb4fbf271143f4fbf7b91a5ded31805e42b2208d6"
                }
            ]
        }
    ]
}

Last updated