API Documentation

APIs List:

Get transactions - issue different stats for NFTs
Get T oken balances - get NFT data
Subscribe to address transactions - subscribe to interactions for specific addresses in real-time

Get transactions

curl --location 'https://ws-test.aag.ventures/api/verre/transactions?chainId=7225878' \
--header 'x-api-key: partner-api-key'

Supported query params:

emails - Array of emails in String format
addresses - Array of Ethereum addresses in String format
contract - contract addresses in String format
limit - Number of records
Page - Skip Number of pages

Response:

{
    "responseCode": "ok",
    "data": {
        "offset": 0,
        "limit": 20,
        "entries": [
            {
                "_id": "685_7225878_0x95e16c5103e399a139dcc7523f120d074b2aa8011224a0489f74b52f762ac9b0",
                "hash": "0x95e16c5103e399a139dcc7523f120d074b2aa8011224a0489f74b52f762ac9b0",
                "to": "0x878c7A7df76E8FC56791076225c227BEDC3DD393",
                "from": "0x5B49BC2d9BE5cB98FdBD414fdf152a719c22EBB1",
                "value": {
                    "bigNumber": "0x00",
                    "number": 0
                },
                "type": "contract",
                "byzantium": true,
                "status": 1,
                "nonce": "0x43",
                "data": "complete",
                "tags": [
                    "EVM",
                    "COIN"
                ],
                "chainId": "7225878",
                "bip44": "685",
                "time": 1707192427000,
                "blockHash": "0xd23cd8a2509a7fbc2d07e888e63c70189b104729b51c8f90619918c8908bab22",
                "blockNum": 11013642,
                "eventCount": 2,
                "events": [
                    {
                        "_id": "685_7225878_0x95e16c5103e399a139dcc7523f120d074b2aa8011224a0489f74b52f762ac9b0_l0",
                        "topics": [
                            "0xe5f3810511baa1c5f40e87f82a30b87c288db71fc105a284a519e252e711dc96",
                            "0x0000000000000000000000000000000000000000000000000000000000000055"
                        ],
                        "logIndex": 0,
                        "from": "0x5B49BC2d9BE5cB98FdBD414fdf152a719c22EBB1",
                        "to": "0x878c7A7df76E8FC56791076225c227BEDC3DD393",
                        "related": [
                            "0x5b49bc2d9be5cb98fdbd414fdf152a719c22ebb1",
                            "0x878c7a7df76e8fc56791076225c227bedc3dd393"
                        ],
                        "type": "custom",
                        "time": 1707192427000,
                        "blockHash": "0xd23cd8a2509a7fbc2d07e888e63c70189b104729b51c8f90619918c8908bab22",
                        "blockNum": 11013642,
                        "txnHash": "0x95e16c5103e399a139dcc7523f120d074b2aa8011224a0489f74b52f762ac9b0",
                        "status": 1,
                        "bip44": "685",
                        "chainId": "7225878",
                        "tags": [
                            "EVM"
                        ],
                        "ledger": {
                            "bigNumber": "0x0",
                            "number": "0",
                            "decimals": 18
                        }
                    },
                    {
                        "_id": "685_7225878_0x95e16c5103e399a139dcc7523f120d074b2aa8011224a0489f74b52f762ac9b0_l1",
                        "logIndex": 1,
                        "fee": {
                            "from": "0x5B49BC2d9BE5cB98FdBD414fdf152a719c22EBB1",
                            "transferAmount": {
                                "bigNumber": "0x00",
                                "number": 0.0
                            },
                            "decimals": 18
                        },
                        "tags": [
                            "COIN",
                            "EVM"
                        ],
                        "related": [
                            "0x5b49bc2d9be5cb98fdbd414fdf152a719c22ebb1"
                        ],
                        "type": "fee",
                        "time": 1707192427000,
                        "blockHash": "0xd23cd8a2509a7fbc2d07e888e63c70189b104729b51c8f90619918c8908bab22",
                        "blockNum": 11013642,
                        "txnHash": "0x95e16c5103e399a139dcc7523f120d074b2aa8011224a0489f74b52f762ac9b0",
                        "status": 1,
                        "bip44": "685",
                        "chainId": "7225878",
                        "ledger": {
                            "bigNumber": "0x00",
                            "number": "0",
                            "decimals": 18
                        }
                    }
                ],
                "scamTokens": [],
                "fee": {
                    "gasLimit": "11000000",
                    "gasPrice": "0",
                    "gasUsed": "178017",
                    "maxFeePerGas": "0",
                    "maxPriorityFeePerGas": "0",
                    "effectiveGasPrice": "0",
                    "cumulativeGasUsed": "178017",
                    "amount": "0"
                }
            },
            {
                "_id": "685_7225878_0x450eb206a7ad150ad532f42e017230207edd6dbd40998ea86f3c26c72cf1bde6",
                "hash": "0x450eb206a7ad150ad532f42e017230207edd6dbd40998ea86f3c26c72cf1bde6",
                "to": "0xCC5b622C58085A9Afb7e93c454a79AD3540478fE",
                "from": "0x60927F9206C274f35922DB263Fd63451BBdb43a6",
                "value": {
                    "bigNumber": "0x00",
                    "number": 0
                },
                "type": "erc721",
                "func": "Transfer",
                "byzantium": true,
                "status": 1,
                "nonce": "0x21",
                "data": "complete",
                "tags": [
                    "EVM",
                    "ERC721",
                    "NFT",
                    "COIN"
                ],
                "chainId": "7225878",
                "bip44": "685",
                "time": 1704795735000,
                "blockHash": "0x29f7b2f6858c51fe6bee55e4d9a6bb92f45989c6010ba6d6623589e3f3b79225",
                "blockNum": 6936761,
                "eventCount": 3,
                "events": [
                    {
                        "_id": "685_7225878_0x450eb206a7ad150ad532f42e017230207edd6dbd40998ea86f3c26c72cf1bde6_l0",
                        "topics": [
                            "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925",
                            "0x00000000000000000000000060927f9206c274f35922db263fd63451bbdb43a6",
                            "0x0000000000000000000000000000000000000000000000000000000000000000",
                            "0x0000000000000000000000000000000000000000000000000000000000000055"
                        ],
                        "logIndex": 0,
                        "from": "0x60927F9206C274f35922DB263Fd63451BBdb43a6",
                        "to": "0xCC5b622C58085A9Afb7e93c454a79AD3540478fE",
                        "related": [
                            "0x60927f9206c274f35922db263fd63451bbdb43a6",
                            "0xcc5b622c58085a9afb7e93c454a79ad3540478fe"
                        ],
                        "type": "custom",
                        "time": 1704795735000,
                        "blockHash": "0x29f7b2f6858c51fe6bee55e4d9a6bb92f45989c6010ba6d6623589e3f3b79225",
                        "blockNum": 6936761,
                        "txnHash": "0x450eb206a7ad150ad532f42e017230207edd6dbd40998ea86f3c26c72cf1bde6",
                        "status": 1,
                        "bip44": "685",
                        "chainId": "7225878",
                        "tags": [
                            "EVM"
                        ],
                        "ledger": {
                            "bigNumber": "0x0",
                            "number": "0",
                            "decimals": 18
                        }
                    },
                    {
                        "_id": "685_7225878_0x450eb206a7ad150ad532f42e017230207edd6dbd40998ea86f3c26c72cf1bde6_l1",
                        "topics": [
                            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                            "0x00000000000000000000000060927f9206c274f35922db263fd63451bbdb43a6",
                            "0x0000000000000000000000005b49bc2d9be5cb98fdbd414fdf152a719c22ebb1",
                            "0x0000000000000000000000000000000000000000000000000000000000000055"
                        ],
                        "logIndex": 1,
                        "tags": [
                            "ERC721",
                            "NFT",
                            "EVM"
                        ],
                        "from": "0x60927f9206c274f35922db263fd63451bbdb43a6",
                        "to": "0x5b49bc2d9be5cb98fdbd414fdf152a719c22ebb1",
                        "related": [
                            "0x60927f9206c274f35922db263fd63451bbdb43a6",
                            "0x5b49bc2d9be5cb98fdbd414fdf152a719c22ebb1",
                            "0xcc5b622c58085a9afb7e93c454a79ad3540478fe"
                        ],
                        "type": "transfer",
                        "time": 1704795735000,
                        "blockHash": "0x29f7b2f6858c51fe6bee55e4d9a6bb92f45989c6010ba6d6623589e3f3b79225",
                        "blockNum": 6936761,
                        "txnHash": "0x450eb206a7ad150ad532f42e017230207edd6dbd40998ea86f3c26c72cf1bde6",
                        "status": 1,
                        "bip44": "685",
                        "chainId": "7225878",
                        "nftHash": "0xcc5b622c58085a9afb7e93c454a79ad3540478fe",
                        "nftNum": "85",
                        "ledger": {
                            "bigNumber": "0x1",
                            "number": "1",
                            "decimals": 0
                        },
                        "nft": {
                            "_id": "685_7225878_0xCC5b622C58085A9Afb7e93c454a79AD3540478fE",
                            "contractAddress": "0xCC5b622C58085A9Afb7e93c454a79AD3540478fE",
                            "name": "TomoOne",
                            "symbol": "TM1",
                            "chainId": "7225878",
                            "bip44": "685",
                            "type": "ERC721",
                            "clazz": "NFT",
                            "generalType": "NFT"
                        },
                        "nftInstance": {
                            "_id": "685_7225878_0xCC5b622C58085A9Afb7e93c454a79AD3540478fE_85",
                            "instanceId": "85",
                            "nft": "685_7225878_0xcc5b622c58085a9afb7e93c454a79ad3540478fe",
                            "attributes": [
                                {
                                    "trait_type": "type",
                                    "value": "Hamster"
                                },
                                {
                                    "trait_type": "modifiable",
                                    "value": "true"
                                }
                            ],
                            "tokenURI": "https://stealth101.infura-ipfs.io/ipfs/QmP1jREoV4HBctxmpCXSRVCVbUDEzV4XqvdNyP9j77xYqT",
                            "metadata": {
                                "name": "Hamster",
                                "description": "Hamsters are beloved little creatures that have captured the hearts of many as popular pets.",
                                "image": "ipfs://Qmav2VYuawG5ii8hhWUD6HDpCg4CJrTk9NTGWhpyD1pEqW"
                            },
                            "lastOwner": "0x60927f9206c274f35922db263fd63451bbdb43a6"
                        }
                    },
                    {
                        "_id": "685_7225878_0x450eb206a7ad150ad532f42e017230207edd6dbd40998ea86f3c26c72cf1bde6_l2",
                        "logIndex": 2,
                        "fee": {
                            "from": "0x60927F9206C274f35922DB263Fd63451BBdb43a6",
                            "transferAmount": {
                                "bigNumber": "0x00",
                                "number": 0.0
                            },
                            "decimals": 18
                        },
                        "tags": [
                            "COIN",
                            "EVM"
                        ],
                        "related": [
                            "0x60927f9206c274f35922db263fd63451bbdb43a6"
                        ],
                        "type": "fee",
                        "time": 1704795735000,
                        "blockHash": "0x29f7b2f6858c51fe6bee55e4d9a6bb92f45989c6010ba6d6623589e3f3b79225",
                        "blockNum": 6936761,
                        "txnHash": "0x450eb206a7ad150ad532f42e017230207edd6dbd40998ea86f3c26c72cf1bde6",
                        "status": 1,
                        "bip44": "685",
                        "chainId": "7225878",
                        "ledger": {
                            "bigNumber": "0x00",
                            "number": "0",
                            "decimals": 18
                        }
                    }
                ],
                "scamTokens": [],
                "fee": {
                    "gasLimit": "500000",
                    "gasPrice": "0",
                    "gasUsed": "81580",
                    "maxFeePerGas": "0",
                    "maxPriorityFeePerGas": "0",
                    "effectiveGasPrice": "0",
                    "cumulativeGasUsed": "81580",
                    "amount": "0"
                }
            },
        ],
        "total": 242
    }
}

Get Token balances

curl --location 'https://ws-test.aag.ventures/api/verre/balances' \
--header 'x-api-key: partner-api-key'

Supported query params:

emails - Array of emails in String format.Only applicable for shared Saakuru integration
addresses - Array of Ethereum addresses in String format
contract - contract addresses in String format
chainIds - Array of chain Ids in Number format. Only if filtering is required
limit - Number of records
Page - Skip Number of pages

Response:

{
    "responseCode": "ok",
    "results": [
        {
            "currencyName": "Saakuru",
            "currencySymbol": "SKR",
            "image": {
                "thumb": "https://d1ndtm9ixfij9f.cloudfront.net/cryptoassetref/dogelon-mars/media/thumb.jpg",
                "small": "https://d1ndtm9ixfij9f.cloudfront.net/cryptoassetref/dogelon-mars/media/small.jpg",
                "large": "https://d1ndtm9ixfij9f.cloudfront.net/cryptoassetref/dogelon-mars/media/large.jpg"
            },
            "balance": "254409.859031173308560184",
            "verified": 1,
            "verifiedDate": 1708513301215,
            "assetRef": "saakuru-skr",
            "decimals": 18,
            "wallets": [
                {
                    "_id": "966_137_0x5b49bc2d9be5cb98fdbd414fdf152a719c22ebb1",
                    "address": "0x5b49bc2d9be5cb98fdbd414fdf152a719c22ebb1",
                    "chainId": "7225878",
                    "image": {
                        "thumb": "https://d1ndtm9ixfij9f.cloudfront.net/cryptoassetref/matic-network/media/thumb.png",
                        "small": "https://d1ndtm9ixfij9f.cloudfront.net/cryptoassetref/matic-network/media/small.png",
                        "large": "https://d1ndtm9ixfij9f.cloudfront.net/cryptoassetref/matic-network/media/large.png"
                    },
                    "balance": "254378.859031173308560184",
                    "hexBalance": "0x9b499c31b07dcf",
                    "updatedOn": 1708316650831,
                    "addressRegex": "^0x[a-fA-F0-9]{40}$",
                    "stakedBalance": "0",
                    "contractAddress": "0x40c288725051113aca6c800b43b95f37928466b8"
                },
                {
                    "_id": "966_137_0x5b49bc2d9be5cb98fdbd414fdf152a719c22ebb1",
                    "name": "Polygon (MATIC)",
                    "address": "0x5b49bc2d9be5cb98fdbd414fdf152a719c22ebb1",
                    "externalCurrencyId": "966",
                    "balance": "1",
                    "hexBalance": "0x9b499c31b07dcf",
                    "updatedOn": 1708316650831,
                    "addressRegex": "^0x[a-fA-F0-9]{40}$",
                    "stakedBalance": "0",
                    "contractAddress": "0xe0339c80ffde91f3e20494df88d4206d86024cdf"
                },       
            ],
            "price": "1.59963E-7"
        },
    ]
}

// coming soon

PreviousToken & NFT Data API NextCustom contract Events tracking

Last updated 2 months ago

Get transactions

Get Token balances

Subscribe to address transactions.