Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: PontoFato Metrics API
version: 2d690e87
description: 'Ponto e fato de um lugar no Brasil. Índice: GET /api/.'
servers:
- url: https://pontofato.com
tags:
- name: Metrics
paths:
/api/metrics:
get:
operationId: get_api_metrics
summary: Métricas dos últimos 7 dias para o painel do operador; com o token, inclui os…
description: 'Sem credencial devolve o uso real da API: movimentos de crédito da casa por dia, com `produto` separando o PontoFato dos outros produtos no banco compartilhado. Visitas da interface não são contadas aqui — quem mede visita é o GA e a borda CF. Com `METRICS_TOKEN` em Bearer acrescenta `payments` — só x402 liquidado em Base mainnet.
Devolve: { app, today, today_visits, today_contacts?, days, usage, accounts, financeiro?, payments? }'
parameters:
- name: Authorization
in: header
required: false
schema:
type: string
description: '`Bearer <METRICS_TOKEN>` para incluir o bloco financeiro; token errado é 401.'
responses:
'200':
description: '{ app, today, today_visits, today_contacts?, days, usage, accounts, financeiro?, payments? }'
content:
application/json:
schema:
$ref: '#/components/schemas/Metricas'
'401':
description: Token de operador errado.
'503':
description: Worker sem METRICS_TOKEN configurado.
tags:
- Metrics
components:
schemas:
Metricas:
type: object
properties:
app:
type: string
description: Nome do produto.
today:
type: string
description: Dia de referência (UTC, AAAA-MM-DD).
today_visits:
type: integer
description: 'Zero neste produto: visitas são medidas pelo GA e pela borda CF.'
today_contacts:
type: integer
description: 'Mensagens de contato hoje. Só com `METRICS_TOKEN`: contato não sai sem token.'
days:
type: array
items:
type: object
description: Um registro por dia da janela, com as contagens de cada métrica.
usage:
type: object
description: '`creditos`: movimentos de crédito do PontoFato por dia — chamadas pagas da API, x402 ou crédito, com `produto` filtrando o que é da casa.'
accounts:
type: object
description: 'Sem contas neste produto: objeto vazio.'
financeiro:
type: object
description: 'Agregado do dia: `hoje_usd`, `hoje_count`, `rede`. Só com `METRICS_TOKEN`: dinheiro não sai sem token; a série completa é `payments`.'
payments:
type: object
description: Resumo financeiro do x402; só com METRICS_TOKEN.
required:
- app
- today
- today_visits
- days
- usage
- accounts
description: Painel de 7 dias do operador. `payments` só aparece com o token e só em Base mainnet.