---
title: "SDKs and integration examples."
description: "Use the published Altss public clients for anonymous reads and the Console OpenAPI contract for authenticated paid research. Keep the two access models explicit."
canonical: "https://altss.com/console/docs/sdks-and-examples"
last-updated: "2026-11-17"
---

# SDKs and integration examples.

Use the published Altss public clients for anonymous reads and the Console OpenAPI contract for authenticated paid research. Keep the two access models explicit.

Last modified: 2026-11-17

## Choose the client for the surface

The JavaScript, Python and Go public clients read catalogs, documentation and bounded public profile summaries. Their fictional sandbox helps test public-reader behavior. Those clients do not carry Console purchase authority or turn anonymous reads into paid research. For Console, use an HTTP or MCP client that supports its current authentication and execution contract.

## Published client references

- [Public JavaScript, Python and Go clients](https://altss.com/developers): Versioned installation commands, examples and repository links.
- [Public-reader sandbox](https://altss.com/api/v1/sandbox): Fictional anonymous fixtures; no Console wallet or real paid execution.
- [Console OpenAPI schema](https://altss.com/integrations/console/openapi.json): Use the declared server, operation names, input types and response schemas.

## Quote a Console operation with JavaScript

Node.js example. Set ALTSS_API_KEY using your secret store. The code obtains a quote and makes no paid execution request.

```javascript
const key = process.env.ALTSS_API_KEY;
if (!key) throw new Error("Set an authorized Console API key");
const response = await fetch("https://console.altss.com/v1/console/quote", {
  method: "POST",
  headers: { Authorization: `Bearer ${key}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    toolId: "company.financial_research",
    input: { cik: "0000789019" }
  }),
  signal: AbortSignal.timeout(15000)
});
const body = await response.json();
if (!response.ok) throw new Error(`Quote refused (${response.status})`);
// Present the whole quote, plan and useTerms for purchaser approval.
// Preserve the returned quote unchanged for a separately authorized run.
console.log(body);
```

## Read the public capability offer with Python

A public metadata request using Python’s standard library. It does not authenticate, fund a wallet or execute research.

```python
import json
from urllib.request import Request, urlopen

request = Request("https://console.altss.com/tools.json",
                  headers={"Accept": "application/json"})
with urlopen(request, timeout=15) as response:
    catalog = json.load(response)
for tool in catalog["tools"]:
    print(tool["id"], tool["inputSchema"])
```

## Before adding the execute step

- Read the live tool catalog and validate the exact input schema.
- Obtain the purchaser’s authority for the returned quote, maximum charge and terms.
- Store one stable idempotency key per purchase and preserve it across retries.
- Keep credentials out of logs, browser bundles and source control.
- Retain run IDs, result evidence and receipts without expanding their permitted use.
- Handle timeouts by checking the existing run; do not assume a new key is a safe retry.

## Build your integration

- [Capability catalog](https://altss.com/console/capabilities)
- [REST API](https://altss.com/console/docs/api)
- [MCP](https://altss.com/console/docs/mcp)
- [A2A and agent discovery](https://altss.com/console/docs/a2a)
- [SDKs and examples](https://altss.com/console/docs/sdks-and-examples)
- [Usage and billing](https://altss.com/console/usage-and-billing)
- [Security and permissions](https://altss.com/console/security-and-permissions)

[Inspect Console OpenAPI](https://altss.com/integrations/console/openapi.json)

[Explore capabilities](https://altss.com/console/capabilities)

## Connect with the contract in view.

Start with the capability, its evidence requirements and the decision your team needs to make. Confirm the available tool and permitted use before execution.

[Read the connection guide](https://console.altss.com/connect)

[Discuss a requirement](https://altss.com/contact)

Canonical URL: https://altss.com/console/docs/sdks-and-examples

