Quickstart Guide

The Signet API lets you register autonomous AI agents, query their trust scores, and retrieve detailed trust reports. This guide walks you through your first integration in four steps.

Prerequisites

Before you begin, make sure you have:

• A Signet API key (format: sk_signet_ followed by 32 hex characters)
• curl or any HTTP client installed
• An agent you want to register

Don't have an API key yet? Request early access to get one.

Step 1: Get an API key

Your API key is issued when your waitlist application is approved. Keys follow this format:

sk_signet_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4

Keep your key secure. Include it in every authenticated request as a Bearer token in the Authorization header.

Step 2: Register your first agent

What does registering an agent do? It creates a permanent Signet ID (SID) for your agent and begins tracking its trust profile.

Send a POST request to /register with your agent's metadata:

curl -X POST https://api.agentsignet.com/register \
  -H "Authorization: Bearer sk_signet_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-trading-agent",
    "description": "Automated portfolio rebalancing agent",
    "model": "gpt-4o",
    "capabilities": ["financial-transactions", "data-analysis"]
  }'

The response includes your agent's new SID:

{
  "sid": "SID-0x7a3f8b2c1d4e5f6a7b8c9d0e1f2a3b4c",
  "name": "my-trading-agent",
  "created_at": "2025-06-15T10:30:00Z",
  "status": "active",
  "initial_score": 500
}

Your agent starts with a baseline score of 500. The score updates as transaction data flows in from integrated platforms.

Step 3: Look up a score

How do I check an agent's trust score? Use the GET /score/:sid endpoint with your API key.

curl https://api.agentsignet.com/score/SID-0x7a3f8b2c1d4e5f6a7b8c9d0e1f2a3b4c \
  -H "Authorization: Bearer sk_signet_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"

Response:

{
  "sid": "SID-0x7a3f8b2c1d4e5f6a7b8c9d0e1f2a3b4c",
  "score": 500,
  "confidence": "low",
  "recommendation": "review",
  "dimensions": {
    "reliability": 0.50,
    "quality": 0.50,
    "financial": 0.50,
    "security": 0.50,
    "stability": 0.50
  },
  "updated_at": "2025-06-15T10:30:00Z"
}

A newly registered agent will have "confidence": "low" until enough transaction data has been collected to establish a reliable score.

Step 4: Get a full report

What additional data does the full report include? The report endpoint returns everything in the score response plus operator data, configuration history, and score change logs.

curl https://api.agentsignet.com/report/SID-0x7a3f8b2c1d4e5f6a7b8c9d0e1f2a3b4c \
  -H "Authorization: Bearer sk_signet_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"

Response:

{
  "sid": "SID-0x7a3f8b2c1d4e5f6a7b8c9d0e1f2a3b4c",
  "name": "my-trading-agent",
  "score": 500,
  "confidence": "low",
  "recommendation": "review",
  "dimensions": {
    "reliability": 0.50,
    "quality": 0.50,
    "financial": 0.50,
    "security": 0.50,
    "stability": 0.50
  },
  "operator": {
    "score": 720,
    "history": "1y",
    "agents_operated": 3
  },
  "config": {
    "model": "gpt-4o",
    "version": "1.0.0",
    "last_change": null
  },
  "score_history": [],
  "created_at": "2025-06-15T10:30:00Z",
  "updated_at": "2025-06-15T10:30:00Z"
}

What's next?

• Authentication: Learn about key rotation, rate limits, and security best practices.
• API Reference: Full endpoint documentation with all request and response fields.
• Scoring: Understand how the five-dimension composite score is calculated and updated.
• Integration Guide: End-to-end walkthrough for platforms integrating Signet.