{"openapi":"3.0.0","paths":{"/":{"get":{"operationId":"HealthController_serviceMetadata","parameters":[],"responses":{"200":{"description":""}},"tags":["Health"]}},"/health":{"get":{"operationId":"HealthController_check","parameters":[],"responses":{"200":{"description":""}},"tags":["Health"]}},"/v1/dependencies":{"get":{"description":"Returns a list of apis that the Accounts API uses","operationId":"DependenciesController_getDependencies_v1","parameters":[],"responses":{"200":{"content":{"application/json":{"example":{"internalsApi":["primitives-api","tokens-api"]}}},"description":""}},"summary":"Accounts API internal API consumption","tags":["Dependencies","Dependencies"]}},"/metrics":{"get":{"operationId":"MonitoringController_getPrometheusMetrics","parameters":[],"responses":{"200":{"description":""}},"tags":["Monitoring"]}},"/health/readiness":{"get":{"description":"Returns the service readiness status.","operationId":"APIController_getReadinessState","parameters":[],"responses":{"200":{"content":{"application/json":{"example":{"status":"ok"}}},"description":""}},"summary":"Readiness check","tags":["API","Health"]}},"/v1/supportedNetworks":{"get":{"operationId":"APIController_getSupportedNetworks_v1","parameters":[],"responses":{"200":{"description":""}},"tags":["API"]}},"/v2/supportedNetworks":{"get":{"description":"Returns chains that are fully supported in `fullSupport` (available on all endpoints) and partially supported in `partialSupport` (not available on every endpoint). CAS-backed chains are included in `partialSupport`. For example, partially supported chains such as Solana are not supported on allowances, relationships, or transactions, unless the chain is routed to CAS.","operationId":"APIController_getSupportedNetworksV2_v2","parameters":[],"responses":{"200":{"schema":{"$ref":"#/components/schemas/SupportedNetworksV2Response"},"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportedNetworksV2Response"}}}}},"summary":"Get a list of fully and partially supported networks","tags":["API"]}},"/v1/users/{userId}/surveys":{"get":{"description":"Returns a list of surveys applicable for the given user id. If surveyId is provided, returns the survey details for the given survey if it apples to the user's id.","operationId":"APIController_getUserSurveys_v1","parameters":[{"name":"userId","required":true,"in":"path","schema":{"example":"0x1476d802833583607cd33cbb67404232efc6c7ce662c08607eea66fad45ecf01","type":"string"}},{"name":"surveyId","required":false,"in":"query","schema":{"example":1,"type":"number"}}],"responses":{"200":{"schema":{"$ref":"#/components/schemas/SurveyResponseDto"},"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SurveyResponseDto"}}}}},"summary":"Get a list of surveys for a user id","tags":["API","Users | Surveys"]}},"/v2/activeNetworks":{"get":{"description":"Returns the active networks across multiple account IDs","operationId":"AccountsController_getActiveNetworksByAccountIds_v2","parameters":[{"name":"accountIds","required":true,"in":"query","examples":{"ethereum":{"value":"eip155:1:0xab16a96D359eC26a11e2C2b3d8f8B8942d5Bfcdb,eip155:1:0x28C6c06298d514Db089934071355E5743bf21d60"},"solana":{"value":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:7S3P4HxJpyyigGzodYwHtCxZyUQe9JiBMHyRWXArAaKv"},"bitcoin":{"value":"bip122:000000000019d6689c085ae165831e93:128Lkh3S7CkDTBZ8W7BbpsN3YYizJMp8p6"},"tron":{"value":"tron:728126428:TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs"},"stellar":{"value":"stellar:pubnet:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"}},"description":"CAIP-10 Compliant Account IDs (comma-separated) [`namespace:reference:accountAddress`]","schema":{"type":"string"}},{"name":"filterMMListTokens","required":false,"in":"query","description":"Whether to filter MM list tokens","schema":{"type":"boolean"}},{"name":"networks","required":false,"in":"query","description":"Comma separated CAIP-2 network IDs","schema":{"default":"eip155:1,eip155:137,eip155:56,eip155:1329,eip155:43114,eip155:59144,eip155:8453,eip155:10,eip155:42161,eip155:143,eip155:999,eip155:4663,eip155:5042,eip155:50","example":"eip155:1,eip155:137"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActiveNetworksV2Model"}}}}},"summary":"Get active networks by CAIP-10 accounts IDs.","tags":["Accounts","Account"]}},"/v1/networks/{chainId}/transactions/{txHash}":{"get":{"description":"Returns at most one transaction with the provided transaction hash","operationId":"AccountsController_getTransactionByTxHash_v1","parameters":[{"name":"chainId","required":true,"in":"path","description":"Chain ID","schema":{"example":1,"type":"number"}},{"name":"txHash","required":true,"in":"path","description":"Transaction hash represented in hexadecimals","schema":{"example":"0x044743018554b5271d33932dc531bb97fb47785a8fcd3dd3a73f94ebd66e1ad8","type":"string"}},{"name":"includeLogs","required":false,"in":"query","schema":{"default":false},"description":"Whether or not to include logs in the output."},{"name":"includeValueTransfers","required":false,"in":"query","schema":{"default":false},"description":"Whether or not to include value transfers in the output."},{"name":"includeTxMetadata","required":false,"in":"query","schema":{"default":true},"description":"Whether or not to include transaction metadata in the output."},{"name":"lang","required":false,"in":"query","schema":{"default":"en"},"description":"The langauge which the transaction category will be represented in"}],"responses":{"200":{"schema":{"$ref":"#/components/schemas/TransactionByHashDto"},"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionByHashDto"}}}}},"summary":"Get a specific transaction by hash","tags":["Accounts","Transactions"]}},"/v5/accounts/{accountId}/transactions/{txId}":{"get":{"description":"Returns the transaction with the provided id for the CAIP-10 account (EVM and CAS-backed accounts), in the same shape as v5 multiaccount transactions.","operationId":"AccountsController_getTransactionByIdV5_v5","parameters":[{"name":"accountId","required":true,"in":"path","examples":{"ethereum":{"value":"eip155:1:0xab16a96D359eC26a11e2C2b3d8f8B8942d5Bfcdb"},"solana":{"value":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:7S3P4HxJpyyigGzodYwHtCxZyUQe9JiBMHyRWXArAaKv"},"bitcoin":{"value":"bip122:000000000019d6689c085ae165831e93:128Lkh3S7CkDTBZ8W7BbpsN3YYizJMp8p6"},"tron":{"value":"tron:728126428:TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs"},"stellar":{"value":"stellar:pubnet:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"}},"description":"CAIP-10 Compliant Account ID [`namespace:reference:accountAddress`]","schema":{"type":"string"}},{"name":"txId","required":true,"in":"path","description":"Transaction id (the transaction hash for EVM chains, the chain-native transaction id otherwise)","schema":{"example":"0x044743018554b5271d33932dc531bb97fb47785a8fcd3dd3a73f94ebd66e1ad8","type":"string"}},{"name":"includeTxMetadata","required":false,"in":"query","schema":{"default":false},"description":"Whether or not to include transaction metadata in the output."},{"name":"includeLogs","required":false,"in":"query","schema":{"default":false},"description":"Whether or not to include logs in the output."},{"name":"includeMiscOperations","required":false,"in":"query","schema":{"default":false},"description":"Whether or not to include miscellaneous operations (CAS-backed chains only)."},{"name":"lang","required":false,"in":"query","schema":{"default":"en"},"description":"The langauge which the transaction category will be represented in"}],"responses":{"200":{"schema":{"$ref":"#/components/schemas/GetTransactionByIdV5Dto"},"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTransactionByIdV5Dto"}}}},"400":{"description":"Invalid transaction id or unsupported chain"},"404":{"description":"Transaction not found for the account"}},"summary":"Get a specific transaction of an account by id","tags":["Accounts","Accounts | Fungible | Transactions"]}},"/v1/networks/{chainId}/accounts/{accountAddress}/relationships/{relationshipAddress}":{"get":{"description":"Returns the most recent transaction from accountAddress to relationshipAddress (or 204 No Content if no transaction exists)","operationId":"AccountsController_getAccountAddressRelationship_v1","parameters":[{"name":"chainId","required":true,"in":"path","description":"Chain ID","schema":{"example":1,"type":"number"}},{"name":"accountAddress","required":true,"in":"path","description":"Address of the user's account.","schema":{"example":"0x1db3439a222c519ab44bb1144fc28167b4fa6ee6","type":"string"}},{"name":"relationshipAddress","required":true,"in":"path","description":"Address to compare against the user's account address.","schema":{"example":"0xC5E9dDebb09Cd64DfaCab4011A0D5cEDaf7c9BDb","type":"string"}}],"responses":{"200":{"schema":{"$ref":"#/components/schemas/AccountAddressRelationshipDto"},"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountAddressRelationshipDto"}}}}},"summary":"Get the most recent transaction between two accounts","tags":["Accounts","Transactions"]}},"/v2/chains/{chainId}/accounts/{accountAddress}/relationships/{relationshipAddress}":{"get":{"description":"Returns whether two addresses on a chain have interacted, plus the latest transaction hash when they have. Solana is supported only when the chain is routed to CAS.","operationId":"AccountsController_getAccountAddressRelationshipV2_v2","parameters":[{"name":"chainId","required":true,"in":"path","examples":{"ethereum":{"value":"eip155:1"},"solana":{"value":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"},"bitcoin":{"value":"bip122:000000000019d6689c085ae165831e93"},"tron":{"value":"tron:728126428"},"stellar":{"value":"stellar:pubnet"}},"description":"CAIP-2 Compliant Chain ID [`namespace:reference`]","schema":{"type":"string"}},{"name":"accountAddress","required":true,"in":"path","description":"Address of the user's account.","schema":{"example":"0x1db3439a222c519ab44bb1144fc28167b4fa6ee6","type":"string"}},{"name":"relationshipAddress","required":true,"in":"path","description":"Address to compare against the user's account address.","schema":{"example":"0xC5E9dDebb09Cd64DfaCab4011A0D5cEDaf7c9BDb","type":"string"}}],"responses":{"200":{"schema":{"$ref":"#/components/schemas/AccountAddressRelationshipV2ResponseDto"},"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountAddressRelationshipV2ResponseDto"}}}}},"summary":"Check whether two accounts have interacted","tags":["Accounts","Transactions"]}},"/v1/accounts/{accountAddress}/transactions":{"get":{"description":"Returns transactions across multiple networks","operationId":"AccountsController_getAccountTransactionsByAccountAddress_v1","parameters":[{"name":"accountAddress","required":true,"in":"path","description":"Address of the user's account.","schema":{"example":"0x1db3439a222c519ab44bb1144fc28167b4fa6ee6","type":"string"}},{"name":"networks","required":false,"in":"query","schema":{"default":"1,137,56,1329,43114,59144,8453,10,42161,143,999,4663,5042,50"},"description":"Comma-separated network/chain IDs"},{"name":"startTimestamp","required":false,"in":"query","description":"Start timestamp (in epoch form) from which to return results.","schema":{"minimum":0,"example":1589134191}},{"name":"endTimestamp","required":false,"in":"query","description":"End timestamp (in epoch form) for which to return results.","schema":{"minimum":1,"example":1710526191}},{"name":"cursor","required":false,"in":"query","description":"JWT cursor to send as a start cursor of next set of balances","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximum number of transactions to return.","schema":{"minimum":1,"maximum":50,"default":20}},{"name":"sortDirection","required":false,"in":"query","description":"Sort direction","schema":{"default":"DESC","enum":["ASC","DESC"],"type":"string"}},{"name":"includeLogs","required":false,"in":"query","schema":{"default":false},"description":"Whether or not to include logs in the output."},{"name":"includeTxMetadata","required":false,"in":"query","schema":{"default":true},"description":"Whether or not to include transaction metadata in the output."},{"name":"lang","required":false,"in":"query","schema":{"default":"en"},"description":"The langauge which the transaction category will be represented in"},{"name":"assetIds","required":false,"in":"query","examples":{"ethereum":{"value":"eip155:1/erc20:0x06012c8cf97bead5deae237070f9587f8e7a266d,eip155:1/slip44:60"},"solana":{"value":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/token:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},"bitcoin":{"value":"bip122:12a765e31ffd4059bada1e25190f6e98/slip44:2"},"tron":{"value":"tron:728126428/trc20:TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8"},"stellar":{"value":"stellar:pubnet/asset:USDC-GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"}},"description":"CAIP-19 Compliant Asset IDs (comma-separated) [`namespace:reference/assetNamespace:assetReference/tokenId`]","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"pageInfo":{"count":2,"hasNextPage":true,"cursor":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyIxIjp7Imhhc05leHRQYWdlIjp0cnVlLCJsYXN0VGltZXN0YW1wIjoiMjAyNC0wNS0wMVQwNToxMDo1OS4wMDBaIn0sIjEzNyI6eyJoYXNOZXh0UGFnZSI6dHJ1ZSwibGFzdFRpbWVzdGFtcCI6IjIwMjQtMDQtMjBUMjE6NTI6MjUuMDAwWiJ9LCJpYXQiOjE3MTQ1NzQyNzZ9.Uke2rt5kKhE_0WpFCkTyvarylOq9dqKaqe19pyWeAX4"},"data":[{"hash":"0x9348458c82746b58399fad2bba929f02ae53b8fc9dbf556bdf8640f934f1b085","timestamp":"2024-05-01T05:16:59.000Z","chainId":1,"blockNumber":19773135,"blockHash":"0xc9069482b26a4da4860806f4499b8572e9dcd961be76c7b0f43b56bad3bc1ee8","gas":2692189,"gasUsed":2669833,"gasPrice":"5782189992","effectiveGasPrice":"5782189992","nonce":48,"cumulativeGasUsed":5232457,"methodId":"0x26ededb8","value":"0","to":"0x425417e20e201e4da452f81c84449ef4fe3d052b","from":"0xd9bd663592c2327d7de4d0f976150b9ac8bb50c2","isError":false,"valueTransfers":[{"from":"0xb68741b12adcd87dc4ff56d732205d6fafd10e77","to":"0x1db3439a222c519ab44bb1144fc28167b4fa6ee6","amount":"384364612716614","decimal":8,"contractAddress":"0x425417e20e201e4da452f81c84449ef4fe3d052b","symbol":"MEWING","name":"Mewing coin","transferType":"erc20"}],"logs":[{"data":"0x00000000000000000000000000000000000000000000000000015d93dc348846","topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x000000000000000000000000b68741b12adcd87dc4ff56d732205d6fafd10e77","0x000000000000000000000000c74b656bd2ebe313d26d1ac02bcf95b137d1c857"],"address":"0x425417e20e201e4da452f81c84449ef4fe3d052b","logIndex":66},{"data":"0x00000000000000000000000000000000000000000000000000015d93dc348846","topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x000000000000000000000000b68741b12adcd87dc4ff56d732205d6fafd10e77","0x00000000000000000000000035348ee6c587561d9c2c2ccc72623cc7c3d41351"],"address":"0x425417e20e201e4da452f81c84449ef4fe3d052b","logIndex":67}],"transactionType":"ERC_20_TRANSFER","transactionCategory":"TRANSFER","transactionProtocol":"ERC_20"},{"hash":"0x0eebc2ef05383ddf1d5d800b1ce4362905fffb1562e79443e14d78f4b53aa9d7","timestamp":"2024-05-01T05:10:59.000Z","chainId":1,"blockNumber":19773105,"blockHash":"0x97d63e0a75f78f78deba6f87b3d1f434ecca6cbb6f411afd8b48c883db9dfa06","gas":2692189,"gasUsed":2669833,"gasPrice":"5823454116","effectiveGasPrice":"5823454116","nonce":44,"cumulativeGasUsed":7503841,"methodId":"0x26ededb8","value":"0","to":"0xa37fd8ba1dd513c5409154a79af7cc2c303ed21f","from":"0xd9bd663592c2327d7de4d0f976150b9ac8bb50c2","isError":false,"valueTransfers":[{"from":"0x4580adf5b67cb9a2844ac46f1f41e7a3d37b3a73","to":"0x1db3439a222c519ab44bb1144fc28167b4fa6ee6","amount":"1887680591111869","decimal":8,"contractAddress":"0xa37fd8ba1dd513c5409154a79af7cc2c303ed21f","symbol":"Tesla AI","name":"Tesla AI","transferType":"erc20"}],"logs":[{"data":"0x0000000000000000000000000000000000000000000000000006b4d5e31526bd","topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x0000000000000000000000004580adf5b67cb9a2844ac46f1f41e7a3d37b3a73","0x000000000000000000000000c74b656bd2ebe313d26d1ac02bcf95b137d1c857"],"address":"0xa37fd8ba1dd513c5409154a79af7cc2c303ed21f","logIndex":73},{"data":"0x0000000000000000000000000000000000000000000000000006b4d5e31526bd","topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x0000000000000000000000004580adf5b67cb9a2844ac46f1f41e7a3d37b3a73","0x00000000000000000000000035348ee6c587561d9c2c2ccc72623cc7c3d41351"],"address":"0xa37fd8ba1dd513c5409154a79af7cc2c303ed21f","logIndex":74}],"transactionType":"ERC_20_TRANSFER","transactionCategory":"TRANSFER","transactionProtocol":"ERC_20"}]}}},"description":""}},"summary":"Get multi-network transactions","tags":["Accounts","Transactions"]}},"/v1/accounts/{accountAddress}/allowances":{"get":{"description":"Returns allowances across multiple networks for a given account address","operationId":"AccountsController_getAccountAllowancesByAccountAddress_v1","parameters":[{"name":"accountAddress","required":true,"in":"path","description":"Address of the user's account.","schema":{"example":"0x1db3439a222c519ab44bb1144fc28167b4fa6ee6","type":"string"}},{"name":"networks","required":false,"in":"query","schema":{"default":"1,137,56,1329,43114,59144,8453,10,42161,143,999,4663,5042,50"},"description":"Comma-separated network/chain IDs"}],"responses":{"200":{"content":{"application/json":{"example":{"accountAddress":"0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45","count":5,"data":[{"chainId":1,"contractAddress":"0x03ab458634910aad20ef5f1c8ee96f1d6ac54919","symbol":"RAI","name":"Rai Reflex Index","type":"erc20","decimal":18,"allowances":[{"spender":"0x0a5653cca4db1b6e265f47caf6969e64f1cfdc45","allowance":"12345678912312"},{"spender":"0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45","allowance":"12345678912312"},{"spender":"0x7a250d5630b4cf539739df2c5dacb4c659f2488d","allowance":"12345678912312"},{"spender":"0xabefabd03097732788d1870a416335298fe65cc8","allowance":"0"}]},{"chainId":1,"contractAddress":"0x0ba45a8b5d5575935b8158a88c631e9f9c95a2e5","symbol":"TT","name":"Tellor Tributes","type":"native","decimal":18,"allowances":[{"spender":"0x7a250d5630b4cf539739df2c5dacb4c659f2488d","allowance":"12345678912312"}]},{"chainId":1,"contractAddress":"0x1985365e9f78359a9b6ad760e32412f4a445e862","symbol":"REP","name":"Reputation Old","type":"native","decimal":18,"allowances":[{"spender":"0x0a5653cca4db1b6e265f47caf6969e64f1cfdc45","allowance":"12345678912312"}]},{"chainId":1,"contractAddress":"0x1f573d6fb3f13d689ff844b4ce37794d79a7ff1c","symbol":"BNT","name":"Bancor Network Token","type":"erc20","decimal":18,"allowances":[{"spender":"0x0a5653cca4db1b6e265f47caf6969e64f1cfdc45","allowance":"12345678912312"}]},{"chainId":1,"contractAddress":"0x3a9fff453d50d4ac52a6890647b823379ba36b9e","symbol":"SHUF","name":"Shuffle.Monster V3","type":"erc20","decimal":18,"allowances":[{"spender":"0x0a5653cca4db1b6e265f47caf6969e64f1cfdc45","allowance":"12345678912312"}]}]}}},"description":""}},"summary":"Get multi-network allowances","tags":["Accounts","Allowances"]}},"/v4/multiaccount/balances":{"get":{"description":"Returns a list of balances of multiple accounts across multiple networks (Evm only - through primitives-api)","operationId":"AccountsController_getMultiAccountBalances_v4","parameters":[{"name":"accountAddresses","required":true,"in":"query","description":"CAIP-10 addresses of the accounts for which to fetch data.","schema":{"example":"eip155:0:0x1db3439a222c519ab44bb1144fc28167b4fa6ee6,eip155:0:0x0c54FcCd2e384b4BB6f2E405Bf5Cbc15a017AaFb","type":"string"}},{"name":"networks","required":false,"in":"query","schema":{"default":"1,137,56,1329,43114,59144,8453,10,42161,143,999,4663,5042,50"},"description":"Comma-separated network/chain IDs"},{"name":"startTimestamp","required":false,"in":"query","description":"Start timestamp (in epoch form) from which to return results.","schema":{"minimum":0,"example":1589134191}},{"name":"endTimestamp","required":false,"in":"query","description":"End timestamp (in epoch form) for which to return results.","schema":{"minimum":1,"example":1710526191}},{"name":"filterSupportedTokens","required":false,"in":"query","schema":{"default":false},"description":"Whether or not to filter the assets to contain only the tokens existing in the Token API"}],"responses":{"200":{"content":{"application/json":{"example":{"count":4,"assets":[{"address":"0x0000000000000000000000000000000000000000","symbol":"ETH","name":"Ether","type":"native","timestamp":"2015-07-30T03:26:13.000Z","accountId":"eip155:1:0x1db3439a222c519ab44bb1144fc28167b4fa6ee6","decimals":18},{"address":"0x03ab458634910aad20ef5f1c8ee96f1d6ac54919","symbol":"RAI","name":"Rai Reflex Index","type":"erc20","timestamp":"2021-02-13T13:02:31.000Z","accountId":"eip155:1:0x1db3439a222c519ab44bb1144fc28167b4fa6ee6","decimals":18},{"address":"0x23b608675a2b2fb1890d3abbd85c5775c51691d5","symbol":"SOCKS","name":"Unisocks Edition 0","type":"erc20","timestamp":"2019-05-08T22:14:36.000Z","accountId":"eip155:1:0x1db3439a222c519ab44bb1144fc28167b4fa6ee6","decimals":18},{"address":"0x6b175474e89094c44da98b954eedeac495271d0f","symbol":"DAI","name":"Dai Stablecoin","type":"erc20","timestamp":"2019-11-13T19:17:57.000Z","accountId":"eip155:1:0x1db3439a222c519ab44bb1144fc28167b4fa6ee6","decimals":18}],"unprocessedNetworks":[]}}},"description":""}},"summary":"Get a list of balances of multiple accounts across multiple networks","tags":["Accounts","Account | Fungible"]}},"/v5/multiaccount/balances":{"get":{"description":"Returns a list of balances of multiple accounts across multiple networks (EVM, Solana, and CAS-backed accounts).","operationId":"AccountsController_getMultiAccountBalancesV2_v5","parameters":[{"name":"accountIds","required":true,"in":"query","examples":{"ethereum":{"value":"eip155:1:0xab16a96D359eC26a11e2C2b3d8f8B8942d5Bfcdb,eip155:1:0x28C6c06298d514Db089934071355E5743bf21d60"},"solana":{"value":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:7S3P4HxJpyyigGzodYwHtCxZyUQe9JiBMHyRWXArAaKv"},"bitcoin":{"value":"bip122:000000000019d6689c085ae165831e93:128Lkh3S7CkDTBZ8W7BbpsN3YYizJMp8p6"},"tron":{"value":"tron:728126428:TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs"},"stellar":{"value":"stellar:pubnet:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"}},"description":"CAIP-10 Compliant Account IDs (comma-separated) [`namespace:reference:accountAddress`]","schema":{"type":"string"}},{"name":"networks","required":false,"in":"query","schema":{"default":"eip155:1,eip155:137,eip155:56,eip155:1329,eip155:43114,eip155:59144,eip155:8453,eip155:10,eip155:42161,eip155:143,eip155:999,eip155:4663,eip155:5042,eip155:50"},"description":"Comma-separated CAIP-2 chain IDs"},{"name":"filterSupportedTokens","required":false,"in":"query","schema":{"default":true},"description":"Whether or not to filter the assets to contain only the tokens existing in the Token API"},{"name":"startTimestamp","required":false,"in":"query","description":"Start timestamp (in epoch form) from which to return results.","schema":{"minimum":0,"example":1589134191}},{"name":"endTimestamp","required":false,"in":"query","description":"End timestamp (in epoch form) for which to return results.","schema":{"minimum":1,"example":1710526191}},{"name":"includeLabels","required":false,"in":"query","schema":{"default":false},"description":"Whether or not to include asset metadata labels in the response"},{"name":"includeCanonicalHead","required":false,"in":"query","schema":{"default":false},"description":"Whether or not to include the canonical head assetId in the response"}],"responses":{"200":{"schema":{"$ref":"#/components/schemas/MultiAccountBalancesResponseDto"},"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultiAccountBalancesResponseDto"}}}}},"summary":"Get a list of balances of multiple accounts across multiple networks","tags":["Accounts","Account | Fungible"]}},"/v6/multiaccount/balances":{"get":{"description":"Returns a list of balances of multiple accounts across multiple networks (EVM, Solana, and CAS-backed accounts). Same as v5, with DeFi position support and additional query parameters.","operationId":"AccountsController_getMultiAccountBalancesV3_v6","parameters":[{"name":"accountIds","required":true,"in":"query","examples":{"ethereum":{"value":"eip155:1:0xab16a96D359eC26a11e2C2b3d8f8B8942d5Bfcdb,eip155:1:0x28C6c06298d514Db089934071355E5743bf21d60"},"solana":{"value":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:7S3P4HxJpyyigGzodYwHtCxZyUQe9JiBMHyRWXArAaKv"},"bitcoin":{"value":"bip122:000000000019d6689c085ae165831e93:128Lkh3S7CkDTBZ8W7BbpsN3YYizJMp8p6"},"tron":{"value":"tron:728126428:TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs"},"stellar":{"value":"stellar:pubnet:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"}},"description":"CAIP-10 Compliant Account IDs (comma-separated) [`namespace:reference:accountAddress`]","schema":{"type":"string"}},{"name":"networks","required":false,"in":"query","schema":{"default":"eip155:1,eip155:137,eip155:56,eip155:1329,eip155:43114,eip155:59144,eip155:8453,eip155:10,eip155:42161,eip155:143,eip155:999,eip155:4663,eip155:5042,eip155:50"},"description":"Comma-separated CAIP-2 chain IDs"},{"name":"filterSupportedTokens","required":false,"in":"query","schema":{"default":true},"description":"Whether or not to filter the assets to contain only the tokens existing in the Token API"},{"name":"startTimestamp","required":false,"in":"query","description":"Start timestamp (in epoch form) from which to return results.","schema":{"minimum":0,"example":1589134191}},{"name":"endTimestamp","required":false,"in":"query","description":"End timestamp (in epoch form) for which to return results.","schema":{"minimum":1,"example":1710526191}},{"name":"includeLabels","required":false,"in":"query","schema":{"default":false},"description":"Whether or not to include asset metadata labels in the response"},{"name":"includeCanonicalHead","required":false,"in":"query","schema":{"default":false},"description":"Whether or not to include the canonical head assetId in the response"},{"name":"includeDeFiBalances","required":false,"in":"query","schema":{"default":false},"description":"When true, includes DeFi balances(positions) from DeFi API in the response. Token balances are always returned."},{"name":"forceFetchDeFiPositions","required":false,"in":"query","schema":{"default":false},"description":"When true (and includeDeFiBalances is true), the DeFi API is called with an additional parameter indicating that the latest positions should be fetched from the upstream provider, bypassing any cached positions."},{"name":"includePrices","required":false,"in":"query","schema":{"default":false},"description":"When true, fetches spot prices from the Price API for each token in balances (see `vsCurrency`)."},{"name":"vsCurrency","required":false,"in":"query","schema":{"default":"usd","enum":["btc","eth","ltc","bch","bnb","eos","xrp","xlm","link","dot","yfi","sol","usd","aed","ars","aud","bdt","bhd","bmd","brl","cad","chf","clp","cny","czk","dkk","eur","gbp","gel","hkd","huf","idr","ils","inr","jpy","krw","kwd","lkr","mmk","mxn","myr","ngn","nok","nzd","php","pkr","pln","rub","sar","sek","sgd","thb","try","twd","uah","vef","vnd","zar","xdr","xag","xau","bits","sats"]},"description":"Quote currency for spot prices when `includePrices` is true. Defaults to `usd`."},{"name":"includeAssetIds","required":false,"in":"query","description":"Optional CAIP-19 asset IDs (comma-separated) to pin into the balances snapshot. Matching EVM ERC-20s and native slip44 assets are force-fetched and always returned in `balances` for the requested accounts, including when the balance is `0`. For Solana, matching tokens are force-fetched upstream via sol-primitives (including zero balances), or forwarded to Activity/CAS as `includeAssetIds` when the chain is routed to CAS. For Activity-backed chains, matching IDs are forwarded to Activity/CAS as `includeAssetIds`; IDs not found in returned balances are listed in `unprocessedIncludeAssetIds`. Malicious assets that would otherwise be filtered are kept when listed here. IDs that also appear in `excludeAssetIds` are dropped from includes before any backend fetch (exclude wins).","schema":{"example":"eip155:1/erc20:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2,solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/token:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","type":"string"}},{"name":"excludeAssetIds","required":false,"in":"query","description":"Changes balance results. For EVM, ERC-20 CAIP-19 asset IDs are removed from the lookup before balances are refreshed (natives ignored). For Solana, matching CAIP-19 asset IDs are omitted upstream via sol-primitives, or forwarded to Activity/CAS as `excludeAssetIds` when the chain is routed to CAS. For Activity-backed chains, matching CAIP-19 asset IDs are forwarded to Activity/CAS as `excludeAssetIds` and also omitted from `balances` after fetch. Takes precedence over `includeAssetIds` for the same token. Comma-separated in the query string.","schema":{"example":"eip155:1/erc20:0x40d16fc0246ad3160ccc09b8d0d3a2cd28ae6c2f,eip155:1/erc20:0x6b3595068778dd592e39a122f4f5a5cf09c90fe2,eip155:1/erc20:0xae7ab96520de3a18e5e111b5eaab095312d7fe84","type":"string"}}],"responses":{"200":{"schema":{"$ref":"#/components/schemas/MultiAccountBalancesV3ResponseDto"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultiAccountBalancesV3ResponseDto"}}},"description":""}},"summary":"Get a list of balances and DeFi positions of multiple accounts across multiple networks","tags":["Accounts","Account | Fungible"]}},"/v1/multiaccount/stats":{"get":{"description":"Returns per-account activity stats (transfers, gas spent, oldest received/spent) for the requested accounts. For eip155 accounts, enriches stats with `topSpentAssets` and `topReceivedAssets` for the top 10 sent/received contracts by market cap (from cached price-api top tokens). Unsupported accounts are listed in `unprocessedAccounts`. Inactive or high-volume accounts are listed in `inactiveOrHighVolumeAccounts`.","operationId":"AccountsController_getMultiAccountStats_v1","parameters":[{"name":"accountIds","required":true,"in":"query","examples":{"ethereum":{"value":"eip155:1:0xab16a96D359eC26a11e2C2b3d8f8B8942d5Bfcdb,eip155:1:0x28C6c06298d514Db089934071355E5743bf21d60"},"solana":{"value":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:7S3P4HxJpyyigGzodYwHtCxZyUQe9JiBMHyRWXArAaKv"},"bitcoin":{"value":"bip122:000000000019d6689c085ae165831e93:128Lkh3S7CkDTBZ8W7BbpsN3YYizJMp8p6"},"tron":{"value":"tron:728126428:TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs"},"stellar":{"value":"stellar:pubnet:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"}},"description":"CAIP-10 Compliant Account IDs (comma-separated) [`namespace:reference:accountAddress`]","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultiAccountStatsModel"}}}}},"summary":"Get account stats by CAIP-10 account IDs","tags":["Accounts","Account | Stats"]}},"/v4/multiaccount/transactions":{"get":{"description":"Returns a list of transactions of multiple accounts across multiple networks (EVM only - through primitives-api).","operationId":"AccountsController_getMultiAccountTransactions_v4","parameters":[{"name":"accountAddresses","required":true,"in":"query","description":"CAIP-10 addresses of the accounts for which to fetch data.","schema":{"example":"eip155:0:0x1db3439a222c519ab44bb1144fc28167b4fa6ee6,eip155:0:0x0c54FcCd2e384b4BB6f2E405Bf5Cbc15a017AaFb","type":"string"}},{"name":"startTimestamp","required":false,"in":"query","description":"Start timestamp (in epoch form) from which to return results.","schema":{"minimum":0,"example":1589134191}},{"name":"endTimestamp","required":false,"in":"query","description":"End timestamp (in epoch form) for which to return results.","schema":{"minimum":1,"example":1710526191}},{"name":"limit","required":false,"in":"query","description":"Maximum number of transactions to return.","schema":{"minimum":1,"maximum":50,"default":20}},{"name":"after","required":false,"in":"query","description":"A JWT containing the endCursor information for the query.","schema":{"type":"string"}},{"name":"before","required":false,"in":"query","description":"A JWT containing the startCursor information for the query.","schema":{"type":"string"}},{"name":"sortDirection","required":false,"in":"query","description":"Sort direction","schema":{"default":"DESC","enum":["ASC","DESC"],"type":"string"}},{"name":"networks","required":false,"in":"query","description":"Comma separated CAIP-2 network IDs","schema":{"default":"eip155:1,eip155:137,eip155:56,eip155:1329,eip155:43114,eip155:59144,eip155:8453,eip155:10,eip155:42161,eip155:143,eip155:999,eip155:4663,eip155:5042,eip155:50","example":"eip155:1,eip155:137"}},{"name":"includeLogs","required":false,"in":"query","schema":{"default":false},"description":"Whether or not to include logs in the output."},{"name":"includeTxMetadata","required":false,"in":"query","schema":{"default":false},"description":"Whether or not to include transaction metadata in the output."},{"name":"maxLogsPerTx","required":false,"in":"query","description":"Maximum number of logs to return per transaction.","schema":{"minimum":1,"default":50,"example":50}},{"name":"lang","required":false,"in":"query","schema":{"default":"en"},"description":"The langauge which the transaction category will be represented in"},{"name":"assetIds","required":false,"in":"query","examples":{"ethereum":{"value":"eip155:1/erc20:0x06012c8cf97bead5deae237070f9587f8e7a266d,eip155:1/slip44:60"},"solana":{"value":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/token:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},"bitcoin":{"value":"bip122:12a765e31ffd4059bada1e25190f6e98/slip44:2"},"tron":{"value":"tron:728126428/trc20:TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8"},"stellar":{"value":"stellar:pubnet/asset:USDC-GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"}},"description":"CAIP-19 Compliant Asset IDs (comma-separated) [`namespace:reference/assetNamespace:assetReference/tokenId`]","schema":{"type":"string"}},{"name":"filterSupportedTokens","required":false,"in":"query","schema":{"default":false},"description":"When true, drop transactions whose ERC-20 transfers are not in the Token API (tokensService). Applied in accounts-api. CAS is always called with includeAllAssets=true."},{"name":"filterIncomingTransfers","required":false,"in":"query","schema":{"default":true},"description":"When true, drop a transaction only when every value transfer is paid to a watched account. Swaps are kept. Forwarded to Primitives as excludeIncomingTransfers; also applied locally (e.g. CAS)."},{"name":"filterSpamTokens","required":false,"in":"query","schema":{"default":true},"description":"When true, drop transactions whose transactionProtocol is SPAM_TOKEN or SPAM. May trigger upstream refetches to fill the page."}],"responses":{"200":{"schema":{"$ref":"#/components/schemas/GetMultiAccountNetworkTransactionsDto"},"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetMultiAccountNetworkTransactionsDto"}}}}},"summary":"Get a list of transactions of multiple accounts across multiple networks","tags":["Accounts","Accounts | Fungible | Transactions"]}},"/v5/multiaccount/transactions":{"get":{"description":"Returns a list of transactions of multiple accounts across multiple networks (EVM and CAS-backed accounts).","operationId":"AccountsController_getMultiAccountTransactionsV5_v5","parameters":[{"name":"accountIds","required":false,"in":"query","examples":{"ethereum":{"value":"eip155:1:0xab16a96D359eC26a11e2C2b3d8f8B8942d5Bfcdb,eip155:1:0x28C6c06298d514Db089934071355E5743bf21d60"},"solana":{"value":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:7S3P4HxJpyyigGzodYwHtCxZyUQe9JiBMHyRWXArAaKv"},"bitcoin":{"value":"bip122:000000000019d6689c085ae165831e93:128Lkh3S7CkDTBZ8W7BbpsN3YYizJMp8p6"},"tron":{"value":"tron:728126428:TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs"},"stellar":{"value":"stellar:pubnet:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"}},"description":"CAIP-10 Compliant Account IDs (comma-separated) [`namespace:reference:accountAddress`]","schema":{"type":"string"}},{"name":"networks","required":false,"in":"query","schema":{"default":"eip155:1,eip155:137,eip155:56,eip155:1329,eip155:43114,eip155:59144,eip155:8453,eip155:10,eip155:42161,eip155:143,eip155:999,eip155:4663,eip155:5042,eip155:50"},"description":"Comma-separated CAIP-2 chain IDs"},{"name":"startTimestamp","required":false,"in":"query","description":"Start timestamp (in epoch form) from which to return results.","schema":{"minimum":0,"example":1589134191}},{"name":"endTimestamp","required":false,"in":"query","description":"End timestamp (in epoch form) for which to return results.","schema":{"minimum":1,"example":1710526191}},{"name":"limit","required":false,"in":"query","description":"Maximum number of transactions to return.","schema":{"minimum":1,"maximum":50,"default":20}},{"name":"after","required":false,"in":"query","description":"A JWT containing the endCursor information for the query.","schema":{"type":"string"}},{"name":"sortDirection","required":false,"in":"query","description":"Sort direction","schema":{"default":"DESC","enum":["ASC","DESC"],"type":"string"}},{"name":"includeTxMetadata","required":false,"in":"query","schema":{"default":false},"description":"Whether or not to include transaction metadata in the output."},{"name":"includeLogs","required":false,"in":"query","schema":{"default":false},"description":"Whether or not to include logs in the output."},{"name":"maxLogsPerTx","required":false,"in":"query","schema":{"default":50},"description":"Maximum number of logs to include per transaction"},{"name":"lang","required":false,"in":"query","schema":{"default":"en"},"description":"The langauge which the transaction category will be represented in"},{"name":"assetIds","required":false,"in":"query","examples":{"ethereum":{"value":"eip155:1/erc20:0x06012c8cf97bead5deae237070f9587f8e7a266d,eip155:1/slip44:60"},"solana":{"value":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/token:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},"bitcoin":{"value":"bip122:12a765e31ffd4059bada1e25190f6e98/slip44:2"},"tron":{"value":"tron:728126428/trc20:TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8"},"stellar":{"value":"stellar:pubnet/asset:USDC-GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"}},"description":"CAIP-19 Compliant Asset IDs (comma-separated) [`namespace:reference/assetNamespace:assetReference/tokenId`]","schema":{"type":"string"}},{"name":"filterSupportedTokens","required":false,"in":"query","schema":{"default":false},"description":"When true, drop transactions whose ERC-20 transfers are not in the Token API (tokensService). Applied in accounts-api. CAS is always called with includeAllAssets=true."},{"name":"filterIncomingTransfers","required":false,"in":"query","schema":{"default":true},"description":"When true, drop a transaction only when every value transfer is paid to a watched account. Swaps are kept. Forwarded to Primitives as excludeIncomingTransfers; also applied locally (e.g. CAS)."},{"name":"filterSpamTokens","required":false,"in":"query","schema":{"default":true},"description":"When true, drop transactions whose transactionProtocol is SPAM_TOKEN or SPAM. May trigger upstream refetches to fill the page."}],"responses":{"200":{"schema":{"$ref":"#/components/schemas/GetMultiAccountNetworkTransactionsV5Dto"},"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetMultiAccountNetworkTransactionsV5Dto"}}}}},"summary":"Get a list of transactions of multiple accounts across multiple networks","tags":["Accounts","Accounts | Fungible | Transactions"]}},"/v1/metadata":{"get":{"description":"Returns the address labels metadata by CAIP-10 account ID.","operationId":"AccountsController_getAddressLabelsMetadata_v1","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelsMetadataModel"}}}}},"summary":"Get address labels metadata","tags":["Accounts","Account | Metadata"]}}},"info":{"title":"Accounts API","description":"API for fetching address metadata from addresses on EVM Networks","version":"v0.0.1","contact":{}},"tags":[{"name":"Health","description":"System Health Endpoints"}],"servers":[{"url":"https://accounts.dev-api.cx.metamask.io/","description":"Development instance"},{"url":"https://accounts.uat-api.cx.metamask.io/","description":"UAT instance"},{"url":"https://accounts.api.cx.metamask.io/","description":"Production instance"},{"url":"http://localhost:3000/","description":"Local instance"}],"components":{"schemas":{"SupportedNetworksV2Response":{"type":"object","properties":{"fullSupport":{"readOnly":true,"example":["eip155:1","eip155:137"],"type":"array","items":{"type":"string"}},"partialSupport":{"readOnly":true,"example":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","tron:728126428"],"type":"array","items":{"type":"string"}}},"required":["fullSupport","partialSupport"]},"SurveyDto":{"type":"object","properties":{"surveyId":{"type":"number","readOnly":true,"example":1},"link":{"type":"string","readOnly":true,"example":"https://example.com/survey/1"},"description":{"type":"string","readOnly":true,"example":"What can we do better? Share your thoughts and opt in to paid interviews."},"cta":{"type":"string","readOnly":true,"example":"Take survey"},"content":{"type":"string","readOnly":true,"example":"Share your thoughts and opt in to paid interviews."}},"required":["surveyId","link","description","cta","content"]},"SurveyResponseDto":{"type":"object","properties":{"userId":{"type":"string","readOnly":true,"example":"0x1476d802833583607cd33cbb67404232efc6c7ce662c08607eea66fad45ecf01"},"surveys":{"readOnly":true,"allOf":[{"$ref":"#/components/schemas/SurveyDto"}]}},"required":["userId","surveys"]},"ActiveNetworksV2Model":{"type":"object","properties":{"activeNetworks":{"readOnly":true,"example":["eip155:1:0x5197b5b062288bbf29008c92b08010a92dd677cd","eip155:1:0x1db3439a222c519ab44bb1144fc28167b4fa6ee6","eip155:56:0x5197b5b062288bbf29008c92b08010a92dd677cd","eip155:56:0x1db3439a222c519ab44bb1144fc28167b4fa6ee6"],"type":"array","items":{"type":"string"}}},"required":["activeNetworks"]},"TransactionByHashDataDto":{"type":"object","properties":{"hash":{"type":"string","readOnly":true,"example":"0x044743018554b5271d33932dc531bb97fb47785a8fcd3dd3a73f94ebd66e1ad8"},"timestamp":{"format":"date-time","type":"string","readOnly":true,"example":"2020-03-06T00:13:12.000Z"},"chainId":{"type":"number","readOnly":true,"example":1},"blockNumber":{"type":"string","readOnly":true,"example":"9614324"},"blockHash":{"type":"string","readOnly":true,"example":"0x8a3347b23d01448a97a1524069a11df284942bf6547fe9c698085287b0b4cb45"},"gas":{"type":"number","readOnly":true,"example":309103},"gasUsed":{"type":"number","readOnly":true,"example":255033},"gasPrice":{"type":"string","readOnly":true,"example":"2000000000"},"effectiveGasPrice":{"type":"number","readOnly":true,"example":"2000000000"},"nonce":{"type":"number","readOnly":true,"example":1373},"cumulativeGasUsed":{"type":"number","readOnly":true,"example":5871873},"methodId":{"type":"string","readOnly":true,"example":"2020-03-06T00:13:12.000Z"},"value":{"type":"string","readOnly":true,"example":"0"},"to":{"type":"string","readOnly":true,"example":"0xa2881a90bf33f03e7a3f803765cd2ed5c8928dfb"},"from":{"type":"string","readOnly":true,"example":"0xaf4774798b5a9c6f831cae5e56d8b12d25ae3972"}},"required":["hash","timestamp","chainId","blockNumber","blockHash","gas","gasUsed","gasPrice","effectiveGasPrice","nonce","cumulativeGasUsed","methodId","value","to","from"]},"TransactionByHashDto":{"type":"object","properties":{"txHash":{"type":"string","readOnly":true,"example":"0x044743018554b5271d33932dc531bb97fb47785a8fcd3dd3a73f94ebd66e1ad8"},"chainId":{"type":"number","readOnly":true,"example":1},"count":{"type":"number","readOnly":true,"example":1},"data":{"readOnly":true,"allOf":[{"$ref":"#/components/schemas/TransactionByHashDataDto"}]}},"required":["txHash","chainId","count","data"]},"TransactionsV5TxDto":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"8d0f..."},"chainId":{"type":"string","readOnly":true,"example":"stellar:pubnet"},"status":{"type":"string","readOnly":true,"example":"confirmed"},"timestamp":{"type":"number","readOnly":true,"example":1714440000000},"date":{"type":"string","readOnly":true,"example":"2024-04-30T01:20:00.000Z"},"from":{"type":"string","readOnly":true,"example":"GABC..."},"to":{"type":"string","readOnly":true,"example":"GDEF..."},"blockNumber":{"type":"string","readOnly":true,"example":"50123456"},"blockHash":{"type":"string","readOnly":true,"example":"0xabc..."},"nonce":{"type":"string","readOnly":true,"example":"42"},"value":{"type":"string","readOnly":true,"example":"0"},"methodId":{"type":"string","readOnly":true,"example":"0xa9059cbb"},"operationCount":{"type":"number","readOnly":true,"example":1},"memo":{"type":"string","readOnly":true,"example":"payment-12345"},"transactionType":{"type":"string","readOnly":true,"example":"GENERIC_CONTRACT_CALL"},"transactionCategory":{"type":"string","readOnly":true,"example":"CONTRACT_CALL"},"transactionProtocol":{"type":"string","readOnly":true,"example":"ERC_20"},"readable":{"type":"string","readOnly":true,"example":"Unidentified Transaction"},"readableExtended":{"type":"string","readOnly":true,"example":"Unidentified Transaction"}},"required":["id","chainId","status","timestamp","date","from","to","blockNumber","blockHash","nonce","value","methodId","operationCount","memo","transactionType","transactionCategory","transactionProtocol","readable","readableExtended"]},"TransactionsV5ValueTransferDto":{"type":"object","properties":{"assetClass":{"type":"string","readOnly":true,"example":"ft"},"from":{"type":"string","readOnly":true,"example":"GABC..."},"to":{"type":"string","readOnly":true,"example":"GDEF..."},"assetId":{"type":"string","readOnly":true,"example":"stellar:pubnet/slip44:148"},"amount":{"type":"string","readOnly":true,"example":"10000000"},"decimal":{"type":"number","readOnly":true,"example":7},"symbol":{"type":"string","readOnly":true,"example":"XLM"},"name":{"type":"string","readOnly":true,"example":"Stellar Lumens"},"tokenId":{"type":"string","readOnly":true,"example":"1"}},"required":["assetClass","from","to","assetId","amount","decimal","symbol","name","tokenId"]},"TransactionsV5MiscOperationDto":{"type":"object","properties":{"type":{"type":"string","readOnly":true,"example":"trustlineUpdate"},"assetId":{"type":"string","readOnly":true,"example":"stellar:pubnet/asset:USDC-G..."}},"required":["type","assetId"]},"TransactionsV5LogDto":{"type":"object","properties":{"data":{"type":"string","readOnly":true,"example":"0x000000000000000000000000000000000000000000000000002e63d745481782"},"topics":{"readOnly":true,"example":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"],"type":"array","items":{"type":"string"}},"address":{"type":"string","readOnly":true,"example":"0xa37fd8ba1dd513c5409154a79af7cc2c303ed21f"},"logIndex":{"type":"number","readOnly":true,"example":350}},"required":["data","topics","address","logIndex"]},"TransactionsV5FeeAssetDto":{"type":"object","properties":{"assetId":{"type":"string","readOnly":true,"example":"stellar:pubnet/slip44:148"},"amount":{"type":"string","readOnly":true,"example":"100"},"decimals":{"type":"number","readOnly":true,"example":7},"symbol":{"type":"string","readOnly":true,"example":"XLM"}},"required":["assetId","amount","decimals","symbol"]},"TransactionsV5FeeDto":{"type":"object","properties":{"payer":{"type":"string","readOnly":true,"example":"stellar:pubnet:GABC..."},"asset":{"readOnly":true,"allOf":[{"$ref":"#/components/schemas/TransactionsV5FeeAssetDto"}]},"unitsConsumed":{"type":"number","readOnly":true,"example":1},"unitPrice":{"type":"string","readOnly":true,"example":"100"},"baseFee":{"type":"string","readOnly":true,"example":"18000000000"},"priorityFee":{"type":"string","readOnly":true,"example":"2000000000"},"stroops":{"type":"number","readOnly":true,"example":100}},"required":["payer","asset","unitsConsumed","unitPrice","baseFee","priorityFee","stroops"]},"TransactionsV5RecordDto":{"type":"object","properties":{"accountId":{"type":"string","readOnly":true,"example":"stellar:pubnet:GABC..."},"tx":{"readOnly":true,"allOf":[{"$ref":"#/components/schemas/TransactionsV5TxDto"}]},"valueTransfers":{"readOnly":true,"type":"array","items":{"$ref":"#/components/schemas/TransactionsV5ValueTransferDto"}},"miscOperations":{"readOnly":true,"type":"array","items":{"$ref":"#/components/schemas/TransactionsV5MiscOperationDto"}},"logs":{"readOnly":true,"type":"array","items":{"$ref":"#/components/schemas/TransactionsV5LogDto"}},"fee":{"readOnly":true,"allOf":[{"$ref":"#/components/schemas/TransactionsV5FeeDto"}]}},"required":["accountId","tx","valueTransfers","miscOperations","logs","fee"]},"GetTransactionByIdV5Dto":{"type":"object","properties":{"data":{"readOnly":true,"allOf":[{"$ref":"#/components/schemas/TransactionsV5RecordDto"}]}},"required":["data"]},"AccountAddressRelationshipDataDto":{"type":"object","properties":{"hash":{"type":"string","readOnly":true,"example":"0x044743018554b5271d33932dc531bb97fb47785a8fcd3dd3a73f94ebd66e1ad8"},"timestamp":{"format":"date-time","type":"string","readOnly":true,"example":"2020-03-06T00:13:12.000Z"},"chainId":{"type":"number","readOnly":true,"example":1},"blockNumber":{"type":"string","readOnly":true,"example":"9614324"},"blockHash":{"type":"string","readOnly":true,"example":"0x8a3347b23d01448a97a1524069a11df284942bf6547fe9c698085287b0b4cb45"},"gas":{"type":"number","readOnly":true,"example":309103},"gasUsed":{"type":"number","readOnly":true,"example":255033},"gasPrice":{"type":"string","readOnly":true,"example":"2000000000"},"effectiveGasPrice":{"type":"number","readOnly":true,"example":"2000000000"},"nonce":{"type":"number","readOnly":true,"example":1373},"cumulativeGasUsed":{"type":"number","readOnly":true,"example":5871873},"methodId":{"type":"string","readOnly":true,"example":"2020-03-06T00:13:12.000Z"},"value":{"type":"string","readOnly":true,"example":"0"},"to":{"type":"string","readOnly":true,"example":"0xa2881a90bf33f03e7a3f803765cd2ed5c8928dfb"},"from":{"type":"string","readOnly":true,"example":"0xaf4774798b5a9c6f831cae5e56d8b12d25ae3972"}},"required":["hash","timestamp","chainId","blockNumber","blockHash","gas","gasUsed","gasPrice","effectiveGasPrice","nonce","cumulativeGasUsed","methodId","value","to","from"]},"AccountAddressRelationshipDto":{"type":"object","properties":{"txHash":{"type":"string","readOnly":true,"example":"0x044743018554b5271d33932dc531bb97fb47785a8fcd3dd3a73f94ebd66e1ad8"},"chainId":{"type":"number","readOnly":true,"example":1},"count":{"type":"number","readOnly":true,"example":1},"data":{"readOnly":true,"allOf":[{"$ref":"#/components/schemas/AccountAddressRelationshipDataDto"}]}},"required":["txHash","chainId","count","data"]},"AccountAddressRelationshipV2ResponseDto":{"type":"object","properties":{"hasInteracted":{"type":"boolean","readOnly":true,"example":true},"recentTx":{"type":"string","readOnly":true,"example":"0xe4f2e2b41e49339b581d8df67979ccc8521a9c7acfbaefee3789321e58264ec1"}},"required":["hasInteracted","recentTx"]},"MultiAccountBalancesDataResponseDto":{"type":"object","properties":{"accountId":{"type":"string","readOnly":true,"example":"eip155:1:0xdbd47f66aa2f00b3db03397f260ce9728298c495"},"assetId":{"type":"string","readOnly":true,"example":"eip155:1/erc20:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},"balance":{"type":"string","readOnly":true,"example":"0.283549083429656057"},"decimals":{"type":"number","readOnly":true,"example":18},"name":{"type":"string","readOnly":true,"example":"Wrapped Ether"},"object":{"type":"string","readOnly":true,"example":"token"},"symbol":{"type":"string","readOnly":true,"example":"WETH"},"type":{"type":"string","readOnly":true,"example":"erc20"},"canonicalHead":{"type":"string","readOnly":true,"example":"eip155:1/slip44:60"},"labels":{"readOnly":true,"example":["blue_chip"],"type":"array","items":{"type":"string"}},"securityResultType":{"type":"string","enum":["Verified","Benign","Warning","Malicious"],"example":"Verified","description":"Token security classification from token-api when available. Rows with `Malicious` are omitted from the response."},"metadata":{"type":"object","readOnly":true,"example":{"limit":"9223372036854775807","authorized":true}}},"required":["accountId","assetId","balance","decimals","name","object","symbol","type","canonicalHead","labels","metadata"]},"MultiAccountBalancesResponseDto":{"type":"object","properties":{"count":{"type":"number","readOnly":true,"example":1},"unprocessedNetworks":{"readOnly":true,"example":["eip155:1329"],"type":"array","items":{"type":"string"}},"balances":{"readOnly":true,"allOf":[{"$ref":"#/components/schemas/MultiAccountBalancesDataResponseDto"}]}},"required":["count","unprocessedNetworks","balances"]},"BalanceMetadataV3ResponseDto":{"type":"object","properties":{"protocolId":{"type":"string","readOnly":true,"example":"metamask"},"productName":{"type":"string","readOnly":true,"example":"MetaMask Swaps"},"description":{"type":"string","readOnly":true,"example":"MetaMask Swaps on ethereum"},"protocolUrl":{"type":"string","readOnly":true,"example":"https://metamask.io/"},"protocolIconUrl":{"type":"string","readOnly":true,"example":"https://protocol-icons.s3.amazonaws.com/icons/metamask-swaps.jpg"},"positionType":{"type":"string","readOnly":true,"example":"deposit"},"poolAddress":{"type":"string","readOnly":true,"example":"0x4fef9d741011476750a243ac70b9789a63dd47df"},"groupId":{"type":"string","readOnly":true,"example":"01059f1cd1f4a1d40f197077ed6e3cceca16958989c4d6b76b38fb0ebe23a5f8"}},"required":["protocolId","productName","description","protocolUrl","protocolIconUrl","positionType","poolAddress","groupId"]},"BalanceV3ResponseDto":{"type":"object","properties":{"accountId":{"type":"string","readOnly":true,"example":"eip155:1:0xdbd47f66aa2f00b3db03397f260ce9728298c495"},"object":{"type":"string","readOnly":true,"enum":["token","defi"],"example":"token"},"type":{"type":"string","example":"erc20","description":"Asset kind. Token rows pass through upstream (`native`/`erc20`/`spl`/`token`). DeFi rows are `native` or `erc20` derived from the CAIP-19 asset id."},"assetId":{"type":"string","readOnly":true,"example":"eip155:1/erc20:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},"name":{"type":"string","readOnly":true,"example":"Wrapped Ether"},"symbol":{"type":"string","readOnly":true,"example":"WETH"},"decimals":{"type":"number","readOnly":true,"example":18},"balance":{"type":"string","readOnly":true,"example":"0.283549083429656057"},"price":{"type":"string","readOnly":true,"example":"2119.66"},"securityResultType":{"type":"string","enum":["Verified","Benign","Warning","Malicious"],"example":"Verified","description":"Token security classification from token-api when available. Rows with `Malicious` are omitted unless the asset is listed in `includeAssetIds`."},"labels":{"readOnly":true,"example":["blue_chip"],"type":"array","items":{"type":"string"}},"canonicalHead":{"type":"string","readOnly":true,"example":"eip155:1/slip44:60"},"metadata":{"description":"DeFi protocol metadata for `object: defi` rows; Stellar trustline metadata (e.g. limit, authorized) for token rows.","oneOf":[{"$ref":"#/components/schemas/BalanceMetadataV3ResponseDto"},{"type":"object","additionalProperties":true}]}},"required":["accountId","object","type","assetId","name","symbol","decimals","balance","price","labels","canonicalHead"]},"MultiAccountBalancesV3ResponseDto":{"type":"object","properties":{"balances":{"type":"array","items":{"$ref":"#/components/schemas/BalanceV3ResponseDto"}},"unprocessedNetworks":{"readOnly":true,"example":["eip155:1329"],"type":"array","items":{"type":"string"}},"unprocessedIncludeAssetIds":{"example":["eip155:1/erc20:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/token:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"],"description":"IDs from `includeAssetIds` that the backend could not resolve or for which the balance check failed. Successfully resolved EVM ERC-20 and native slip44 includes — including zero balances — are omitted. Solana IDs unresolved by sol-primitives are returned from upstream `unprocessedAssetIds` (when the chain is routed to CAS, the Activity rule below applies). Activity-backed IDs are omitted when the token appears in `balances`.","type":"array","items":{"type":"string"}},"processingDefiPositions":{"example":["eip155:1:0xdbd47f66aa2f00b3db03397f260ce9728298c495"],"description":"Account IDs whose DeFi positions are still being indexed upstream; poll again shortly. DeFi balance rows for these accounts are omitted until complete.","type":"array","items":{"type":"string"}}},"required":["balances","unprocessedNetworks","unprocessedIncludeAssetIds"]},"MultiAccountStatsModel":{"type":"object","properties":{"data":{"type":"object","readOnly":true,"example":{"eip155:1:0xcc765934f460bf4ba43244a36f7561cbf618daca":{}}},"unprocessedAccounts":{"readOnly":true,"example":[],"type":"array","items":{"type":"string"}},"inactiveOrHighVolumeAccounts":{"readOnly":true,"example":[],"type":"array","items":{"type":"string"}}},"required":["data","unprocessedAccounts","inactiveOrHighVolumeAccounts"]},"PageInfoDto":{"type":"object","properties":{"count":{"type":"number","readOnly":true,"example":1},"hasNextPage":{"type":"boolean","readOnly":true,"example":true},"hasPreviousPage":{"type":"boolean","readOnly":true,"example":false},"startCursor":{"type":"string","readOnly":true,"example":null},"endCursor":{"type":"string","readOnly":true,"example":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyIxIjp7Imhhc05leHRQYWdlIjp0cnVlLCJsYXN0VGltZXN0YW1wIjoiMjAyNC0wNC0zMFQwMTowNDozNS4wMDBaIn0sImlhdCI6MTcxNDQ4NzI5OH0.3UP9fshQr-pCxNUKOgbE39wcnAZyomAj-XXa09qvrcw"}},"required":["count","hasNextPage","hasPreviousPage","startCursor","endCursor"]},"GetMultiNetworkTransactionsDataDto":{"type":"object","properties":{"hash":{"type":"string","readOnly":true,"example":"0x3ccf5f5dcbdb91f4d1a6a4bb9d25e2d9cf50b3492adaf8c9be374137f315f1e2"},"timestamp":{"type":"string","readOnly":true,"example":"2024-04-30T01:19:11.000Z"},"chainId":{"type":"number","readOnly":true,"example":1},"blockNumber":{"type":"number","readOnly":true,"example":19764794},"blockHash":{"type":"string","readOnly":true,"example":"0xa0f2376e308697e637b278be2224f4d84aa03ee3637cf969b3c01ea6c1f8a560"},"gas":{"type":"number","readOnly":true,"example":2830426},"gasUsed":{"type":"number","readOnly":true,"example":2806981},"gasPrice":{"type":"string","readOnly":true,"example":"6001570681"},"effectiveGasPrice":{"type":"string","readOnly":true,"example":"6001570681"},"nonce":{"type":"number","readOnly":true,"example":35},"cumulativeGasUsed":{"type":"number","readOnly":true,"example":19137267},"methodId":{"type":"string","readOnly":true,"example":"0x26ededb8"},"value":{"type":"string","readOnly":true,"example":"0"},"to":{"type":"string","readOnly":true,"example":"0xa37fd8ba1dd513c5409154a79af7cc2c303ed21f"},"from":{"type":"string","readOnly":true,"example":"0x7f8718a803506b660f9ad8d3cd9bab16466b7f06"},"isError":{"type":"boolean","readOnly":true,"example":false},"valueTransfers":{"readOnly":true,"example":[{"from":"0x4580adf5b67cb9a2844ac46f1f41e7a3d37b3a73","to":"0x1db3439a222c519ab44bb1144fc28167b4fa6ee6","amount":"13057625160161154","decimal":8,"contractAddress":"0xa37fd8ba1dd513c5409154a79af7cc2c303ed21f","symbol":"Tesla AI","name":"Tesla AI","transferType":"erc20"}],"type":"array","items":{"type":"string"}},"logs":{"readOnly":true,"example":[{"data":"0x000000000000000000000000000000000000000000000000002e63d745481782","topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x0000000000000000000000004580adf5b67cb9a2844ac46f1f41e7a3d37b3a73","0x000000000000000000000000c74b656bd2ebe313d26d1ac02bcf95b137d1c857"],"address":"0xa37fd8ba1dd513c5409154a79af7cc2c303ed21f","logIndex":350},{"data":"0x000000000000000000000000000000000000000000000000002e63d745481782","topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x0000000000000000000000004580adf5b67cb9a2844ac46f1f41e7a3d37b3a73","0x00000000000000000000000035348ee6c587561d9c2c2ccc72623cc7c3d41351"],"address":"0xa37fd8ba1dd513c5409154a79af7cc2c303ed21f","logIndex":351}],"type":"array","items":{"type":"string"}},"transactionType":{"type":"string","readOnly":true,"example":"ERC_20_TRANSFER"},"transactionCategory":{"type":"string","readOnly":true,"example":"TRANSFER"},"transactionProtocol":{"type":"string","readOnly":true,"example":"ERC_20"}},"required":["hash","timestamp","chainId","blockNumber","blockHash","gas","gasUsed","gasPrice","effectiveGasPrice","nonce","cumulativeGasUsed","methodId","value","to","from","isError","valueTransfers","logs","transactionType","transactionCategory","transactionProtocol"]},"GetMultiAccountNetworkTransactionsDto":{"type":"object","properties":{"unprocessedNetworks":{"readOnly":true,"example":["eip155:1:0x0000000000000000000000000000000000000000"],"type":"array","items":{"type":"string"}},"pageInfo":{"readOnly":true,"allOf":[{"$ref":"#/components/schemas/PageInfoDto"}]},"data":{"readOnly":true,"type":"array","items":{"$ref":"#/components/schemas/GetMultiNetworkTransactionsDataDto"}}},"required":["unprocessedNetworks","pageInfo","data"]},"TransactionsV5PageInfoDto":{"type":"object","properties":{"count":{"type":"number","readOnly":true,"example":1},"hasNextPage":{"type":"boolean","readOnly":true,"example":true},"endCursor":{"type":"string","readOnly":true,"example":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ2IjoxLCJ0eXBlIjoibXVsdGlhY2NvdW50LXRyYW5zYWN0aW9ucy12NSJ9.signature"}},"required":["count","hasNextPage","endCursor"]},"GetMultiAccountNetworkTransactionsV5Dto":{"type":"object","properties":{"data":{"readOnly":true,"type":"array","items":{"$ref":"#/components/schemas/TransactionsV5RecordDto"}},"pageInfo":{"readOnly":true,"allOf":[{"$ref":"#/components/schemas/TransactionsV5PageInfoDto"}]},"unprocessedAccounts":{"readOnly":true,"example":["stellar:pubnet:GABC..."],"type":"array","items":{"type":"string"}}},"required":["data","pageInfo","unprocessedAccounts"]},"LabelsMetadataModel":{"type":"object","properties":{"is":{"readOnly":true,"example":["eip155:1:0x5197b5b062288bbf29008c92b08010a92dd677cd","eip155:1:0x1db3439a222c519ab44bb1144fc28167b4fa6ee6","eip155:56:0x5197b5b062288bbf29008c92b08010a92dd677cd","eip155:56:0x1db3439a222c519ab44bb1144fc28167b4fa6ee6"],"type":"array","items":{"type":"string"}}},"required":["is"]}}}}