Get the total amount of a token received on a specific chain, for cross-chain transfers.
Calculates and returns the total received token amount per wallet address, per sending chain, within a specified time range, for a given receiving chain and receiving token. Only aggregates cross-chain transfers, meaning transfers with distinct sending and receiving chains.
GET
/
v1
/
analytics
/
transfers
/
summary
Get the total amount of a token received on a specific chain, for cross-chain transfers.
curl --request GET \
--url https://li.quest/v1/analytics/transfers/summary
A Unix timestamp in seconds marking the start of the query period, inclusive. Transactions older than this timestamp will not be included in the summary.
A Unix timestamp in seconds marking the end of the query period, inclusive. Transactions after this timestamp will not be included in the summary. The maximum range supported by the endpoint is 30 days.
The ID, or key of the chain on the receiving side of the transfer. This parameter filters the summary to include only transfers received on the specified chain.
The address, or symbol of the token received in the transfers. This parameter filters the summary to include only transfers involving the specified token on the receiving chain.
The ID, or key of the chain on the sending side of the transfers. This parameter filters the summary to include only transfers sent from the specified chain.
An array containing the paginated data returned by the endpoint
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"LI.FI","description":"Get the best price execution for any swaps and bridging across EVM chains, Solana, Bitcoin and alt-VMs. Enable trading across all DEX aggregators, bridges, and intent-systems and save hundreds of developer hours.","colors":{"primary":"#5C67FF","light":"#fab6f4","dark":"#5C67FF"},"logo":{"light":"https://mintcdn.com/lifi/EmProAEgMrruLUbI/logo/light.png?fit=max\u0026auto=format\u0026n=EmProAEgMrruLUbI\u0026q=85\u0026s=f435348680e682acea6e3b9af339ed7a","dark":"https://mintcdn.com/lifi/EmProAEgMrruLUbI/logo/dark.png?fit=max\u0026auto=format\u0026n=EmProAEgMrruLUbI\u0026q=85\u0026s=d02539147db168291d7c711beb45d10b"},"favicon":"https://mintcdn.com/lifi/jEGN0oG6bNsdv0a3/logo/favicon.svg?fit=max\u0026auto=format\u0026n=jEGN0oG6bNsdv0a3\u0026q=85\u0026s=35fb6353ca8815e24daf1025135fef38","api":{"openapi":"openapi.yaml"},"appearance":{"default":"dark"},"background":{"color":{"light":"#FAFAFF","dark":"#000B29"}},"navbar":{"links":[{"href":"https://lifihelp.zendesk.com/hc/en-us","label":"Support"}],"primary":{"type":"button","label":"Get Started","href":"https://portal.li.fi/signup"}},"footer":{"socials":{"x":"https://x.com/lifiprotocol","github":"https://github.com/lifinance","website":"https://li.fi/"},"links":[{"header":"Company","items":[{"label":"Careers","href":"https://li.fi/careers"},{"label":"Brand Assets","href":"https://li.fi/brand-assets"},{"label":"About","href":"https://li.fi/"}]},{"header":"Tools","items":[{"label":"LI.FI Explorer","href":"https://explorer.li.fi/?utm_source=lifi\u0026utm_medium=footer_link_tools\u0026utm_campaign=lifi_to_explorer"}]},{"header":"Legal","items":[{"label":"Privacy Policy","href":"https://li.fi/legal/privacy-policy"},{"label":"Terms of Service","href":"https://li.fi/legal/terms-and-conditions"},{"label":"Imprint","href":"https://li.fi/legal/imprint"}]}]},"styling":{"eyebrows":"section","codeblocks":"system","latex":false},"integrations":{"ga4":{"measurementId":"G-NTE1P73M4Q"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"languages":[{"language":"en","href":"introduction/introduction"},{"language":"zh-Hans","href":"zh-Hans/introduction/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"lifi","hasAudioNarration":false,"actualSubdomain":"lifi","customDomains":["docs.li.fi"],"gitSource":{"type":"github","owner":"lifinance","repo":"public-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae4467b6255dab49421940b","collectionId":"fe96f741-47cb-43b3-b1b9-c7bfc174e641","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4467b6255dab49421940b"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4467b6255dab49421940b","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"en","tag":"Overview","count":48},{"language":"en","tag":"Composer","count":46},{"language":"zh-Hans","tag":"Composer","count":46},{"language":"zh-Hans","tag":"概述","count":44},{"language":"en","tag":"API Reference","count":34},{"language":"en","tag":"Intents \u0026 Solvers","count":32},{"language":"zh-Hans","tag":"意图与求解器","count":32},{"language":"en","tag":"Integrate via Composer API","count":30},{"language":"zh-Hans","tag":"通过 Composer API 集成","count":30},{"language":"zh-Hans","tag":"API 参考","count":29},{"language":"en","tag":"Reference","count":23},{"language":"en","tag":"For Agents","count":21},{"language":"en","tag":"Widget","count":20},{"language":"zh-Hans","tag":"Widget","count":20},{"language":"zh-Hans","tag":"参考文档","count":19},{"language":"en","tag":"Getting Started","count":16},{"language":"en","tag":"General API","count":16},{"language":"zh-Hans","tag":"通用 API","count":16},{"language":"zh-Hans","tag":"企业级功能","count":15},{"language":"zh-Hans","tag":"入门","count":14}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers","slug":"/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers","pageMetadata":{"openapi":"get /v1/analytics/transfers/summary","title":"Get the total amount of a token received on a specific chain, for cross-chain transfers.","description":"Calculates and returns the total received token amount per wallet address, per sending chain, within a specified time range, for a given receiving chain and receiving token. Only aggregates cross-chain transfers, meaning transfers with distinct sending and receiving chains.","href":"/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Calculates and returns the total received token amount per wallet address, per sending chain, within a specified time range, for a given receiving chain and receiving token. Only aggregates cross-chain transfers, meaning transfers with distinct sending and receiving chains.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"openapi":"get /v1/analytics/transfers/summary","title":"Get the total amount of a token received on a specific chain, for cross-chain transfers.","description":"Calculates and returns the total received token amount per wallet address, per sending chain, within a specified time range, for a given receiving chain and receiving token. Only aggregates cross-chain transfers, meaning transfers with distinct sending and receiving chains.","href":"/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/lifi/951d8dd0c2dbce84/plausible.js","/_mintlify/custom/lifi/8e3c41579c236ea7/scripts/translate-docs.js","/_mintlify/custom/lifi/b34903975490ec23/scripts/generate-md-redirects.js","/_mintlify/custom/lifi/516472b23ab068ad/scripts/check-links.js","/_mintlify/custom/lifi/70364f7a7384bb43/scripts/markdown-chunker.js","/_mintlify/custom/lifi/6c99617851837b30/scripts/translation-config.js","/_mintlify/custom/lifi/8f88293865b45873/scripts/verify-translation-coverage.js"],"openApiReferenceData":{"operation":{"parameters":["7fbdc9a3-1087-450e-91e4-09785e0559b9","23afe97f-d5ed-4e45-a37c-61ab934d2134","b80b608c-26d0-4090-b6a0-601cf3afa7bd","d23450d4-ba3b-4ba3-bcd4-38a106d8196d","248fae95-8e2d-4dd5-b4f0-aa81099788d8","42b3d552-d1d9-4a57-9691-cf87674c8cd5","24a1fee2-f4ec-450e-9404-cc583d4341d0","59d9d377-6990-4de6-8bd7-bec76de808c3","230aab1e-ac0b-46a3-9615-1b35a80bc7ce"],"responses":{"200":"59dbe9cf-f148-4150-be74-1085d6cef064"},"summary":"Get the total amount of a token received on a specific chain, for cross-chain transfers.","description":"Calculates and returns the total received token amount per wallet address, per sending chain, within a specified time range, for a given receiving chain and receiving token. Only aggregates cross-chain transfers, meaning transfers with distinct sending and receiving chains.","method":"get","type":"path","servers":["2d571c46-53ec-43a1-9793-fbf2719d026d","ea026e35-a5ad-4fd4-9864-837362b78550"],"security":[],"path":"/v1/analytics/transfers/summary","baseUrlOptions":["https://li.quest","https://staging.li.quest"],"title":"Get the total amount of a token received on a specific chain, for cross-chain transfers.","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"7fbdc9a3-1087-450e-91e4-09785e0559b9":{"name":"limit","description":"Pagination limit. Defines the maximum number of returned results.","schema":{"default":10,"type":"integer","isRequired":false,"description":"Pagination limit. Defines the maximum number of returned results.","uniqueKey":"","typeLabel":"integer"},"in":"query","required":false},"23afe97f-d5ed-4e45-a37c-61ab934d2134":{"name":"next","description":"The next page cursor. Must come from the `next` field of the response of the previous request.","schema":{"type":"string","isRequired":false,"description":"The next page cursor. Must come from the `next` field of the response of the previous request.","uniqueKey":"","typeLabel":"string"},"in":"query","required":false},"b80b608c-26d0-4090-b6a0-601cf3afa7bd":{"name":"previous","description":"The previous page cursor. Must come from the `previous` field of the response of the previous request.","schema":{"type":"string","isRequired":false,"description":"The previous page cursor. Must come from the `previous` field of the response of the previous request.","uniqueKey":"","typeLabel":"string"},"in":"query","required":false},"d23450d4-ba3b-4ba3-bcd4-38a106d8196d":{"name":"fromTimestamp","description":"A Unix timestamp in seconds marking the start of the query period, inclusive. Transactions older than this timestamp will not be included in the summary.\n","schema":{"type":"string","isRequired":true,"description":"A Unix timestamp in seconds marking the start of the query period, inclusive. Transactions older than this timestamp will not be included in the summary.\n","uniqueKey":"","typeLabel":"string"},"in":"query","required":true},"248fae95-8e2d-4dd5-b4f0-aa81099788d8":{"name":"toTimestamp","description":"A Unix timestamp in seconds marking the end of the query period, inclusive. Transactions after this timestamp will not be included in the summary. **The maximum range supported by the endpoint is 30 days.**\n","schema":{"type":"string","isRequired":true,"description":"A Unix timestamp in seconds marking the end of the query period, inclusive. Transactions after this timestamp will not be included in the summary. **The maximum range supported by the endpoint is 30 days.**\n","uniqueKey":"","typeLabel":"string"},"in":"query","required":true},"42b3d552-d1d9-4a57-9691-cf87674c8cd5":{"name":"toChain","description":"The ID, or key of the chain on the receiving side of the transfer. This parameter filters the summary to include only transfers received on the specified chain.\n","schema":{"type":"string","isRequired":true,"description":"The ID, or key of the chain on the receiving side of the transfer. This parameter filters the summary to include only transfers received on the specified chain.\n","uniqueKey":"","typeLabel":"string"},"in":"query","required":true},"24a1fee2-f4ec-450e-9404-cc583d4341d0":{"name":"toToken","description":"The address, or symbol of the token received in the transfers. This parameter filters the summary to include only transfers involving the specified token on the receiving chain.\n","schema":{"type":"number","isRequired":true,"description":"The address, or symbol of the token received in the transfers. This parameter filters the summary to include only transfers involving the specified token on the receiving chain.\n","uniqueKey":"","typeLabel":"number"},"in":"query","required":true},"59d9d377-6990-4de6-8bd7-bec76de808c3":{"name":"fromChain","description":"The ID, or key of the chain on the sending side of the transfers. This parameter filters the summary to include only transfers sent from the specified chain.\n","schema":{"type":"number","isRequired":false,"description":"The ID, or key of the chain on the sending side of the transfers. This parameter filters the summary to include only transfers sent from the specified chain.\n","uniqueKey":"","typeLabel":"number"},"in":"query","required":false},"230aab1e-ac0b-46a3-9615-1b35a80bc7ce":{"name":"integrator","description":"The integrator string to filter transfers by. This parameter filters the summary to include only transfers for the given integrator.\n","schema":{"type":"string","isRequired":false,"description":"The integrator string to filter transfers by. This parameter filters the summary to include only transfers for the given integrator.\n","uniqueKey":"","typeLabel":"string"},"in":"query","required":false}},"responses":{"59dbe9cf-f148-4150-be74-1085d6cef064":{"content":{"application/json":{"schema":{"type":"object","title":"Pagination Query Parameters","description":"Parameters used to query paginated endpoints","properties":{"hasNext":{"description":"Flag indicating if there is a next page","default":false,"type":"boolean","uniqueKey":"hasNext","typeLabel":"boolean"},"hasPrevious":{"description":"Flag indicating if there is a previous page","default":false,"type":"boolean","uniqueKey":"hasPrevious","typeLabel":"boolean"},"next":{"oneOf":[{"description":"Cursor for fetching the next page. Should be passed to `next` in the pagination query.","type":"string","uniqueKey":"next.oneOf.0","typeLabel":"string"},{"description":"Cursor for fetching the next page. Should be passed to `next` in the pagination query.","type":"null","uniqueKey":"next.oneOf.1","typeLabel":"null"}],"uniqueKey":"next","typeLabel":"string | null"},"previous":{"oneOf":[{"description":"Cursor for fetching the previous page. Should be passed to `previous` in the pagination query.","type":"string","uniqueKey":"previous.oneOf.0","typeLabel":"string"},{"description":"Cursor for fetching the previous page. Should be passed to `previous` in the pagination query.","type":"null","uniqueKey":"previous.oneOf.1","typeLabel":"null"}],"uniqueKey":"previous","typeLabel":"string | null"},"data":{"type":"array","items":{"title":"Transfers Summary","description":"Transfers summary element as returned by GET /v1/analytics/transfers/summary endpoint","type":"object","properties":{"id":{"type":"object","properties":{"toAddress":{"description":"The address in the receiving side of the transfer","type":"string","uniqueKey":"data.items.[INDEX].id.toAddress","typeLabel":"string"},"sendingChainId":{"description":"The ID of the chain the transfer was sent from","type":"number","uniqueKey":"data.items.[INDEX].id.sendingChainId","typeLabel":"number"}},"uniqueKey":"data.items.[INDEX].id","typeLabel":"object"},"totalReceivedAmount":{"description":"The cumulative amount of token received","type":"number","uniqueKey":"data.items.[INDEX].totalReceivedAmount","typeLabel":"number"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"Transfers Summary · object"},"description":"An array containing the paginated data returned by the endpoint ","uniqueKey":"data","typeLabel":"Transfers Summary · object[]"}},"uniqueKey":"","typeLabel":"Pagination Query Parameters · object"},"examples":{"Example":{"title":"Example","value":{"hasNext":false,"hasPrevious":false,"next":"\u003cstring>","previous":"\u003cstring>","data":[{"id":{"toAddress":"\u003cstring>","sendingChainId":123},"totalReceivedAmount":123}]}}},"exampleType":"generated"}},"description":"Response for `GET /analytics/transfers/summary` endpoint","exampleType":"generated"}},"security":{},"servers":{"2d571c46-53ec-43a1-9793-fbf2719d026d":{"url":"https://li.quest","description":"LI.FI Production Environment"},"ea026e35-a5ad-4fd4-9864-837362b78550":{"url":"https://staging.li.quest","description":"LI.FI Staging Environment"}}},"originalFileLocation":"openapi.yaml"},"subdomain":"lifi","siteName":"LI.FI","title":"Get the total amount of a token received on a specific chain, for cross-chain transfers. - LI.FI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers","matchLevel":0},"zh-Hans":{"href":"/zh-Hans/introduction/introduction","matchLevel":4}}},"lastModified":"2026-01-22T15:00:25.767Z","originalFileLocation":"api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Calculates and returns the total received token amount per wallet address, per sending chain, within a specified time range, for a given receiving chain and receiving token. Only aggregates cross-chain transfers, meaning transfers with distinct sending and receiving chains.\">\u003cmeta data-mint-head name=\"application-name\" content=\"LI.FI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get the total amount of a token received on a specific chain, for cross-chain transfers. - LI.FI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Calculates and returns the total received token amount per wallet address, per sending chain, within a specified time range, for a given receiving chain and receiving token. Only aggregates cross-chain transfers, meaning transfers with distinct sending and receiving chains.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"LI.FI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.li.fi/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://lifi.mintlify.app/_mintlify/api/og/v2?division=Analytics\u0026amp;title=Get+the+total+amount+of+a+token+received+on+a+specific+chain%2C+for+cross-chain+transfers.\u0026amp;description=Calculates+and+returns+the+total+received+token+amount+per+wallet+address%2C+per+sending+chain%2C+within+a+specified+time+range%2C+for+a+given+receiving+chain+and+rec\u0026amp;theme=bbd760f308f6962e114ab426\u0026amp;signature=60ea547a0d31671e9f086947df6410259d55191f302c88ef216c90af44070e53\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get the total amount of a token received on a specific chain, for cross-chain transfers. - LI.FI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Calculates and returns the total received token amount per wallet address, per sending chain, within a specified time range, for a given receiving chain and receiving token. Only aggregates cross-chain transfers, meaning transfers with distinct sending and receiving chains.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://lifi.mintlify.app/_mintlify/api/og/v2?division=Analytics\u0026amp;title=Get+the+total+amount+of+a+token+received+on+a+specific+chain%2C+for+cross-chain+transfers.\u0026amp;description=Calculates+and+returns+the+total+received+token+amount+per+wallet+address%2C+per+sending+chain%2C+within+a+specified+time+range%2C+for+a+given+receiving+chain+and+rec\u0026amp;theme=bbd760f308f6962e114ab426\u0026amp;signature=60ea547a0d31671e9f086947df6410259d55191f302c88ef216c90af44070e53\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"LI.FI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5C67FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.li.fi/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.li.fi/#organization\",\"name\":\"LI.FI\",\"url\":\"https://docs.li.fi\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/lifi/EmProAEgMrruLUbI/logo/light.png?fit=max\u0026auto=format\u0026n=EmProAEgMrruLUbI\u0026q=85\u0026s=f435348680e682acea6e3b9af339ed7a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.li.fi#website\",\"name\":\"LI.FI\",\"url\":\"https://docs.li.fi\",\"publisher\":{\"@id\":\"https://docs.li.fi/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.li.fi/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers#webpage\",\"url\":\"https://docs.li.fi/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers\",\"name\":\"Get the total amount of a token received on a specific chain, for cross-chain transfers.\",\"description\":\"Calculates and returns the total received token amount per wallet address, per sending chain, within a specified time range, for a given receiving chain and receiving token. Only aggregates cross-chain transfers, meaning transfers with distinct sending and receiving chains.\",\"dateModified\":\"2026-01-22T15:00:25.767Z\",\"isPartOf\":{\"@id\":\"https://docs.li.fi#website\"},\"breadcrumb\":{\"@id\":\"https://docs.li.fi/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.li.fi/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"General API\",\"item\":\"https://docs.li.fi/api-reference/get-information-about-all-currently-supported-chains\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get the total amount of a token received on a specific chain, for cross-chain transfers.\",\"item\":\"https://docs.li.fi/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.li.fi/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers#apireference\",\"headline\":\"Get the total amount of a token received on a specific chain, for cross-chain transfers.\",\"name\":\"Get the total amount of a token received on a specific chain, for cross-chain transfers.\",\"description\":\"Calculates and returns the total received token amount per wallet address, per sending chain, within a specified time range, for a given receiving chain and receiving token. Only aggregates cross-chain transfers, meaning transfers with distinct sending and receiving chains.\",\"url\":\"https://docs.li.fi/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers\",\"mainEntityOfPage\":{\"@id\":\"https://docs.li.fi/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers#webpage\"},\"dateModified\":\"2026-01-22T15:00:25.767Z\",\"publisher\":{\"@id\":\"https://docs.li.fi/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.li.fi#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"LI.FI\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"LI.FI","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/introduction/introduction"}]},{"tab":"Enterprise (New)","pages":[{"title":"Enterprise (New)","href":"/enterprise/overview"}]},{"tab":"API Reference","groups":[{"group":"About APIs","pages":[{"title":"Overview","href":"/api-reference/introduction"},{"title":"OpenAPI Specification","href":"/api-reference/openapi-spec"},{"title":"Rate Limits and API Authentication","href":"/api-reference/rate-limits"},{"title":"API Key Security","href":"/api-reference/api-key-security"},{"title":"Error Codes","href":"/api-reference/error-codes"}]},{"group":"General API","pages":[{"group":"Chains","pages":[{"openapi":"openapi.yaml GET /v1/chains","title":"Get information about all currently supported chains","href":"/api-reference/get-information-about-all-currently-supported-chains"}]},{"group":"Tokens","pages":[{"title":"Fetch all known tokens","openapi":"get /v1/tokens","href":"/api-reference/fetch-all-known-tokens"},{"openapi":"get /v1/token","title":"Fetch information about a Token","href":"/api-reference/fetch-information-about-a-token"}]},{"group":"Tools","pages":[{"openapi":"get /v1/tools","title":"Get available bridges and exchanges","href":"/api-reference/get-available-bridges-and-exchanges"}]},{"group":"Connections","pages":[{"openapi":"get /v1/connections","title":"Returns all possible connections between two chains.","href":"/api-reference/returns-all-possible-connections-based-on-a-from-or-tochain"}]},{"group":"Gas endpoints","pages":[{"openapi":"get /v1/gas/prices/{chainId}","title":"Get gas price for the specified chainId","href":"/api-reference/gas/get-gas-price-for-the-specified-chainid"},{"openapi":"get /v1/gas/prices","title":"Get gas prices for enabled chains","href":"/api-reference/gas/get-gas-prices-for-enabled-chains"},{"openapi":"get /v1/gas/suggestion/{chain}","title":"Get a gas suggestion for the specified chain","href":"/api-reference/get-a-gas-suggestion-for-the-specified-chain"},{"openapi":"get /v1/gas/status","title":"Get status information about a lifuel transaction","href":"/api-reference/get-status-information-about-a-lifuel-transaction"},{"openapi":"get /v1/gas/refetch","title":"In case a transaction was missed by a relayer, this endpoint can be used to force a tx to be re-fetched.","href":"/api-reference/in-case-a-transaction-was-missed-by-a-relayer-this-endpoint-can-be-used-to-force-a-tx-to-be-re-fetched"}]},{"group":"Transaction status","pages":[{"openapi":"get /v1/status","title":"Check the status of a cross chain transfer","href":"/api-reference/check-the-status-of-a-cross-chain-transfer"}]},{"group":"Integrator fee information","pages":[{"openapi":"get /v1/integrators/{integratorId}/withdraw/{chainId}","title":"Get transaction request for withdrawing collected integrator's fees by chain","href":"/api-reference/get-transaction-request-for-withdrawing-collected-integrators-fees-by-chain"},{"openapi":"get /v1/integrators/{integratorId}","title":"Get integrator's collected fees data for all supported chains","description":"This endpoint can be used to request all integrator's collected fees data by tokens for all supported chains.\nThe endpoint returns an `Integrator` object which contains the integrator id and an array of fee balances for all supported chains.","href":"/api-reference/get-integrators-collected-fees-data-for-all-supported-chains"}]},{"group":"Analytics","pages":[{"openapi":"get /v1/analytics/transfers/summary","title":"Get the total amount of a token received on a specific chain, for cross-chain transfers.","href":"/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers"},{"openapi":"get /v1/analytics/transfers","title":"Get a list of filtered transfers","description":"This endpoint can be used to retrieve a list of transfers filtered by certain properties. Returns a maximum of 1000 transfers.","href":"/api-reference/get-a-list-of-filtered-transfers"},{"openapi":"get /v2/analytics/transfers","title":"Get a paginated list of filtered transfers","href":"/api-reference/get-a-paginated-list-of-filtered-transfers"}]}]},{"group":"Requesting a quote","pages":[{"group":"API presets","pages":[{"title":"API Presets","href":"/api-reference/presets/overview"},{"title":"Stablecoin preset","href":"/api-reference/presets/stablecoin"}]},{"group":"Single-step quote","pages":[{"openapi":"get /v1/quote","title":"Get a quote for a token transfer","href":"/api-reference/get-a-quote-for-a-token-transfer"},{"openapi":"get /v1/quote/toAmount","title":"Get a quote for a token transfer","href":"/api-reference/get-a-quote-for-a-token-transfer-1"},{"openapi":"post /v1/quote/contractCalls","title":"Perform multiple contract calls across blockchains (BETA)","href":"/api-reference/perform-multiple-contract-calls-across-blockchains-beta"}]},{"group":"Advanced routes","pages":[{"openapi":"post /v1/advanced/routes","title":"Get a set of routes for a request that describes a transfer of tokens","href":"/api-reference/advanced/get-a-set-of-routes-for-a-request-that-describes-a-transfer-of-tokens"},{"openapi":"post /v1/advanced/stepTransaction","title":"Populate a step with transaction data","href":"/api-reference/advanced/populate-a-step-with-transaction-data"}]},{"group":"Parse transaction call data","pages":[{"openapi":"get /v1/calldata/parse","title":"Parse transaction call data (BETA)","href":"/api-reference/parse-transaction-call-data-beta"}]}]}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk/overview"}]},{"tab":"Widget","pages":[{"title":"Widget","href":"/widget/overview"}]},{"tab":"Composer","pages":[{"title":"Composer","href":"/composer/overview"}]},{"tab":"Earn","pages":[{"title":"Earn","href":"/earn/overview"}]},{"tab":"Perps","pages":[{"title":"Perps","href":"/perps/overview"}]},{"tab":"Intents \u0026 Solvers","pages":[{"title":"Intents \u0026 Solvers","href":"/lifi-intents/introduction"}]},{"tab":"For Agents","pages":[{"title":"For Agents","href":"/agents/overview"}]},{"tab":"Widget Playground","href":"https://playground.li.fi/"},{"tab":"Bigmi","pages":[{"title":"Bigmi","href":"/bigmi/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/gas-options"}]},{"tab":"FAQs","pages":[{"title":"FAQs","href":"/faqs/fees-monetization"}]}]},{"language":"zh-Hans","pages":[{"title":"zh-Hans","href":"/zh-Hans/introduction/introduction"}]}]},"basePath":"","title":"Get the total amount of a token received on a specific chain, for cross-chain transfers. - LI.FI","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}