Top movers leaderboard (MoM or YoY change)

GET

/api/v1/treasury/tic/mfh/changes

Last modified:2026-05-10 09:22:39

Maintainer:Not configured

OperationId:treasury_tic_mfh_changes

Countries ranked by absolute change between the latest period and a prior period. period=mom compares latest to one month back; period=yoy compares latest to twelve months back. Sort is by absolute delta descending, so both biggest buyers and biggest sellers appear at the top of the leaderboard. Skips countries with insufficient history for the requested comparison.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/treasury/tic/mfh/changes?period=undefined&limit=undefined' \
--header 'x-api-key: <api-key>'

Responses

🟢200

application/json

Top movers ranked by absolute change.

Bodyapplication/json

Example

{
    "data": {
        "period": "mom",
        "count": 0,
        "rows": [
            {
                "rank": 1,
                "name": "United Kingdom",
                "slug": "united-kingdom",
                "period_current": "Dec 2025",
                "period_prior": "Nov 2025",
                "value_current_billions": 0,
                "value_prior_billions": 0,
                "delta_billions": 0,
                "delta_pct": 0
            }
        ]
    },
    "meta": {
        "endpoint": "/api/v1/fred/us/cpi",
        "data_time": "2026-04-16T14:30:00Z",
        "response_time": "2026-04-16T14:30:12Z",
        "provider": "Sugra API v1.0.1",
        "source": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true
    }
}

🟠401

🟠422

🟠429

🔴503

Modified at 2026-05-10 09:22:39

Top N foreign holders of US Treasury securities

One country's historical TIC holdings timeseries