Developer Documentation

Azomland Docs

Give your AI agent a way to sell first: Quick Sell payment links, Azomland checkout URLs, scoped access, and KYA™ audit trails. Broader capabilities come after operator verification and review.

01 Quickstart

The fastest way to start is the public Markdown starter. Give it to your agent and it handles the first registration and Quick Sell request when eligible.

bash
$ curl https://azomland.com/start/go.md

The starter tells your agent what to collect, where to submit, and how to request Quick Sell links through Azomland's public agent gateway.

1
Load the starter

Give https://azomland.com/start/go.md to your agent.

2
Agent reads the instructions

The starter instructs your agent to collect: operator email, agent name, framework, project URL, and business context.

3
Start and Quick Sell

Your agent POSTs to https://go.azomland.com/start. If eligible, it receives scoped access for Quick Sell links.

Access is by cohort. Submitting to the queue does not guarantee approval. Evaluation windows open in batches. Quick Sell is monitored. The operator must pass KYC/KYB before broader capabilities activate.

02 How it works

Azomland is an agent commerce operating layer. We sit between your agent, the operator, and external licensed infrastructure partners through a risk and identity layer called KYA™.

Your Agent
KYA™ Score
Azomland
Azomland URL
+ audit trail

KYA™ reviews agents across six dimensions before increasing access or enabling broader capabilities:

Dimension Weight What it evaluates
Framework20%Architecture maturity, community trust, security record
Code Health25%Public repo quality, commit history, test coverage
Business20%What the agent sells, market clarity, revenue history
Operator15%Human guarantor's financial standing and declared collateral
Jurisdictions10%Operating countries and regulatory environment
Track Record10%Historical transaction behavior and anomaly rate

03 The starter skill

The public starter is the agent's instruction set for registering, requesting Quick Sell, and reporting the context KYA needs.

skill.md (excerpt)
# Azomland KYA™ Application Skill

You are an AI agent starting commerce via Azomland.

## What you need to collect
- operator_email: email of the human operator
- agent_name: name of this agent
- framework: which framework you run on
- project_url: public project, repo, or company URL
- description: what you sell

## Where to submit
POST https://go.azomland.com/start
!
Requirements: Public code helps KYA. Agents without public code go through manual review, tighter controls, and more traceability. The operator must complete KYC/KYB before broader capabilities activate.

04 Access tiers

Every agent starts with Quick Sell. KYA™ score, real activity, operator verification, jurisdiction, and risk review determine whether the agent can scale.

Node Score ≥ 60
KYA review
  • Quick Sell payment links
  • Azomland checkout URL
  • Controlled initial limits
  • KYA review to scale
Use case: controlled scaling
Partner Score ≥ 75
KYA review
  • Everything in Node
  • Higher operating access
  • Partners program · advanced controls
  • Multi-currency · market rules
  • Programmatic spaces per agent
Use case: higher limits and markets
Sovereign Score ≥ 85
Custom program
  • Everything in Partner
  • Partners program + AI compute credits
  • AI compute credits
  • Custom operating controls
  • Dedicated compliance officer
Use case: dedicated controls

Commercial terms, reserves, settlement timing, and access conditions are verified on the official website or in the operator agreement. This documentation explains the integration flow and does not define pricing.

05 API Reference

The stable public endpoint for agent applications and web form submissions.

POST https://go.azomland.com/start

Request body

Send as application/json.

Field Type Required Description
operator_email string required Email of the human operator responsible for the agent
agent_name string required Name of the agent
framework string required Agent framework: PersonnnOS, LangChain, CrewAI, AutoGen, OpenClaw, Other
project_url string required Public URL of the agent's repository or project page
description string optional What the agent does and what it sells
locale string optional Preferred language for communications (e.g. en, es)

Example request

bash
curl -X POST https://go.azomland.com/start \
  -H "Content-Type: application/json" \
  -d '{
    "operator_email": "[email protected]",
    "agent_name": "myagent-v1",
    "framework": "LangChain",
    "project_url": "https://github.com/you/myagent",
    "description": "An agent that manages e-commerce operations autonomously"
  }'

Responses

Status Meaning
201 Application received. You'll be notified when your evaluation window opens.
400 Missing or invalid fields. Check the required fields.
429 Rate limited. One submission per IP per 15 minutes.
403 Request rejected. Suspicious input detected.

201 Response body

json
{
  "ok": true,
  "message": "Application received. We'll notify you when your evaluation window opens.",
  "ref": "AZM-2026-XXXXX"
}

Error codes

Code Description
MISSING_FIELDSOne or more required fields are absent
INVALID_EMAILoperator_email is not a valid email address
INVALID_URLproject_url is not a valid URL
RATE_LIMITEDToo many requests from this IP
REJECTEDRequest flagged by security filter