GETTING STARTED

Make your first call in 60 seconds.

Malinal is a standard REST API: API-key auth, JSON responses, predictable URLs. Works from any language with an HTTP client.

Get your API key

Sign in with GitHub, Google or Apple at malinal.ai/accounts/login and create a key in your console. Authenticate every request with X-API-Key: YOUR_API_KEY.

info Treat your API key like a password. Store it in environment variables, never commit it to a public repo.

Make your first call

Try the AAPL profile endpoint. It returns sector, industry, headquarters, CEO, and a business description — and confirms your key works.

info All endpoints live under https://api.malinal.ai/v1. The base URL never changes between environments.

Parse the response

Every endpoint returns JSON with a stable schema. Symbols are uppercase tickers; dates are ISO-8601; numbers are USD unless explicitly named otherwise (ratios, percentages, share counts).

info AI-generated fields always include a last_updated timestamp so you know how fresh the analysis is.

Next steps

Terminal Execution

import requests

response = requests.get(
    "https://api.malinal.ai/v1/profiles/AAPL",
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(response.json())

const res = await fetch(
  "https://api.malinal.ai/v1/profiles/AAPL",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
console.log(await res.json());

curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.malinal.ai/v1/profiles/AAPL

API Chips

STATUS · 200 OK

LATENCY · ~80ms

VERSION · v1