valr-exchange

Automate VALR REST API requests for market data, orders, and balances.

11|1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/valrdotcom/valr-agent-skills --skill valr-exchange
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: valr-exchange
Source: https://github.com/valrdotcom/valr-agent-skills/tree/main
Command: npx skills add https://github.com/valrdotcom/valr-agent-skills --skill valr-exchange

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

AI agents require access to VALR for live data and trading actions without exposing secrets or manual steps.

Core Features & Use Cases

  • Live data access: pull current market data, order books, and summaries.
  • Trading actions: place, modify, cancel orders, and view statuses for spot and perpetual futures.
  • Account visibility: check balances, subaccount status, and wallet history (including VALR Pay flows).

Quick Start

Query your BTC balance on VALR using the signed API script.

Frequently Asked Questions about valr-exchange

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate VALR API trading actions without exposing my API secrets?

Automating VALR API trading uses a Python script to sign requests with HMAC-SHA512, reading credentials from environment variables to keep secrets secure while placing orders and fetching balances.

How do I authenticate a VALR API request using HMAC-SHA512?

Authenticating a VALR API request requires an API key and secret to sign the payload with HMAC-SHA512. The included Python script handles this signing automatically using your stored credentials.

Can I use a subaccount API key to fetch VALR balances and place orders?

Yes, subaccount API keys work for VALR API scoping. The script supports both main and subaccount-level keys to retrieve balances, place orders, and manage subaccount status deterministically.

What VALR market data can I retrieve through public API endpoints?

Public VALR API endpoints provide live market data access, allowing you to pull current market summaries and order books without requiring API key authentication or signed requests.

How do I manage spot and perpetual futures orders on VALR via an AI agent?

Managing spot and perpetual futures orders on VALR involves executing authenticated API requests to place, modify, cancel, and view order statuses directly through the agent's environment.

What environment variables do I need to set up VALR API authentication?

VALR API authentication requires setting environment variables for your credentials, specifically VALR_API_KEY and VALR_API_SECRET, or the combined VALR_API_KEY_SECRET_COMBINED variable.