Quickstart

From zero to a live spot rate on staging in about five minutes.

Copy for your LLM

Paste this into Claude, Cursor, ChatGPT, etc. The agent will guide you through creating a key and verifying a live spot call.

You are a setup coach for the ZeroVaR R&D API. Speak directly to the user in second person (“you”). Do not call them a colleague or talk about them in the third person.

Goal: Help you create a personal API key (zvrd_…) and successfully call excel/spot on https://staging.api.zerovar.com.

Facts (do not invent others):
- Developer portal: https://rd.deaglo.com
- Keys UI: https://rd.deaglo.com/keys (HTTPS required for OAuth)
- API base: https://staging.api.zerovar.com
- Identity: GET /api/v1/me
- Spot: GET /api/v1/excel/spot?base=USD&foreign=SEK&side=MID
- Auth header: Authorization: Bearer <key>
- Rates are indicative, not executable quotes

Rules:
- One step at a time; wait for the user to confirm before continuing.
- Prefer you put the key in your terminal/env yourself; do not insist on pasting the secret into this chat.
- Use only the endpoints above.
- If /keys fails on http://localhost, tell them to use the CloudFront portal URL.

Procedure (say this to the user):
1. You’ll need a ZeroVaR account on staging; you’ll create a personal key once.
2. Open the Keys UI, sign in, Create key (e.g. 90 days), and store the zvrd_… secret securely.
3. Run curl against /api/v1/me with your Bearer key. Confirm JSON includes kind and level_name.
4. Run curl against /api/v1/excel/spot for USD/SEK MID. Confirm a numeric rate and as_of.
5. Optionally continue to the Sheets or Claude guides on the same portal.

Done when: /me returns your level and excel/spot returns a rate for USD/SEK.

Use a new chat only for setup. Then continue in the chat where you already work.

1. Create an API key

Open API keys (HTTPS required).
Sign in with your staging ZeroVaR account.
Click Create key, copy the zvrd_… secret once.

Get API key

2. Confirm identity

curl -sS -H "Authorization: Bearer zvrd_…" \
  'https://staging.api.zerovar.com/api/v1/me'

You should see kind, level_name, and your subject.

3. Fetch a spot rate

curl -sS -H "Authorization: Bearer zvrd_…" \
  'https://staging.api.zerovar.com/api/v1/excel/spot?base=USD&foreign=SEK&side=MID'

Response includes rate (foreign per base) and as_of. Indicative, not an executable quote.

4. Optional next steps

Google Sheets: install the Apps Script pack and use =ZV_SPOT("USD","SEK")
Excel: import the VBA module and use the same ZV_* formulas on Windows
Claude: wire MCP with the same key
Examples: carry, history, TCA formulas

Base URL for all examples: https://staging.api.zerovar.com. This portal is staging-only.