Trailing Twelve Month Financials

Trailing twelve month financials

curl --request GET \
  --url https://api.ngnmarket.com/v1/companies/{symbol}/financials/ttm \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.ngnmarket.com/v1/companies/{symbol}/financials/ttm"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ngnmarket.com/v1/companies/{symbol}/financials/ttm', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ngnmarket.com/v1/companies/{symbol}/financials/ttm",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ngnmarket.com/v1/companies/{symbol}/financials/ttm"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.ngnmarket.com/v1/companies/{symbol}/financials/ttm")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "data": [
      {
        "as_of": "Q4 2025",
        "quarters_included": [
          "Q4 2025",
          "Q3 2025",
          "Q2 2025",
          "Q1 2025"
        ],
        "currency": "NGN",
        "income_statement_ttm": {
          "revenue": 1207773081000,
          "net_income": 104966001000,
          "eps_basic": 132.42,
          "eps_diluted": 132.42
        },
        "cash_flow_ttm": {
          "net_cash_operating": 362778896000,
          "free_cash_flow": 265796451000,
          "dividends_paid": -1491065000
        },
        "balance_sheet": {
          "total_assets": 680000000000,
          "shareholders_equity": 1420000000000
        },
        "ratios_ttm": {
          "gross_margin": 0.3609,
          "return_on_equity": 0.0739
        }
      }
    ],
    "count": 1
  },
  "meta": {
    "plan": "business",
    "calls_used": 1208,
    "calls_remaining": 498792,
    "reset_at": "2026-05-15T23:57:00.000Z"
  }
}

GET

companies

{symbol}

financials

ttm

Trailing twelve month financials

curl --request GET \
  --url https://api.ngnmarket.com/v1/companies/{symbol}/financials/ttm \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.ngnmarket.com/v1/companies/{symbol}/financials/ttm"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ngnmarket.com/v1/companies/{symbol}/financials/ttm', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ngnmarket.com/v1/companies/{symbol}/financials/ttm",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ngnmarket.com/v1/companies/{symbol}/financials/ttm"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.ngnmarket.com/v1/companies/{symbol}/financials/ttm")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "data": [
      {
        "as_of": "Q4 2025",
        "quarters_included": [
          "Q4 2025",
          "Q3 2025",
          "Q2 2025",
          "Q1 2025"
        ],
        "currency": "NGN",
        "income_statement_ttm": {
          "revenue": 1207773081000,
          "net_income": 104966001000,
          "eps_basic": 132.42,
          "eps_diluted": 132.42
        },
        "cash_flow_ttm": {
          "net_cash_operating": 362778896000,
          "free_cash_flow": 265796451000,
          "dividends_paid": -1491065000
        },
        "balance_sheet": {
          "total_assets": 680000000000,
          "shareholders_equity": 1420000000000
        },
        "ratios_ttm": {
          "gross_margin": 0.3609,
          "return_on_equity": 0.0739
        }
      }
    ],
    "count": 1
  },
  "meta": {
    "plan": "business",
    "calls_used": 1208,
    "calls_remaining": 498792,
    "reset_at": "2026-05-15T23:57:00.000Z"
  }
}

This endpoint returns trailing-twelve-month (TTM) financials, computed by summing the 4 most recent discrete quarters on file. It’s shaped a little differently from the other financials endpoints: by default it returns a single rolling snapshot, not a list of filed reporting periods, since TTM means “the last four quarters as of right now,” not a specific period a company filed. The income statement and cash flow sections are genuine sums across the 4 quarters. The balance sheet section is not summed, it’s just the latest quarter’s snapshot, since assets and liabilities don’t add across periods the way revenue or cash flow does. Ratios are computed from the summed flow figures against that latest balance sheet. Pass limit to get a rolling window of TTM snapshots instead of just the latest one. This is useful for charting a smoothed trend, TTM revenue at each of the last 8 quarter-ends, for example, without the seasonal noise you’d get from raw quarterly figures. Each snapshot includes quarters_included, listing exactly which 4 quarters were summed, so if a company has a gap in its reporting history you’ll see it rather than get a silently wrong number. This endpoint needs 4 consecutive discrete quarters on file (Q1–Q4, not cumulative 9M or H1 figures) to compute anything. Companies without that history return a 404 rather than a fallback built from annual figures, which wouldn’t actually be trailing twelve months. For example, to fetch the latest TTM snapshot for Nestlé Nigeria:

curl "https://api.ngnmarket.com/v1/companies/NESTLE/financials/ttm" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

const res = await fetch('https://api.ngnmarket.com/v1/companies/NESTLE/financials/ttm', {
  headers: { Authorization: 'Bearer ngm_live_YOUR_KEY' },
});
const { data } = await res.json();
const latest = data.data[0];
// latest.income_statement_ttm.revenue — trailing 12 month revenue
// latest.quarters_included           — which 4 quarters were summed

import requests

res = requests.get(
    'https://api.ngnmarket.com/v1/companies/NESTLE/financials/ttm',
    headers={'Authorization': 'Bearer ngm_live_YOUR_KEY'},
)
data = res.json()['data']

To chart a rolling TTM revenue trend over the last two years of quarter-ends:

curl "https://api.ngnmarket.com/v1/companies/NESTLE/financials/ttm?limit=8" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

const url = new URL('https://api.ngnmarket.com/v1/companies/NESTLE/financials/ttm');
url.searchParams.set('limit', '8');

const res = await fetch(url, {
  headers: { Authorization: 'Bearer ngm_live_YOUR_KEY' },
});
const { data } = await res.json();
// data.data — 8 rolling TTM snapshots, most recent first

import requests

res = requests.get(
    'https://api.ngnmarket.com/v1/companies/NESTLE/financials/ttm',
    params={'limit': 8},
    headers={'Authorization': 'Bearer ngm_live_YOUR_KEY'},
)
data = res.json()['data']

This endpoint requires a Business plan or higher.

Authorizations

Authorization

string

header

required

Pass your API key as a Bearer token: Authorization: Bearer ngm_live_YOUR_KEY. Generate keys at ngnmarket.com/dashboard/developer.

Path Parameters

symbol

string

required

NGX ticker symbol (e.g. GTCO). Case-insensitive.

Example:

"NESTLE"

Query Parameters

limit

integer

default:1

Number of rolling TTM snapshots to return, most recent first (1–40).

Required range: 1 <= x <= 40

Response

TTM financials retrieved successfully.

success

boolean

required

Using the API

Market Endpoints

Company Endpoints

Dividend Endpoints

Forex Endpoints

Index Endpoints

ETF Endpoints

Bond Endpoints

Disclosure Endpoints

Blog Endpoints

Account Endpoints

Trailing Twelve Month Financials

Authorizations

Path Parameters

Query Parameters

Response