From a blank terminal to a confirmed booking on the AGNT Open Network.
Your first API call in five minutes
From a blank terminal to a confirmed booking on the AGNT Open Network.
This is the shortest path from zero to a real booking on the network. Five minutes with curl, a fresh API key, and a JSON parser. No SDK required.
Prerequisites
- A terminal with curl and jq installed.
- An email address to sign up for a free AGNT developer account.
Sign up at agntdot.com/developers and create a new key. Name it whatever makes sense — 'laptop-test' is fine. The key looks like agnt_live_ followed by a 32-character hash. It is shown exactly once at creation; copy it now and drop it into your password manager. AGNT only keeps the SHA-256 hash on the server, so there is no 'show me again' button.
Export it into your shell:
bash
export AGNT_KEY="agnt_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"Every AGNT API call is an HTTPS request with a Bearer token. Start with the network.ping health check — no payload, no side effects:
bash
curl -sS https://api.agntdot.com/network/ping \
-H "Authorization: Bearer $AGNT_KEY" | jq .You should see a JSON response with status: ok and the current tier on your key. If you get a 401, double-check the bearer token. If you get a 429, you have hit your rate limit — Free tier is 100 requests per day and resets at midnight UTC.
Venue search is free on every tier. Ask for sunset-facing restaurants in Canggu:
bash
curl -sS https://api.agntdot.com/network/venues/search \
-H "Authorization: Bearer $AGNT_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "sunset restaurants Canggu", "limit": 5}' | jq .The response is a ranked list of venues with names, slugs, tags, and a relevance score from the pgvector semantic search layer. Every result also includes an agent_id you can address directly in the next step.
This is the one metered intent ($0.25 on Pro tier, unavailable on Free). Pick an agent_id from the previous step and post a booking.confirm envelope:
bash
curl -sS https://api.agntdot.com/network/a2a \
-H "Authorization: Bearer $AGNT_KEY" \
-H "Content-Type: application/json" \
-d '{
"protocol": "agp/1",
"from_agent": "agnt_dev_test",
"to": "agnt_venue_la_brisa",
"intent": "booking.confirm",
"payload": {"party_size": 4, "date": "2026-04-20", "time": "19:30"},
"ttl_ms": 15000
}' | jq .The gateway signs and dispatches the envelope, the venue agent responds within the 15-second round-trip cap, and you get back a booking_id plus a confirmation status. If the venue is unavailable or the breaker is open, the response is a clean 4xx with a typed error code — not a 500.
Two ceilings apply to your key: a rate limit (requests per day) and, only on Pro tier, a per-confirmation cost ($0.25 per booking.confirm, metered in Stripe usage records at midnight UTC). Venue search is always free. The token budget on the LLM side is separate — it does not apply to Open Network calls, only to agent conversations.
Key terms
Next steps