GETTING STARTED

Make your first call in 60 seconds.

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

Get your API key

Request access at malinal.ai/signup. Once approved, your key shows up in your dashboard. Authenticate every request with Authorization: Bearer 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={"Authorization": "Bearer YOUR_API_KEY"}
)
print(response.json())

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

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.malinal.ai/v1/profiles/AAPL

API Chips

STATUS · 200 OK

LATENCY · ~80ms

VERSION · v1