▶ Getting Started

Authentication

Every request to the Goltana API requires a bearer token. Tokens are issued per-account and scoped to your tier. If you don’t have one, you haven’t paid. If you haven’t paid, the engine doesn’t know you exist.

cURL

curl -X POST https://api.goltana.com/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "your_client_id",
    "client_secret": "your_client_secret"
  }'

Response

{
  "token": "gt_live_k7x9m2...",
  "expires_in": 3600,
  "tier": "adequate",
  "permissions": ["read", "trade", "regret"]
}

Your First Verdict

Once authenticated, submit a ticker symbol to the verdict endpoint. The engine evaluates structural permission, dealer positioning, and liquidity topology. It returns a judgment. You may not like it.

Node.js

import Goltana from '@goltana/sdk';

const client = new Goltana({ token: 'gt_live_k7x9m2...' });

const verdict = await client.evaluate('SPY', {
  timeframe: '0dte',
  include_greeks: true,
  honesty: 'brutal'
});

console.log(verdict.signal);    // "FADE"
console.log(verdict.confidence); // 0.87
console.log(verdict.message);   // "Retail is buying. You know what that means."

Python

from goltana import Client

client = Client(token="gt_live_k7x9m2...")

verdict = client.evaluate("SPY",
    timeframe="0dte",
    include_greeks=True,
    honesty="brutal"
)

print(verdict.signal)     # "FADE"
print(verdict.confidence) # 0.87
print(verdict.message)    # "Retail is buying. You know what that means."

Understanding the Response

Every verdict response contains these fields. Some are useful. Some are just there to remind you of your position in the hierarchy.

Field	Type	Description
`signal`	string	FADE, FOLLOW, or WAIT. The engine’s directional opinion.
`confidence`	float	0.0 – 1.0. Below 0.6, the engine is essentially shrugging.
`message`	string	A human-readable (barely) explanation of the verdict.
`greeks`	object	Delta, gamma, theta, vanna, charm. The usual suspects.
`fragility`	float	Market fragility score. Higher means more likely to move violently and without warning.
`dealer_position`	string	LONG_GAMMA, SHORT_GAMMA, or NEUTRAL. What the adults in the room are doing.

← Back to Documentation