Reference

Postman collection

A pre-curated Postman 2.1 collection covering every endpoint. Works in Postman, Insomnia, and Bruno — all three speak the format.

Quick import

Copy the URL below and paste it into Postman’s Import → Link tab. Insomnia and Bruno accept the same URL via their respective import flows.

Collection URL
https://api.advisorscrypto.com/api/agent/v1/postman-collection.json

Environment variables

Configure two environment variables in your client:

  • ac_base — the base URL. Defaults to https://api.advisorscrypto.com; override for staging.
  • ac_key — your bearer token from /agent. Stored as secret in Postman / Insomnia.

What’s included

  • Read folder — whoami, mandate, holdings, audit.
  • Validate folder — policy/validate with a sensible default body.
  • Propose folder — trades/propose with an Idempotency-Key populated from Postman’s {{$randomUUID}} dynamic variable so each request gets a fresh key.
  • Public folder — health, openapi.json, disclosure. No auth.

cURL pre-flight

The same collection rendered as a single cURL command for a smoke test:

bash
curl -s https://api.advisorscrypto.com/api/agent/v1/postman-collection.json | jq '.info.name, (.item | length)'

Generate an SDK

If you’d rather generate a typed client than use the official SDK, the OpenAPI spec is at /api/agent/v1/openapi.json. Feed it to openapi-typescript, openapi-generator, or your team’s internal codegen — the contract is stable per the versioning policy.

Last updated 2026-06-15