VALR provides a powerful API consisting of REST endpoints for transactional operations and a complementary WebSocket service providing streaming market, order, and balance updates.
\nAccess to and use of the API is governed by our Terms of Service.
\nIf you have any API questions, feedback, or recommendations please post a question via our support center.
\nWith our API, you can:
\nAccess current and historic market data
\nSubmit trade orders
\nBuy and sell over 60 cryptocurrencies
\nWithdraw cryptocurrencies from your wallets
\nWithdraw fiat from your VALR wallet
\nKeep the following in mind when developing against the VALR API:
\nEnable 2FA on your account. API Keys cannot be generated unless 2FA is enabled.
\nAll REST requests must be sent using the application/json content-type. Non-HTTPS requests are not allowed.
All REST requests will result in HTTP response codes in the range 200-299, unless there is a server or infrastructure error. The API result will be wrapped in a JSON Result object.
\nReceiving a response with an ID does not necessarily mean the order has been placed. If the response status is 202 Accepted, check the order status using either the Order Status REST API or the WebSocket API for real-time updates.
\nRequests that are made to the Authenticated API without an API key will be rejected with an HTTP response code 403.
Any POST, PUT or PATCH HTTP request that is made without the content-type: application/json header will be rejected with an HTTP response code 403.
Our AI Agent skill gives AI coding agents the context and tools to interact with the VALR API — no prior knowledge of VALR's authentication scheme or endpoints required. It works with any agent that supports the Agent Skills specification, including OpenClaw, Claude Code, and others.
\nTo explore our docs with AI support, CLICK HERE.
\nAuthenticating to the VALR API requires a valid API Key. API Keys have scoped permissions:
\nView access - This option grants the API Key permission only to view balances, orders, and other details of the account.
\nTrade - This option grants the API Key permission to place buy and sell orders.
\nTransfer - This option grants the API Key permission to transfer funds between primary and subaccounts.
\nWithdraw - This option grants the API Key permission to programatically withdraw a currency to an address or a bank account you provide.
\nLink Bank Account - This option grants the API Key permission to programmatically link bank accounts for fiat deposits and withdrawals.
\nIf you have enabled 2FA you can view existing API Keys or generate new API Keys with the appropriate permissions. Find the API Keys in the account drop-down menu. We strongly recommend minimizing the scope of any given API key to limit the impact of a compromised key/secret pair.
The generated API Key and the corresponding secret are each 64-character long and are made up of numbers and letters. An API Key/API Secret will look similar to the example provided below:
\nExample API Key/API Secret: b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33
Your API Key identifies your account (think of it as a username) and the API Secret authenticates your account (think of it as a password). Please follow the instructions below to secure your API Key and API Secret:
\nDo not send your API Secret with your API requests. Only send the API Key.
\nDo not share your API Secret or the API Key with anyone.
\nDo not commit your API Secret into source control systems like github.
\nIf you lose your API Key or Secret, immediately delete it from your Setting page.
\nPlease take note that if your API Secret is compromised, your funds are at risk.
\nAuthenticated calls require you to send a request signature with every request. This signature should be re-generated for every request. The request signature is generated by first concatenating the following values in the order given below and creating a SHA512 HMAC hash using your API Secret:
The NodeJS example below has a method called signRequest that generates a request signature which must be passed along with every request that needs authentication:
const crypto = require('crypto');\nfunction signRequest(apiSecret, timestamp, verb, path, body = '') {\n return crypto\n .createHmac(\"sha512\", apiSecret)\n .update(timestamp.toString())\n .update(verb.toUpperCase())\n .update(path)\n .update(body)\n .digest(\"hex\");\n}\n\nGolang example:
\nfunc signRequest(apiSecret string, timestamp time.Time, verb string, path string, body string) string {\n // Create a new Keyed-Hash Message Authentication Code (HMAC) using SHA512 and API Secret\n mac := hmac.New(sha512.New, []byte(apiSecret))\n // Convert timestamp to nanoseconds then divide by 1000000 to get the milliseconds\n timestampString := strconv.FormatInt(timestamp.UnixNano()/1000000, 10)\n mac.Write([]byte(timestampString))\n mac.Write([]byte(strings.ToUpper(verb)))\n mac.Write([]byte(path))\n mac.Write([]byte(body))\n // Gets the byte hash from HMAC and converts it into a hex string\n return hex.EncodeToString(mac.Sum(nil))\n}\n\nC# example:
\nusing System;\nusing System.Text;\nusing System.Security.Cryptography;\npublic static \nstring signRequest(string apiKeySecret, string timestamp, string verb, string path, string body = \"\")\n{\n var payload = timestamp + verb.ToUpper() + path + body;\n byte[] payloadBytes = Encoding.UTF8.GetBytes(payload);\n using (HMACSHA512 hmac = new HMACSHA512(Encoding.UTF8.GetBytes(apiKeySecret))) \n {\n byte[] hash = hmac.ComputeHash(payloadBytes);\n return toHexString(hash);\n }\n}\nprivate static \nstring toHexString(byte[] hash)\n{\n StringBuilder result = new StringBuilder(hash.Length * 2);\n foreach(var b in hash)\n {\n result.Append(b.ToString(\"x2\"));\n }\n return result.ToString();\n}\n/* Timestamp in milliseconds. \n * The same timestamp should be used to generate request signature\n * as well as sent along in the X-VALR-TIMESTAMP header of the request\n */\nprivate static \nstring getTimestamp()\n{\n return DateTimeOffset.UtcNow.ToUnixTimeMilliseconds().ToString();\n}\n\nPython 3.x example:
\nimport time\nimport hashlib\nimport hmac\ndef sign_request(api_key_secret, timestamp, verb, path, body = \"\"):\n \"\"\"Signs the request payload using the api key secret\n api_key_secret - the api key secret\n timestamp - the unix timestamp of this request e.g. int(time.time()*1000)\n verb - Http verb - GET, POST, PUT or DELETE\n path - path excluding host name, e.g. '/v1/withdraw\n body - http request body as a string, optional\n \"\"\"\n payload = \"{}{}{}{}\".format(timestamp,verb.upper(),path,body)\n message = bytearray(payload,'utf-8')\n signature = hmac.new( bytearray(api_key_secret,'utf-8'), message, digestmod=hashlib.sha512).hexdigest()\n return signature\n\nJava example:
\nimport javax.crypto.Mac;\nimport javax.crypto.spec.SecretKeySpec;\nimport java.security.InvalidKeyException;\nimport java.security.NoSuchAlgorithmException;\nimport java.time.Clock;\n /**\n * Signs the request payload using the api key secret\n *\n * @param apiKeySecret - the api key secret\n * @param timestamp - the unix timestamp of this request e.g. Clock.systemUTC().millis()\n * @param verb - Http verb - GET, POST, PUT or DELETE\n * @param path - path excluding host name, e.g. '/v1/withdraw'\n * @param body - http request body as a string, optional\n * @return the signature of the request\n */\n public static String signRequest(String apiKeySecret, String timestamp, String verb, String path, String body) {\n try {\n Mac hmacSHA512 = Mac.getInstance(\"HmacSHA512\");\n SecretKeySpec secretKeySpec = new SecretKeySpec(apiKeySecret.getBytes(), \"HmacSHA512\");\n hmacSHA512.init(secretKeySpec);\n hmacSHA512.update(timestamp.getBytes());\n hmacSHA512.update(verb.toUpperCase().getBytes());\n hmacSHA512.update(path.getBytes());\n hmacSHA512.update(body.getBytes());\n byte[] digest = hmacSHA512.doFinal();\n return toHexString(digest);\n } catch (NoSuchAlgorithmException | InvalidKeyException e) {\n throw new RuntimeException(\"Unable to sign request\", e);\n }\n }\n public static String toHexString(byte[] a) {\n StringBuilder sb = new StringBuilder(a.length * 2);\n for (byte b : a)\n sb.append(String.format(\"\u0002x\", b));\n return sb.toString();\n }\n\nIf you choose to write your own method to generate a request signature, please use the following test data:
If you provide the above values, your method should generate the following HMAC SHA512 signature using your API Secret:
\n9d52c181ed69460b49307b7891f04658e938b21181173844b5018b2fe783a6d4c62b8e67a03de4d099e7437ebfabe12c56233b73c6a0cc0f7ae87e05f6289928
If you provide the above values, your method should generate the following HMAC SHA512 signature using your API Secret:
\n09f536e3dfdad58443f16010a97a0a21ad27486b7b8d6d4103170d885410ed77f037f1fa628474190d4f5c08ca12c1acc850901f1c2e75c6d906ec3b32b008d0
Follow the instructions below to make an authenticated API call:
\nCreate a SHA512 HMAC hash using your API Secret and the values pertaining to your request (timestamp, HTTP verb, API path, body, subaccountId - when impersonating a subaccount) detailed above.
\nREST: Include the following headers in each request:
\nX-VALR-API-KEY : Your API Key
\nX-VALR-SIGNATURE : The request signature that was generated for your request (see point 1)
X-VALR-TIMESTAMP : The same timestamp used to generate the request signature
X-VALR-SUB-ACCOUNT-ID (Optional): A Primary account API key can impersonate a subaccount by specifying the subaccountId in this header. This allows the primary account to transact on the impersonated subaccount. Remember to add the subaccountId in the request signature as well.
\nWebSocket: Pass in the same three headers to the first call that establishes the WebSocket connection. (See WebSocket API section below for details)
You can run our API collection in Postman using the button \"Run in Postman\" above. This collection already includes the following items for your convenience:
\nA pre-request script that runs before every request to generate your request signature and timestamp.
\nThe three authentication headers pre-populated with the right environment variables for each request.
\nIn order to start with Postman, please create a new Environment in Postman and add two variables and name them yourApiKey and yourApiSecret. Provide appropriate initial values for these variables. That is, your Api Key and Api Secret for your account. Enable this environment while running your requests. That is all!
(Optional): To impersonate an account add the X-VALR-SUB-ACCOUNT-ID header to the request. To add the X-VALR-SUB-ACCOUNT-ID header to every request, define the yourSubAccountId variable in your Environment. If you provide the header on the request and also define the environment variable, the header will take precedence. Note that some requests do not allow impersonation.
The pre-request script will populate the following two variables in your environment with the correct values:
\nrequestSignature
requestTimestamp
The script is provided below for your convenience:
\n/* Pre-requisite\n==================\n1) Create a new Environment in Postman.\n2) Add two variables: \"yourApiKey\" and \"yourApiSecret\" to the Environment. Provide appropriate initial values for these variables. That is, the Api Key and Api Secret for your account.\n3) Enable this environment for your requests.\n4) For each request, this script generates the following two new environment variables:\n* requestSignature\n* requestTimestamp\n5) Ensure that the following three headers are sent with every request:\nX-VALR-API-KEY: b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33\nX-VALR-SIGNATURE: {{requestSignature}}\nX-VALR-TIMESTAMP: {{requestTimestamp}}\nSubaccounts\n==================\nTo perform a request impersonating a specific subaccount, the subaccount ID must be provided. The ID can be determined by using `Account/Subaccounts/Retrieve Subaccounts`. Once the ID is determined, it can be added to the request by either adding the `X-VALR-SUB-ACCOUNT-ID` header, with the ID as value, to the request directly, or by adding the variable {{yourSubAccountId}} to the Postman Environment. If both are provided, the header has precedence. If the variable is provided it will be added to every request.\nPlease note: Requests that may only be performed on the Primary account will fail with a \"401: Unauthorized\" response if the subaccount ID is included.\n*/\nvar YOUR_API_KEY = postman.getEnvironmentVariable('yourApiKey');\nvar YOUR_API_SECRET = postman.getEnvironmentVariable('yourApiSecret');\nvar subAccountHeader = pm.request.headers.find((header) => header.key === 'X-VALR-SUB-ACCOUNT-ID' && !header.disabled)\nvar YOUR_SUB_ACCOUNT_ID = subAccountHeader ? subAccountHeader.value \n : postman.getEnvironmentVariable('yourSubAccountId');\nvar requestTimestamp = (new Date()).getTime();\nfunction getPath(url) {\n var pathRegex = /(?:.+?\\:\\/\\/.+?)?(\\/.+)/;\n var result = url.match(pathRegex);\n return result && result.length > 1 ? result[1] : ''; \n}\nfunction getHmacDigest(httpMethod, requestUrl, requestBody) {\n var requestPath = getPath(requestUrl.toString());\n if (httpMethod == 'GET' || !requestBody) {\n requestBody = ''; \n } \n var requestData = [requestTimestamp, httpMethod.toUpperCase(), requestPath, requestBody, YOUR_SUB_ACCOUNT_ID].join(\"\");\n var hmacDigest = CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(requestData, YOUR_API_SECRET));\n return hmacDigest;\n}\npostman.setEnvironmentVariable('requestSignature', getHmacDigest(pm.request.method, pm.request.url, pm.request.body));\npostman.setEnvironmentVariable('requestTimestamp', requestTimestamp);\nif (YOUR_SUB_ACCOUNT_ID && YOUR_SUB_ACCOUNT_ID > 0 && !subAccountHeader) {\n pm.request.headers.add({ key: 'X-VALR-SUB-ACCOUNT-ID', value: `${YOUR_SUB_ACCOUNT_ID}` });\n}j\n\nRate Limits
\nRate limits depend on the connection type used. REST and WebSocket connections are governed differently, but all limits reset at the start of each minute.
\nREST (HTTP) API
\nREST requests are limited by both API key and IP address. Both limits apply at the same time.
\n2000 requests per minute per API key.
\n1200 requests per minute per IP address.
\nIf either limit is exceeded, the request is rejected with:
HTTP Status Code
429 Too Many Requests
WebSockets
\nWebSocket rate limits are enforced per IP address only.
\nAPI key limits do not apply.
\nAll connections from the same IP share a single limit pool.
\nMultiple bots or accounts on the same server will not increase throughput.
\nIf the WebSocket rate limit is exceeded, the server will send:
\n{
\"type\": \"RATE_LIMIT_EXCEEDED\"
}
Reset Policy
\nAll limits reset every minute.
\nExample 1: You are allowed to do 1000 calls from 10:10:00 to 10:10:59. When the time changes to 10:11:00, the counter will be reset and will start over.
\nExample 2: If the first request comes in at 10:10:30, the counter will be reset at 10:11:00.
\nTo ensure that users are able to place and cancel orders at a higher rate, per second rate limits are applied on certain API routes, with the limit reset at the start of the next second. Here the limits per IP and key do not apply:
\nPublic calls v1:
\nRoute: /v1/public/*
\nMethod: GET
Rate limit: 30/m
\nPublic time v1:
\nRoute: /v1/public/time
\nMethod: GET
Rate limit: 20/s
\nPublic status v1:
\nRoute: /v1/public/status
\nMethod: GET
Rate limit: 20/s
\nPublic buckets v1:
\nRoute: /v1/public/*/buckets
\nMethod: GET
Rate limit: 20/s
\nBatch orders v1:
\nRoute /v1/batch/orders
\nMethod: POST
Rate limit: 400/s
\nDelete orders v1:
\nRoute /v1/orders
\nMethod: DELETE
Rate limit: 450/s
\nPost orders v1:
\nRoute /v1/orders
\nMethod: POST
Rate limit: 400/s
\nBatch orders v2:
\nRoute /v2/orders/modify
\nMethod: PUT
Rate limit: 400/s
\nLoans v1:
\nRoute /v1/loans/*
\nMethod: POST, PUT, DELETE
Rate limit: 1/s
\nCreate sub account v1:
\nRoute /v1/account/subaccount
\nMethod: POST
Rate limit: 1/s
\nSub account transfer v1:
\nRoute /v1/account/subaccount/transfer
\nMethod: POST
Rate limit: 20/s
\nWebSocket new clients:
\nRoute: /ws
\nRate limit: 60/m
\nWebSocket account write:
\nRoute: /ws/account
\nPlace: 400 p/s
\nCancel: 450p/s
\nBatch: 400p/s
\nModify: 400p/s
\nWe may reduce limits when the system is under severe pressure.
\nWebSocket connections offer significantly faster data transmission than HTTP due to their persistent, open TCP socket. This allows for efficient, real-time communication.
Batching can further enhance performance, though the benefit is less pronounced with WebSockets compared to HTTP.
The OB_L1_DIFF WebSocket feed provides the most rapid updates for order book changes. Its smaller data packets minimize overhead for clients, servers, and network transmission.
\nA WebSocket connection is the fastest method for receiving order processing and status updates. Most unfiltered HTTP requests for order status are served from memory, but updates via WebSockets in normal conditions should still be superior.
\nExcluding geographic distance and demand, the total round trip time from placing the order via WebSocket to receiving the order place outcome on a WebSocket connection should be approximately 8ms. This number is a rough estimate and can vary as we constantly update our service or due to other constraints.
\nIn order to improve the latency of requests and reduce the load on servers, some GET requests are cached by default.
We use the HTTP Cache-Control Header, which comprises one or more comma separated directives. These directives determine whether a GET response is cachable, and if so, the duration.
Here's an example of an HTTP Response Header:
\ncache-control: max-age=60,public
cache-control: max-age - defines the amount of time it takes for a cached copy of a resource to expire, in seconds.
\ncache-control: public - means that a resource can be cached by any cache.
\nBelow are the GET endpoints that are cached, and their max-age in seconds.
\n*Public Routes*\n===============\n/marketsummary (60)\n/:currencypair/marketsummary (10)\n/currencies (60)\n/pairs(60)\n/:currencyPair/orderbook (30)\n/:currencyPair/orderbook/full (30)\n/:currencyPair/trades (30)\n/ordertypes (60)\n/:currencypair/ordertypes (60)\n*Authenticated Routes*\n======================\n/marketdata (1)\n/fiat/:currency/banks (600)\n/fiat/:currency/auto-buy (60)\n/portfolio (1)\n\nSpecify the currency pair for which you would like to view the available leverage options.\nExample: ETHUSDTPERP
\n","type":"text/plain"},"type":"any","value":"","key":"currencypair"}]}},"response":[{"id":"93990317-43a1-457b-9e86-ddc7faf0a389","name":"Available Leverage Options (Valid Currency Pair)","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.valr.com/v1/public/risklimit/:currencypair","host":["https://api.valr.com"],"path":["v1","public","risklimit",":currencypair"],"variable":[{"key":"currencypair","value":"BTCUSDTPERP","description":"Specify the currency pair for which you would like to view the available leverage options.\nExample: ETHUSDTPERP"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"cache-control","value":"max-age=120,public"},{"key":"x-valr-upstream-service-time","value":"10"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Wed, 16 Jul 2025 11:48:01 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 1,\n \"initialMarginFraction\": 1,\n \"maintenanceMarginFraction\": 0.25,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 1500000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 2,\n \"initialMarginFraction\": 0.5,\n \"maintenanceMarginFraction\": 0.25,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 1500000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 3,\n \"initialMarginFraction\": 0.3333,\n \"maintenanceMarginFraction\": 0.1,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 1000000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 4,\n \"initialMarginFraction\": 0.25,\n \"maintenanceMarginFraction\": 0.1,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 1000000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 5,\n \"initialMarginFraction\": 0.2,\n \"maintenanceMarginFraction\": 0.1,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 1000000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 6,\n \"initialMarginFraction\": 0.1666,\n \"maintenanceMarginFraction\": 0.05,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 750000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 7,\n \"initialMarginFraction\": 0.1428,\n \"maintenanceMarginFraction\": 0.05,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 750000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 8,\n \"initialMarginFraction\": 0.125,\n \"maintenanceMarginFraction\": 0.05,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 750000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 9,\n \"initialMarginFraction\": 0.1111,\n \"maintenanceMarginFraction\": 0.05,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 750000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 10,\n \"initialMarginFraction\": 0.1,\n \"maintenanceMarginFraction\": 0.05,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 750000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": true\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 11,\n \"initialMarginFraction\": 0.0909,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 12,\n \"initialMarginFraction\": 0.0833,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 13,\n \"initialMarginFraction\": 0.0769,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 14,\n \"initialMarginFraction\": 0.0714,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 15,\n \"initialMarginFraction\": 0.0666,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 16,\n \"initialMarginFraction\": 0.0625,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 17,\n \"initialMarginFraction\": 0.0588,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 18,\n \"initialMarginFraction\": 0.0555,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 19,\n \"initialMarginFraction\": 0.0526,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 20,\n \"initialMarginFraction\": 0.05,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 21,\n \"initialMarginFraction\": 0.0476,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 22,\n \"initialMarginFraction\": 0.0454,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 23,\n \"initialMarginFraction\": 0.0434,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 24,\n \"initialMarginFraction\": 0.0416,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 25,\n \"initialMarginFraction\": 0.04,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 26,\n \"initialMarginFraction\": 0.0384,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 27,\n \"initialMarginFraction\": 0.037,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 28,\n \"initialMarginFraction\": 0.0357,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 29,\n \"initialMarginFraction\": 0.0344,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 30,\n \"initialMarginFraction\": 0.0333,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 31,\n \"initialMarginFraction\": 0.0322,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 32,\n \"initialMarginFraction\": 0.0312,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 33,\n \"initialMarginFraction\": 0.0303,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 34,\n \"initialMarginFraction\": 0.0294,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 35,\n \"initialMarginFraction\": 0.0285,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 36,\n \"initialMarginFraction\": 0.0277,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 37,\n \"initialMarginFraction\": 0.027,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 38,\n \"initialMarginFraction\": 0.0263,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 39,\n \"initialMarginFraction\": 0.0256,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 40,\n \"initialMarginFraction\": 0.025,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 41,\n \"initialMarginFraction\": 0.0243,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 42,\n \"initialMarginFraction\": 0.0238,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 43,\n \"initialMarginFraction\": 0.0232,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 44,\n \"initialMarginFraction\": 0.0227,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 45,\n \"initialMarginFraction\": 0.0222,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 46,\n \"initialMarginFraction\": 0.0217,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 47,\n \"initialMarginFraction\": 0.0212,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 48,\n \"initialMarginFraction\": 0.0208,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 49,\n \"initialMarginFraction\": 0.0204,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 50,\n \"initialMarginFraction\": 0.02,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 51,\n \"initialMarginFraction\": 0.0196,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 52,\n \"initialMarginFraction\": 0.0192,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 53,\n \"initialMarginFraction\": 0.0188,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 54,\n \"initialMarginFraction\": 0.0185,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 55,\n \"initialMarginFraction\": 0.0181,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 56,\n \"initialMarginFraction\": 0.0178,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 57,\n \"initialMarginFraction\": 0.0175,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 58,\n \"initialMarginFraction\": 0.0172,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 59,\n \"initialMarginFraction\": 0.0169,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 60,\n \"initialMarginFraction\": 0.0166,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n }\n]"},{"id":"2ee14764-6880-496d-b1d1-33bd1be3afdc","name":"Available Leverage Options (Invalid Currency Pair)","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.valr.com/v1/public/risklimit/:currencypair","host":["https://api.valr.com"],"path":["v1","public","risklimit",":currencypair"],"variable":[{"key":"currencypair","value":"BTCETHPERP","description":"Specify the currency pair for which you would like to view the available leverage options.\nExample: ETHUSDTPERP"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 26 Mar 2025 15:07:03 GMT"},{"key":"cache-control","value":"max-age=120,public"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"1"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -21,\n \"message\": \"Unsupported Currency Pair\"\n}"}],"_postman_id":"7cd0e8c3-8a5e-4194-9680-29457ac3de7a"},{"name":"Currencies","id":"88ab52a2-d63b-48b2-8984-d0982baec40a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/currencies","description":"Get a list of currencies supported by VALR.
\nA currency may optionally expose:
\ndefaultNetworkType - the network type identifier that will be used if a network type is not specified on a deposit request or a withdrawal request via the API.
\nsupportedNetworks - a list of networks that are available to use for deposits and/or withdrawals for a given currency.
\nNOTE
\nIf a currency does not expose any supported networks, it means that both withdrawals and deposits are not available for the specified currency on VALR.
\nIf a currency does expose supported networks, either both withdrawals and deposits are available, or one of withdrawals or deposits is not available for that network. This can be determined using the deposit and withdraw properties on each network in supportedNetworks.
For withdrawals, the withdrawalDecimalPlaces specified on the supportedNetworks level is the maximum scale of the value that will be submitted to the network and will be rounded down to that scale if a value with a larger scale is provided.
This is a public API and therefor the values are cached. In particular estimatedSendCost may be out of date. For an up to date estimation of the cost to withdraw crypto on-chain, refer to the withdrawCost field of the Wallets / Crypto / Withdrawal Config Info API.
Example 1: Withdrawals and Deposits are available on the Ethereum and StellarLumens network for USDC on VALR
\n{\n \"symbol\": \"USDC\",\n \"isActive\": true,\n \"shortName\": \"USDC\",\n \"longName\": \"USD Coin\",\n \"decimalPlaces\": \"2\",\n \"withdrawalDecimalPlaces\": \"2\",\n \"collateral\": true,\n \"collateralWeight\": \"1\",\n \"defaultNetworkType\": \"Ethereum\",\n \"supportedNetworks\": [\n {\n \"networkType\": \"StellarLumens\",\n \"networkLongName\": \"StellarLumens\",\n \"tokenContract\": \"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN\",\n \"minimumWithdrawAmount\": \"1.0002981\",\n \"estimatedSendCost\": \"0.11\",\n \"deposit\": true,\n \"withdraw\": true,\n \"withdrawalDecimalPlaces\": \"7\"\n },\n {\n \"networkType\": \"Ethereum\",\n \"networkLongName\": \"Ethereum\",\n \"tokenContract\": \"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\",\n \"minimumWithdrawAmount\": \"6.001789\",\n \"estimatedSendCost\": \"17\",\n \"deposit\": true,\n \"withdraw\": true,\n \"withdrawalDecimalPlaces\": \"6\"\n }\n ]\n}\n\nExample 2: Withdrawals and Deposits are not available for PAY on any network on VALR
\n{\n \"symbol\": \"PAY\",\n \"isActive\": false,\n \"shortName\": \"PAY\",\n \"longName\": \"TenX Pay Token\",\n \"decimalPlaces\": \"18\",\n \"withdrawalDecimalPlaces\": \"8\",\n \"collateral\": false,\n \"collateralWeight\": \"0.0\"\n}\n\nExample 3: Withdrawals and Deposits are available on the Ethereum network, but only deposits are available on the Avalanche C-Chain network for USDC on VALR
\n{\n \"symbol\": \"USDC\",\n \"isActive\": true,\n \"shortName\": \"USDC\",\n \"longName\": \"USD Coin\",\n \"decimalPlaces\": \"2\",\n \"withdrawalDecimalPlaces\": \"2\",\n \"collateral\": true,\n \"collateralWeight\": \"1\",\n \"defaultNetworkType\": \"Ethereum\",\n \"supportedNetworks\": [\n {\n \"networkType\": \"Ethereum\",\n \"networkLongName\": \"Ethereum\",\n \"tokenContract\": \"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\",\n \"deposit\": true,\n \"withdraw\": true\n \"withdrawalDecimalPlaces\": \"6\"\n },\n {\n \"networkType\": \"Avalanche\",\n \"networkLongName\": \"Avalanche C-Chain\",\n \"tokenContract\": \"0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E\",\n \"deposit\": true,\n \"withdraw\": false\n \"withdrawalDecimalPlaces\": \"6\"\n }\n ]\n}\n\nGet a list of all the currency pairs supported by VALR.
\n","urlObject":{"path":["v1","public","pairs"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"38d141e9-d0f7-47a5-9fc8-08ff5d33b2e1","name":"Currency Pairs","originalRequest":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/pairs"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"1"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"n/a"},{"key":"Via","value":"1.1 google"},{"key":"Date","value":"Tue, 17 Jun 2025 11:36:46 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Content-Length","value":"21498"},{"key":"Age","value":"57"},{"key":"Cache-Control","value":"max-age=60,public"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"symbol\": \"ETHZAR\",\n \"baseCurrency\": \"ETH\",\n \"quoteCurrency\": \"ZAR\",\n \"shortName\": \"ETH/ZAR\",\n \"active\": true,\n \"minBaseAmount\": \"0.0002\",\n \"maxBaseAmount\": \"69.21\",\n \"minQuoteAmount\": \"10\",\n \"maxQuoteAmount\": \"5000000\",\n \"tickSize\": \"1\",\n \"baseDecimalPlaces\": \"8\",\n \"marginTradingAllowed\": true,\n \"currencyPairType\": \"SPOT\",\n \"initialMarginFraction\": \"0.2\",\n \"maintenanceMarginFraction\": \"0.1\",\n \"autoCloseMarginFraction\": \"0.033333333\"\n },\n {\n \"symbol\": \"BNBUSDC\",\n \"baseCurrency\": \"BNB\",\n \"quoteCurrency\": \"USDC\",\n \"shortName\": \"BNB/USDC\",\n \"active\": true,\n \"minBaseAmount\": \"0.0008\",\n \"maxBaseAmount\": \"80\",\n \"minQuoteAmount\": \"0.52\",\n \"maxQuoteAmount\": \"52000\",\n \"tickSize\": \"0.1\",\n \"baseDecimalPlaces\": \"4\",\n \"marginTradingAllowed\": false,\n \"currencyPairType\": \"SPOT\"\n },\n {\n \"symbol\": \"SHIBUSDC\",\n \"baseCurrency\": \"SHIB\",\n \"quoteCurrency\": \"USDC\",\n \"shortName\": \"SHIB/USDC\",\n \"active\": true,\n \"minBaseAmount\": \"44600\",\n \"maxBaseAmount\": \"2750000000\",\n \"minQuoteAmount\": \"0.59\",\n \"maxQuoteAmount\": \"50000\",\n \"tickSize\": \"0.00000001\",\n \"baseDecimalPlaces\": \"0\",\n \"marginTradingAllowed\": false,\n \"currencyPairType\": \"SPOT\"\n },\n {\n \"symbol\": \"LTCBTC\",\n \"baseCurrency\": \"LTC\",\n \"quoteCurrency\": \"BTC\",\n \"shortName\": \"LTC/BTC\",\n \"active\": false,\n \"minBaseAmount\": \"0.0043\",\n \"maxBaseAmount\": \"15.67\",\n \"minQuoteAmount\": \"0.000016\",\n \"maxQuoteAmount\": \"0.0512\",\n \"tickSize\": \"0.000001\",\n \"baseDecimalPlaces\": \"8\",\n \"marginTradingAllowed\": false,\n \"currencyPairType\": \"SPOT\"\n },\n {\n \"symbol\": \"LTCETH\",\n \"baseCurrency\": \"LTC\",\n \"quoteCurrency\": \"ETH\",\n \"shortName\": \"LTC/ETH\",\n \"active\": false,\n \"minBaseAmount\": \"0.0237\",\n \"maxBaseAmount\": \"15.67\",\n \"minQuoteAmount\": \"0.0081\",\n \"maxQuoteAmount\": \"0.7576\",\n \"tickSize\": \"0.00000001\",\n \"baseDecimalPlaces\": \"8\",\n \"marginTradingAllowed\": false,\n \"currencyPairType\": \"SPOT\"\n },\n {\n \"symbol\": \"ETHUSDTPERP\",\n \"baseCurrency\": \"ETH\",\n \"quoteCurrency\": \"USDT\",\n \"shortName\": \"ETH/USDTPERP\",\n \"active\": true,\n \"minBaseAmount\": \"0.001\",\n \"maxBaseAmount\": \"32\",\n \"minQuoteAmount\": \"1\",\n \"maxQuoteAmount\": \"100000\",\n \"tickSize\": \"0.1\",\n \"baseDecimalPlaces\": \"3\",\n \"marginTradingAllowed\": false,\n \"currencyPairType\": \"FUTURE\",\n \"initialMarginFraction\": \"0.025\",\n \"maintenanceMarginFraction\": \"0.0125\",\n \"autoCloseMarginFraction\": \"0.0125\"\n },\n {\n \"symbol\": \"BTCUSDCPERP\",\n \"baseCurrency\": \"BTC\",\n \"quoteCurrency\": \"USDC\",\n \"shortName\": \"BTC/USDCPERP\",\n \"active\": false,\n \"minBaseAmount\": \"0.0001\",\n \"maxBaseAmount\": \"35\",\n \"minQuoteAmount\": \"1\",\n \"maxQuoteAmount\": \"1000000\",\n \"tickSize\": \"1\",\n \"baseDecimalPlaces\": \"4\",\n \"marginTradingAllowed\": false,\n \"currencyPairType\": \"FUTURE\",\n \"initialMarginFraction\": \"0.2\",\n \"maintenanceMarginFraction\": \"0.1\",\n \"autoCloseMarginFraction\": \"0.033333333\"\n },\n {\n \"symbol\": \"WIFUSDTPERP\",\n \"baseCurrency\": \"WIF\",\n \"quoteCurrency\": \"USDT\",\n \"shortName\": \"WIF/USDTPERP\",\n \"active\": false,\n \"minBaseAmount\": \"1\",\n \"maxBaseAmount\": \"10000\",\n \"minQuoteAmount\": \"1\",\n \"maxQuoteAmount\": \"25000\",\n \"tickSize\": \"0.0001\",\n \"baseDecimalPlaces\": \"0\",\n \"marginTradingAllowed\": false,\n \"currencyPairType\": \"FUTURE\",\n \"initialMarginFraction\": \"0.2\",\n \"maintenanceMarginFraction\": \"0.1\",\n \"autoCloseMarginFraction\": \"0.033333333\"\n }\n]"}],"_postman_id":"cfa57d7e-2106-4066-bc27-c10210b6aa82"},{"name":"Currency Pairs By Type","id":"c81d7f37-3bb1-4cca-ae83-0f02fac8f52a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/pairs/:type","description":"Get a list of all the currency pairs supported by VALR.
\n","urlObject":{"path":["v1","public","pairs",":type"],"host":["https://api.valr.com"],"query":[],"variable":[{"id":"001665ac-5463-4c3f-a932-dfc4c484fd68","type":"any","value":"FUTURE","key":"type"}]}},"response":[{"id":"aacd4629-f6c6-4664-9e48-b9a2c61bfdc3","name":"Currency Pairs By Type - SPOT","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.valr.com/v1/public/pairs/:type","host":["https://api.valr.com"],"path":["v1","public","pairs",":type"],"variable":[{"key":"type","value":"SPOT"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"0"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"n/a"},{"key":"Via","value":"1.1 google"},{"key":"Date","value":"Tue, 17 Jun 2025 11:33:18 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Content-Length","value":"19394"},{"key":"Age","value":"667"},{"key":"Cache-Control","value":"max-age=60,public"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"symbol\": \"ETHZAR\",\n \"baseCurrency\": \"ETH\",\n \"quoteCurrency\": \"ZAR\",\n \"shortName\": \"ETH/ZAR\",\n \"active\": true,\n \"minBaseAmount\": \"0.0002\",\n \"maxBaseAmount\": \"69.21\",\n \"minQuoteAmount\": \"10\",\n \"maxQuoteAmount\": \"5000000\",\n \"tickSize\": \"1\",\n \"baseDecimalPlaces\": \"8\",\n \"marginTradingAllowed\": true,\n \"currencyPairType\": \"SPOT\",\n \"initialMarginFraction\": \"0.2\",\n \"maintenanceMarginFraction\": \"0.1\",\n \"autoCloseMarginFraction\": \"0.033333333\"\n },\n {\n \"symbol\": \"BNBUSDC\",\n \"baseCurrency\": \"BNB\",\n \"quoteCurrency\": \"USDC\",\n \"shortName\": \"BNB/USDC\",\n \"active\": true,\n \"minBaseAmount\": \"0.0008\",\n \"maxBaseAmount\": \"80\",\n \"minQuoteAmount\": \"0.52\",\n \"maxQuoteAmount\": \"52000\",\n \"tickSize\": \"0.1\",\n \"baseDecimalPlaces\": \"4\",\n \"marginTradingAllowed\": false,\n \"currencyPairType\": \"SPOT\"\n },\n {\n \"symbol\": \"SHIBUSDC\",\n \"baseCurrency\": \"SHIB\",\n \"quoteCurrency\": \"USDC\",\n \"shortName\": \"SHIB/USDC\",\n \"active\": true,\n \"minBaseAmount\": \"44600\",\n \"maxBaseAmount\": \"2750000000\",\n \"minQuoteAmount\": \"0.59\",\n \"maxQuoteAmount\": \"50000\",\n \"tickSize\": \"0.00000001\",\n \"baseDecimalPlaces\": \"0\",\n \"marginTradingAllowed\": false,\n \"currencyPairType\": \"SPOT\"\n },\n {\n \"symbol\": \"LTCBTC\",\n \"baseCurrency\": \"LTC\",\n \"quoteCurrency\": \"BTC\",\n \"shortName\": \"LTC/BTC\",\n \"active\": false,\n \"minBaseAmount\": \"0.0043\",\n \"maxBaseAmount\": \"15.67\",\n \"minQuoteAmount\": \"0.000016\",\n \"maxQuoteAmount\": \"0.0512\",\n \"tickSize\": \"0.000001\",\n \"baseDecimalPlaces\": \"8\",\n \"marginTradingAllowed\": false,\n \"currencyPairType\": \"SPOT\"\n },\n {\n \"symbol\": \"ADAETH\",\n \"baseCurrency\": \"ADA\",\n \"quoteCurrency\": \"ETH\",\n \"shortName\": \"ADA/ETH\",\n \"active\": false,\n \"minBaseAmount\": \"3.5\",\n \"maxBaseAmount\": \"3571.28\",\n \"minQuoteAmount\": \"0.00022\",\n \"maxQuoteAmount\": \"0.7576\",\n \"tickSize\": \"0.000001\",\n \"baseDecimalPlaces\": \"2\",\n \"marginTradingAllowed\": false,\n \"currencyPairType\": \"SPOT\"\n }\n]"},{"id":"7a1d6011-fe0c-469d-8fed-74bf5ee4c062","name":"Currency Pairs By Type - FUTURE","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.valr.com/v1/public/pairs/:type","host":["https://api.valr.com"],"path":["v1","public","pairs",":type"],"variable":[{"key":"type","value":"FUTURE"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"0"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"n/a"},{"key":"Via","value":"1.1 google"},{"key":"Date","value":"Tue, 17 Jun 2025 10:31:21 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Content-Length","value":"1947"},{"key":"Age","value":"6093"},{"key":"Cache-Control","value":"max-age=60,public"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"symbol\": \"BTCUSDTPERP\",\n \"baseCurrency\": \"BTC\",\n \"quoteCurrency\": \"USDT\",\n \"shortName\": \"BTC/USDTPERP\",\n \"active\": true,\n \"minBaseAmount\": \"0.0001\",\n \"maxBaseAmount\": \"7\",\n \"minQuoteAmount\": \"1\",\n \"maxQuoteAmount\": \"250000\",\n \"tickSize\": \"1\",\n \"baseDecimalPlaces\": \"4\",\n \"marginTradingAllowed\": false,\n \"currencyPairType\": \"FUTURE\",\n \"initialMarginFraction\": \"0.025\",\n \"maintenanceMarginFraction\": \"0.0125\",\n \"autoCloseMarginFraction\": \"0.0125\"\n },\n {\n \"symbol\": \"BTCUSDCPERP\",\n \"baseCurrency\": \"BTC\",\n \"quoteCurrency\": \"USDC\",\n \"shortName\": \"BTC/USDCPERP\",\n \"active\": false,\n \"minBaseAmount\": \"0.0001\",\n \"maxBaseAmount\": \"35\",\n \"minQuoteAmount\": \"1\",\n \"maxQuoteAmount\": \"1000000\",\n \"tickSize\": \"1\",\n \"baseDecimalPlaces\": \"4\",\n \"marginTradingAllowed\": false,\n \"currencyPairType\": \"FUTURE\",\n \"initialMarginFraction\": \"0.2\",\n \"maintenanceMarginFraction\": \"0.1\",\n \"autoCloseMarginFraction\": \"0.033333333\"\n },\n {\n \"symbol\": \"ETHUSDCPERP\",\n \"baseCurrency\": \"ETH\",\n \"quoteCurrency\": \"USDC\",\n \"shortName\": \"ETH/USDCPERP\",\n \"active\": false,\n \"minBaseAmount\": \"0.01\",\n \"maxBaseAmount\": \"550\",\n \"minQuoteAmount\": \"0.1\",\n \"maxQuoteAmount\": \"1000000\",\n \"tickSize\": \"0.01\",\n \"baseDecimalPlaces\": \"2\",\n \"marginTradingAllowed\": false,\n \"currencyPairType\": \"FUTURE\",\n \"initialMarginFraction\": \"0.2\",\n \"maintenanceMarginFraction\": \"0.1\",\n \"autoCloseMarginFraction\": \"0.033333333\"\n }\n]"}],"_postman_id":"c81d7f37-3bb1-4cca-ae83-0f02fac8f52a"},{"name":"Futures Funding Rate History","id":"dba33fea-9b3d-405b-abbb-b077b8fa5a63","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/futures/funding/history?currencyPair=BTCUSDTPERP","description":"Returns the funding rate history for the specified Futures pair.
\nThe results of this request may be filtered by currencyPair, startTime and endTime. The skip and limit parameters may be applied to paginate the filtered results.
currencyPairThe currencyPair parameter may be used to filter the returned items by the name of the perpetual futures contract expressed as base, quote, PERP, e.g. BTCUSDTPERP.
startTime or endTimeThe startTime or endTime parameters may be used to filter the returned items by the funding rate period. The parameters will be interpreted as being in the UTC time zone and must be supplied in the ISO 8601 format (2023-11-14T22:00:00.000Z). These two parameters may be used together or separately. When startTime is used, funding rates that have been active since startTime are returned. When endTime is used, funding rates that have been active up to and including endTime are returned. When not specified, 30 days worth of funding rates are returned by default.
The name of the perpetual futures contract expressed as base, quote, PERP, e.g. BTCUSDTPERP
Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"disabled":true,"description":{"content":"Limit - Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"100"},{"disabled":true,"description":{"content":"Include only funding rates after this ISO 8601 start time
\n","type":"text/plain"},"key":"startTime ","value":"2023-11-30T08:51:21.604113Z"},{"disabled":true,"description":{"content":"Include only funding rates before this ISO 8601 end time
\n","type":"text/plain"},"key":"endTime","value":"2023-12-05T08:55:29.339000Z"}],"variable":[]}},"response":[{"id":"78d94a13-f95e-4d63-9804-3a30f85ca6c0","name":"Futures Funding Rate History","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/public/futures/funding/history?currencyPair=BTCUSDTPERP","host":["https://api.valr.com"],"path":["v1","public","futures","funding","history"],"query":[{"key":"currencyPair","value":"BTCUSDTPERP","description":"The name of the perpetual futures contract expressed as base, quote, PERP, e.g. `BTCUSDTPERP`"},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)","disabled":true},{"key":"limit","value":"100","description":"Limit - Limit the results to this number. (Default and Max 100)","disabled":true},{"key":"startTime ","value":"2023-11-30T08:51:21.604113Z","description":"Include only funding rates after this ISO 8601 start time","disabled":true},{"key":"endTime","value":"2023-12-05T08:55:29.339000Z","description":"Include only funding rates before this ISO 8601 end time","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 16 Jul 2025 11:45:35 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"709"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"n/a"},{"key":"Via","value":"1.1 google"},{"key":"Cache-Control","value":"max-age=60,public"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencyPair\": \"BTCUSDTPERP\",\n \"fundingRate\": \"0.000277\",\n \"fundingTime\": \"2025-07-16T11:00:00Z\"\n },\n {\n \"currencyPair\": \"BTCUSDTPERP\",\n \"fundingRate\": \"0.000313\",\n \"fundingTime\": \"2025-07-16T10:00:00Z\"\n },\n {\n \"currencyPair\": \"BTCUSDTPERP\",\n \"fundingRate\": \"0.000343\",\n \"fundingTime\": \"2025-07-16T09:00:00Z\"\n },\n {\n \"currencyPair\": \"BTCUSDTPERP\",\n \"fundingRate\": \"0.000368\",\n \"fundingTime\": \"2025-07-16T08:00:00Z\"\n },\n {\n \"currencyPair\": \"BTCUSDTPERP\",\n \"fundingRate\": \"0.000387\",\n \"fundingTime\": \"2025-07-16T07:00:00Z\"\n }\n]"}],"_postman_id":"dba33fea-9b3d-405b-abbb-b077b8fa5a63"},{"name":"Futures Information","id":"459c7c67-3c0f-494e-851b-2fd83cbff2da","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/futures/info","description":"Returns market information for the available futures trading pairs on the platform.
\n","urlObject":{"path":["v1","public","futures","info"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"319b421e-f1be-49d5-8cff-2f3eeebde6cb","name":"Futures Information","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}"}],"url":"https://api.valr.com/v1/public/futures/info"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"0"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"n/a"},{"key":"Via","value":"1.1 google"},{"key":"Date","value":"Tue, 17 Jun 2025 12:46:40 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Content-Length","value":"281"},{"key":"Age","value":"417"},{"key":"Cache-Control","value":"max-age=60,public"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencyPair\": \"BTCUSDTPERP\",\n \"estimatedFundingRate\": \"-0.000001\",\n \"openInterest\": \"1.8401\",\n \"nextFundingRun\": 1750165200000,\n \"nextPnlRun\": 1750176000000\n },\n {\n \"currencyPair\": \"ETHUSDTPERP\",\n \"estimatedFundingRate\": \"0.000072\",\n \"openInterest\": \"69.857\",\n \"nextFundingRun\": 1750165200000,\n \"nextPnlRun\": 1750176000000\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"estimatedFundingRate\": \"0.000008\",\n \"openInterest\": \"28038.5\",\n \"nextFundingRun\": 1750165200000,\n \"nextPnlRun\": 1750176000000\n },\n {\n \"currencyPair\": \"XRPUSDTPERP\",\n \"estimatedFundingRate\": \"0.000017\",\n \"openInterest\": \"68587\",\n \"nextFundingRun\": 1750165200000,\n \"nextPnlRun\": 1750176000000\n },\n {\n \"currencyPair\": \"DOGEUSDTPERP\",\n \"estimatedFundingRate\": \"-0.000012\",\n \"openInterest\": \"476792\",\n \"nextFundingRun\": 1750165200000,\n \"nextPnlRun\": 1750176000000\n },\n {\n \"currencyPair\": \"SOLUSDTPERP\",\n \"estimatedFundingRate\": \"0.000003\",\n \"openInterest\": \"1737.91\",\n \"nextFundingRun\": 1750165200000,\n \"nextPnlRun\": 1750176000000\n },\n {\n \"currencyPair\": \"AVAXUSDTPERP\",\n \"estimatedFundingRate\": \"-0.000005\",\n \"openInterest\": \"838.54\",\n \"nextFundingRun\": 1750165200000,\n \"nextPnlRun\": 1750176000000\n }\n]"}],"_postman_id":"459c7c67-3c0f-494e-851b-2fd83cbff2da"},{"name":"Loan Info","id":"c62b81eb-e72f-4cd1-be8b-e5a430950225","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/loans/info","description":"Returns minimum and maximum rates and amounts per currency supporting lending
\n","urlObject":{"path":["v1","public","loans","info"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"48c81785-93e6-48a5-93de-ea58c37c3132","name":"Loan Info","originalRequest":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/loans/info"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 17 Jun 2025 12:54:19 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"0"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"n/a"},{"key":"Via","value":"1.1 google"},{"key":"Cache-Control","value":"max-age=120,public"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"lendingSupported\": true,\n \"shortName\": \"ZAR\",\n \"minimumRate\": \"0.00000685\",\n \"maximumRate\": \"0.00036\",\n \"minimumAmount\": \"500\",\n \"maximumAmount\": \"100000000\"\n },\n {\n \"lendingSupported\": true,\n \"shortName\": \"BTC\",\n \"minimumRate\": \"0.0000005\",\n \"maximumRate\": \"0.00036\",\n \"minimumAmount\": \"0.008\",\n \"maximumAmount\": \"1000\"\n },\n {\n \"lendingSupported\": true,\n \"shortName\": \"ETH\",\n \"minimumRate\": \"0.0000005\",\n \"maximumRate\": \"0.00036\",\n \"minimumAmount\": \"0.01\",\n \"maximumAmount\": \"20000\"\n },\n {\n \"lendingSupported\": true,\n \"shortName\": \"TRX\",\n \"minimumRate\": \"0.0000045\",\n \"maximumRate\": \"0.00036\",\n \"minimumAmount\": \"90\",\n \"maximumAmount\": \"200000000\"\n },\n {\n \"lendingSupported\": false,\n \"shortName\": \"LTC\",\n \"minimumRate\": \"0\",\n \"minimumAmount\": \"0\"\n },\n {\n \"lendingSupported\": false,\n \"shortName\": \"PYUSD\",\n \"minimumRate\": \"0\",\n \"minimumAmount\": \"0\"\n },\n {\n \"lendingSupported\": false,\n \"shortName\": \"PYTH\",\n \"minimumRate\": \"0\",\n \"minimumAmount\": \"0\"\n },\n {\n \"lendingSupported\": false,\n \"shortName\": \"W\",\n \"minimumRate\": \"0\",\n \"minimumAmount\": \"0\"\n }\n]"}],"_postman_id":"c62b81eb-e72f-4cd1-be8b-e5a430950225"},{"name":"Mark Price Buckets for a currency pair","id":"7a9a641c-f0c9-43fe-afc5-3d719c738ff9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/:currencyPair/markprice/buckets?startTime=2025-07-21T08:51:21.604113Z&endTime=2025-07-21T10:21:21.604113Z","description":"Get the mark price buckets for a given currency pair.
\nNotes
\nWe only support 100 buckets for a given bucket period. This means you can't specify a startTime and endTime that will contain more buckets than our supported max.
\n","urlObject":{"path":["v1","public",":currencyPair","markprice","buckets"],"host":["https://api.valr.com"],"query":[{"disabled":true,"description":{"content":"(Optional), 60 (default), 300, 900, 1800, 3600, 21600 and 86400 (max)
\n","type":"text/plain"},"key":"periodSeconds","value":""},{"description":{"content":"(Optional) Default is endTime minus max allowed buckets
\n","type":"text/plain"},"key":"startTime","value":"2025-07-21T08:51:21.604113Z"},{"description":{"content":"(Optional) Default is the current time
\n","type":"text/plain"},"key":"endTime","value":"2025-07-21T10:21:21.604113Z"}],"variable":[{"description":{"content":"Specify the currency pair for which you want to query the mark price buckets
\nExamples: BTCUSDC, ETHUSDC, XRPUSDC, ADABTC, ADAETH etc.
\n","type":"text/plain"},"type":"any","value":"BTCUSDT","key":"currencyPair"}]}},"response":[{"id":"52cee506-d71b-4f53-bc3c-886738d276fb","name":"Mark Price Buckets for a currency pair","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.valr.com/v1/public/:currencyPair/markprice/buckets","host":["https://api.valr.com"],"path":["v1","public",":currencyPair","markprice","buckets"],"query":[{"key":"periodSeconds","value":"","description":"(Optional), 60 (default), 300, 900, 1800, 3600, 21600 and 86400 (max)","disabled":true},{"key":"startTime","value":"2023-11-30T08:51:21.604113Z","description":"(Optional) Default Now() ","disabled":true},{"key":"endTime","value":"2023-11-30T10:21:21.604113Z","description":"(Optional) Default startTime minus max allowed buckets","disabled":true}],"variable":[{"key":"currencyPair","value":"BTCUSDT","description":" Specify the currency pair for which you want to query the mark price buckets\n\nExamples: BTCUSDC, ETHUSDC, XRPUSDC, ADABTC, ADAETH etc.\n"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"cache-control","value":"max-age=50,public"},{"key":"x-valr-upstream-service-time","value":"31"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Wed, 16 Jul 2025 11:39:59 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencyPairSymbol\": \"BTCUSDT\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-16T11:39:00Z\",\n \"open\": \"118834\",\n \"close\": \"118834\",\n \"high\": \"118834\",\n \"low\": \"118834\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDT\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-16T11:38:00Z\",\n \"open\": \"118821\",\n \"close\": \"118821\",\n \"high\": \"118821\",\n \"low\": \"118821\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDT\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-16T11:37:00Z\",\n \"open\": \"118827\",\n \"close\": \"118827\",\n \"high\": \"118827\",\n \"low\": \"118827\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDT\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-16T11:36:00Z\",\n \"open\": \"118845\",\n \"close\": \"118845\",\n \"high\": \"118845\",\n \"low\": \"118845\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDT\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-16T11:35:00Z\",\n \"open\": \"118827\",\n \"close\": \"118827\",\n \"high\": \"118827\",\n \"low\": \"118827\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDT\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-16T11:34:00Z\",\n \"open\": \"118849\",\n \"close\": \"118849\",\n \"high\": \"118849\",\n \"low\": \"118849\"\n }\n]"}],"_postman_id":"7a9a641c-f0c9-43fe-afc5-3d719c738ff9"},{"name":"Market Summary","id":"cd1f0448-3da3-44cf-b00d-91edd74e7e19","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/marketsummary","description":"Get the market summary for all supported currency pairs.
\nmarkPrice: A reference price for a trading pair calculated as the median of last traded, best bid and best ask.
Get the market summary for a given currency pair.
\n","urlObject":{"path":["v1","public",":currencyPair","marketsummary"],"host":["https://api.valr.com"],"query":[],"variable":[{"description":{"content":"Specify the currency pair for which you want to query the market summary.
\nExamples: BTCUSDC, ETHUSDC, XRPUSDC, ETHZAR, ADABTC, ADAETH etc.
\n","type":"text/plain"},"type":"any","value":"BTCUSDC","key":"currencyPair"}]}},"response":[{"id":"4b415328-cfa9-4db6-b9e6-6a9ab62ea78d","name":"Market Summary for a currency pair","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.valr.com/v1/public/:currencyPair/marketsummary","host":["https://api.valr.com"],"path":["v1","public",":currencyPair","marketsummary"],"variable":[{"key":"currencyPair","value":"BTCUSDT","description":" Specify the currency pair for which you want to query the market summary. \n\nExamples: BTCUSDC, ETHUSDC, XRPUSDC, ETHZAR, ADABTC, ADAETH etc.\n"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"cache-control","value":"max-age=5,public"},{"key":"x-valr-upstream-service-time","value":"1"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 17 Jul 2025 07:38:05 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"currencyPair\": \"BTCUSDT\",\n \"askPrice\": \"93129\",\n \"bidPrice\": \"81400\",\n \"lastTradedPrice\": \"93129\",\n \"previousClosePrice\": \"93129\",\n \"baseVolume\": \"0\",\n \"quoteVolume\": \"0\",\n \"highPrice\": \"93129\",\n \"lowPrice\": \"0\",\n \"created\": \"2025-07-17T07:37:05.061Z\",\n \"changeFromPrevious\": \"0\",\n \"markPrice\": \"118156\"\n}"}],"_postman_id":"89b446bb-60a6-42ff-aa09-29e4918a9eb0"},{"name":"Order Book","id":"720fec1b-a1f6-486a-b04a-7ae76c6f9f66","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/:currencyPair/orderbook","description":"Returns a list of the top 41 bids and asks in the order book. Ask orders are sorted by price ascending. Bid orders are sorted by price descending. Orders of the same price are aggregated.
Please note: This is not an authenticated call. More constrained rate-limiting rules will apply than when you use the /marketdata/:currencyPair/orderbook route.
Currency pair for which you want to query the order book
\n","type":"text/plain"},"type":"any","value":"BTCUSDC","key":"currencyPair"}]}},"response":[{"id":"51f52a7b-dd09-4634-9121-d3ca88bb5567","name":"Order Book","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.valr.com/v1/public/:currencyPair/orderbook","host":["https://api.valr.com"],"path":["v1","public",":currencyPair","orderbook"],"variable":[{"key":"currencyPair","value":"BTCUSDT","description":"Currency pair for which you want to query the order book"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"cache-control","value":"max-age=30,public"},{"key":"x-valr-upstream-service-time","value":"8"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Wed, 16 Jul 2025 11:21:23 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"Asks\": [\n {\n \"side\": \"sell\",\n \"quantity\": \"0.01293134\",\n \"price\": \"93129\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n }\n ],\n \"Bids\": [\n {\n \"side\": \"buy\",\n \"quantity\": \"1.23136671\",\n \"price\": \"81400\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 17\n }\n ],\n \"LastChange\": \"2025-07-15T12:19:21.501Z\",\n \"SequenceNumber\": 282886\n}"}],"_postman_id":"720fec1b-a1f6-486a-b04a-7ae76c6f9f66"},{"name":"Order Book (Non aggregated)","id":"9ee254bd-4361-40e8-95a1-f57e74968f24","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/:currencyPair/orderbook/full","description":"Returns a list of all the bids and asks in the order book. Ask orders are sorted by price ascending. Bid orders are sorted by price descending. Orders of the same price are NOT aggregated. The LastChange field indicates the timestamp of the last update to the order book.
Please note: This is not an authenticated call. More constrained rate-limiting rules will apply than when you use the /marketdata/:currencyPair/orderbook/full route.
Currency pair for which you want to query the order book
\n","type":"text/plain"},"type":"any","value":"BTCUSDC","key":"currencyPair"}]}},"response":[{"id":"087cb78a-064f-47a3-860e-0af80349b0fa","name":"Order Book (Non aggregated)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate request signature"}],"url":{"raw":"https://api.valr.com/v1/public/:currencyPair/orderbook/full","host":["https://api.valr.com"],"path":["v1","public",":currencyPair","orderbook","full"],"variable":[{"key":"currencyPair","value":"BTCUSDT","description":"Currency pair for which you want to query the order book"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"cache-control","value":"max-age=30,public"},{"key":"x-valr-upstream-service-time","value":"12"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Wed, 16 Jul 2025 11:23:45 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"Asks\": [\n {\n \"side\": \"sell\",\n \"quantity\": \"0.01293134\",\n \"price\": \"93129\",\n \"currencyPair\": \"BTCUSDT\",\n \"id\": \"01972611-7cd0-7866-a6f3-8bc8f9c4a55a\",\n \"positionAtPrice\": 1\n },\n {\n \"side\": \"sell\",\n \"quantity\": \"4.6422441\",\n \"price\": \"95800\",\n \"currencyPair\": \"BTCUSDT\",\n \"id\": \"b240da7d-6408-41fc-aea6-30c0c7160760\",\n \"positionAtPrice\": 1\n },\n {\n \"side\": \"sell\",\n \"quantity\": \"0.01\",\n \"price\": \"95800\",\n \"currencyPair\": \"BTCUSDT\",\n \"id\": \"01955ba4-5c64-781e-ad2f-2891b3032e36\",\n \"positionAtPrice\": 2\n }\n ],\n \"Bids\": [\n {\n \"side\": \"buy\",\n \"quantity\": \"1.23117023\",\n \"price\": \"81400\",\n \"currencyPair\": \"BTCUSDT\",\n \"id\": \"01966bf8-308b-7fb9-a6db-bf2d6122f08b\",\n \"positionAtPrice\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.00001228\",\n \"price\": \"81400\",\n \"currencyPair\": \"BTCUSDT\",\n \"id\": \"0197f31a-7db7-7e5b-89c5-65337989465f\",\n \"positionAtPrice\": 2\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.05000000\",\n \"price\": \"81399\",\n \"currencyPair\": \"BTCUSDT\",\n \"id\": \"0197f31a-8437-7213-8a0b-30486a149648\",\n \"positionAtPrice\": 1\n }\n ],\n \"LastChange\": \"2025-07-15T12:19:21.501Z\",\n \"SequenceNumber\": 282886\n}"}],"_postman_id":"9ee254bd-4361-40e8-95a1-f57e74968f24"},{"name":"Order Types","id":"700eddaa-60ba-4872-ae2b-577c3285d695","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/ordertypes?includeInactivePairs=false","description":"Get all the order types supported for all currency pairs.
\nAn array of currency pairs is returned along with an array of order types for each currency pair. You can only place an order that is supported by that currency pair.
\nThe order types supported are as follows:
\n","urlObject":{"path":["v1","public","ordertypes"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Default: true
\n","type":"text/plain"},"key":"includeInactivePairs","value":"false"}],"variable":[]}},"response":[{"id":"2c739d9c-b36d-4f33-bf97-af8589bf5c25","name":"Order Types","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.valr.com/v1/public/ordertypes","host":["https://api.valr.com"],"path":["v1","public","ordertypes"],"query":[{"key":"includeInactivePairs","value":"false","description":"Default: true","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"0"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"n/a"},{"key":"Via","value":"1.1 google"},{"key":"Date","value":"Tue, 17 Jun 2025 08:25:00 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Content-Length","value":"2686"},{"key":"Age","value":"13923"},{"key":"Cache-Control","value":"public,max-age=60"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencyPair\": \"ETHZAR\",\n \"orderTypes\": [\n \"LIMIT_POST_ONLY\",\n \"LIMIT\",\n \"MARKET\",\n \"SIMPLE\",\n \"STOP_LOSS_LIMIT\",\n \"TAKE_PROFIT_LIMIT\"\n ]\n },\n {\n \"currencyPair\": \"LTCBTC\",\n \"orderTypes\": []\n },\n {\n \"currencyPair\": \"LTCETH\",\n \"orderTypes\": []\n },\n {\n \"currencyPair\": \"BNTUSDC\",\n \"orderTypes\": [\n \"SIMPLE\"\n ]\n },\n {\n \"currencyPair\": \"DAIUSDC\",\n \"orderTypes\": [\n \"SIMPLE\"\n ]\n },\n {\n \"currencyPair\": \"BTCUSDTPERP\",\n \"orderTypes\": [\n \"LIMIT_POST_ONLY\",\n \"LIMIT\",\n \"LIMIT_REDUCE_ONLY\",\n \"MARKET_REDUCE_ONLY\",\n \"MARKET\"\n ]\n },\n {\n \"currencyPair\": \"PYUSDUSDT\",\n \"orderTypes\": [\n \"LIMIT_POST_ONLY\",\n \"SIMPLE\",\n \"LIMIT\",\n \"MARKET\"\n ]\n },\n {\n \"currencyPair\": \"PYUSDZAR\",\n \"orderTypes\": [\n \"LIMIT_POST_ONLY\",\n \"LIMIT\",\n \"SIMPLE\",\n \"MARKET\"\n ]\n }\n]"}],"_postman_id":"700eddaa-60ba-4872-ae2b-577c3285d695"},{"name":"Order Types for a currency pair","id":"a3675f5a-34e0-45b3-9458-f3cffdbe4360","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/:currencyPair/ordertypes","description":"Get the order types supported for a given currency pair.
\nAn array of order types is returned. You can only place an order that is listed in this array for this currency pair.
\nThe order types supported are as follows:
\n","urlObject":{"path":["v1","public",":currencyPair","ordertypes"],"host":["https://api.valr.com"],"query":[],"variable":[{"description":{"content":"Specify the currency pair for which you want to query the order types.
\nExamples: BTCUSDC, BTCUSDT, XRPUSDC, SOLUSDC, ADABTC, ADAETH etc.
\n","type":"text/plain"},"type":"any","value":"BTCUSDC","key":"currencyPair"}]}},"response":[{"id":"ed39fd10-4402-498a-b85b-6a1e48bb9a0e","name":"Order Types for a currency pair","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.valr.com/v1/public/:currencyPair/ordertypes","protocol":"https","host":["api","valr","com"],"path":["v1","public",":currencyPair","ordertypes"],"variable":[{"key":"currencyPair","value":"BTCUSDC","description":" Specify the currency pair for which you want to query the order types. \n\nExamples: BTCUSDC, BTCUSDT, XRPUSDC, SOLUSDC, ADABTC, ADAETH etc.\n"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Mon, 08 Feb 2021 11:31:23 GMT"},{"key":"cache-control","value":"max-age=60"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"1"},{"key":"server","value":"envoy"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"[\n \"LIMIT_POST_ONLY\",\n \"MARKET\",\n \"LIMIT\",\n \"SIMPLE\",\n \"STOP_LOSS_LIMIT\",\n \"TAKE_PROFIT_LIMIT\"\n]"}],"_postman_id":"a3675f5a-34e0-45b3-9458-f3cffdbe4360"},{"name":"Price Buckets for a currency pair","id":"438aa673-dd05-45cc-a7de-ad78932a14db","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/:currencyPair/buckets?periodSeconds=60&startTime=1753102597&endTime=1753188997&skip=0&limit=300&includeEmpty=true","description":"This API returns historical market data aggregated into time-based \"buckets\" or candles for a specified currency pair and bucket period. Each bucket provides the open, high, low, close, and volume for the defined time interval.
\nNote: If no trading activity occurred during a specific bucket period, the open, high, low, and close prices will be identical (likely reflecting the last traded price), and volume and quoteVolume will be zero.
Valid inputs for the periodsSeconds parameter are 60 (default) - 1 Minute, 300 - 5 Minutes, 900 - 15 Minutes, 1800 - 30 Minutes, 3600 - 1 Hour, 21600 - 6 Hours and 86400 - 1 Day (max)
(Optional), 60 (default), 300, 900, 1800, 3600, 21600 and 86400 (max)
\n","type":"text/plain"},"key":"periodSeconds","value":"60"},{"description":{"content":"Start Time in Epoch Seconds
\n","type":"text/plain"},"key":"startTime","value":"1753102597"},{"description":{"content":"End Time in Epoch Seconds
\n","type":"text/plain"},"key":"endTime","value":"1753188997"},{"description":{"content":"Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"300"},{"description":{"content":"(Optional) default value is false
\n","type":"text/plain"},"key":"includeEmpty","value":"true"}],"variable":[{"description":{"content":"Specify the currency pair for which you want to query the price buckets.
\nExamples: BTCUSDC, ETHUSDC, XRPUSDC, ADABTC, ADAETH etc.
\n","type":"text/plain"},"type":"any","value":"BTCUSDC","key":"currencyPair"}]}},"response":[{"id":"a5b613c8-44ef-4df6-8597-2e81d861b790","name":"Price Buckets for a currency pair","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.valr.com/v1/public/:currencyPair/buckets?periodSeconds=60&startTime=1753102597&endTime=1753188997&skip=0&limit=300&includeEmpty=true","host":["https://api.valr.com"],"path":["v1","public",":currencyPair","buckets"],"query":[{"key":"periodSeconds","value":"60","description":"(Optional), 60 (default), 300, 900, 1800, 3600, 21600 and 86400 (max)"},{"key":"startTime","value":"1753102597","description":"Start Time in Epoch Seconds"},{"key":"endTime","value":"1753188997","description":"End Time in Epoch Seconds"},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"300","description":"Limit the results to this number. (Default and Max 100)"},{"key":"includeEmpty","value":"true","description":"(Optional) default value is false"}],"variable":[{"key":"currencyPair","value":"BTCUSDC","description":"Specify the currency pair for which you want to query the price buckets.\n\nExamples: BTCUSDC, ETHUSDC, XRPUSDC, ADABTC, ADAETH etc."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:56:00Z\",\n \"open\": \"119350\",\n \"high\": \"119350\",\n \"low\": \"119350\",\n \"close\": \"119350\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:55:00Z\",\n \"open\": \"119350\",\n \"high\": \"119350\",\n \"low\": \"119350\",\n \"close\": \"119350\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:54:00Z\",\n \"open\": \"119350\",\n \"high\": \"119350\",\n \"low\": \"119350\",\n \"close\": \"119350\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:53:00Z\",\n \"open\": \"119350\",\n \"high\": \"119350\",\n \"low\": \"119350\",\n \"close\": \"119350\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:52:00Z\",\n \"open\": \"119350\",\n \"high\": \"119350\",\n \"low\": \"119350\",\n \"close\": \"119350\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:51:00Z\",\n \"open\": \"119350\",\n \"high\": \"119350\",\n \"low\": \"119350\",\n \"close\": \"119350\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:50:00Z\",\n \"open\": \"119350\",\n \"high\": \"119350\",\n \"low\": \"119350\",\n \"close\": \"119350\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:49:00Z\",\n \"open\": \"119350\",\n \"high\": \"119350\",\n \"low\": \"119350\",\n \"close\": \"119350\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:48:00Z\",\n \"open\": \"119350\",\n \"high\": \"119350\",\n \"low\": \"119350\",\n \"close\": \"119350\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:47:00Z\",\n \"open\": \"119350\",\n \"high\": \"119350\",\n \"low\": \"119350\",\n \"close\": \"119350\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:46:00Z\",\n \"open\": \"119350\",\n \"high\": \"119350\",\n \"low\": \"119350\",\n \"close\": \"119350\",\n \"volume\": \"0.0051\",\n \"quoteVolume\": \"608.685\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:45:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:44:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:43:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:42:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:41:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:40:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:39:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:38:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:37:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:36:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:35:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:34:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:33:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:32:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:31:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:30:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:29:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:28:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:27:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:26:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:25:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:24:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:23:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:22:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:21:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:20:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:19:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:18:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:17:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:16:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:15:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:14:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:13:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:12:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:11:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:10:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:09:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:08:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:07:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:06:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:05:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:04:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:03:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:02:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:01:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T12:00:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:59:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:58:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:57:00Z\",\n \"open\": \"119166\",\n \"high\": \"119166\",\n \"low\": \"119166\",\n \"close\": \"119166\",\n \"volume\": \"0.00008531\",\n \"quoteVolume\": \"10.16605146\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:56:00Z\",\n \"open\": \"119096\",\n \"high\": \"119096\",\n \"low\": \"119096\",\n \"close\": \"119096\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:55:00Z\",\n \"open\": \"119096\",\n \"high\": \"119096\",\n \"low\": \"119096\",\n \"close\": \"119096\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:54:00Z\",\n \"open\": \"119096\",\n \"high\": \"119096\",\n \"low\": \"119096\",\n \"close\": \"119096\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:53:00Z\",\n \"open\": \"119096\",\n \"high\": \"119096\",\n \"low\": \"119096\",\n \"close\": \"119096\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:52:00Z\",\n \"open\": \"119096\",\n \"high\": \"119096\",\n \"low\": \"119096\",\n \"close\": \"119096\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:51:00Z\",\n \"open\": \"119096\",\n \"high\": \"119096\",\n \"low\": \"119096\",\n \"close\": \"119096\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:50:00Z\",\n \"open\": \"119096\",\n \"high\": \"119096\",\n \"low\": \"119096\",\n \"close\": \"119096\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:49:00Z\",\n \"open\": \"119096\",\n \"high\": \"119096\",\n \"low\": \"119096\",\n \"close\": \"119096\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:48:00Z\",\n \"open\": \"119096\",\n \"high\": \"119096\",\n \"low\": \"119096\",\n \"close\": \"119096\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:47:00Z\",\n \"open\": \"119096\",\n \"high\": \"119096\",\n \"low\": \"119096\",\n \"close\": \"119096\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:46:00Z\",\n \"open\": \"119096\",\n \"high\": \"119096\",\n \"low\": \"119096\",\n \"close\": \"119096\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:45:00Z\",\n \"open\": \"119096\",\n \"high\": \"119096\",\n \"low\": \"119096\",\n \"close\": \"119096\",\n \"volume\": \"0.0249875\",\n \"quoteVolume\": \"2975.9113\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:44:00Z\",\n \"open\": \"119094\",\n \"high\": \"119094\",\n \"low\": \"119094\",\n \"close\": \"119094\",\n \"volume\": \"0.0049975\",\n \"quoteVolume\": \"595.172265\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:43:00Z\",\n \"open\": \"119082\",\n \"high\": \"119082\",\n \"low\": \"119082\",\n \"close\": \"119082\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:42:00Z\",\n \"open\": \"119082\",\n \"high\": \"119082\",\n \"low\": \"119082\",\n \"close\": \"119082\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:41:00Z\",\n \"open\": \"119082\",\n \"high\": \"119082\",\n \"low\": \"119082\",\n \"close\": \"119082\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:40:00Z\",\n \"open\": \"119082\",\n \"high\": \"119082\",\n \"low\": \"119082\",\n \"close\": \"119082\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:39:00Z\",\n \"open\": \"119082\",\n \"high\": \"119082\",\n \"low\": \"119082\",\n \"close\": \"119082\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:38:00Z\",\n \"open\": \"119082\",\n \"high\": \"119082\",\n \"low\": \"119082\",\n \"close\": \"119082\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:37:00Z\",\n \"open\": \"119082\",\n \"high\": \"119082\",\n \"low\": \"119082\",\n \"close\": \"119082\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:36:00Z\",\n \"open\": \"119082\",\n \"high\": \"119082\",\n \"low\": \"119082\",\n \"close\": \"119082\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:35:00Z\",\n \"open\": \"119082\",\n \"high\": \"119082\",\n \"low\": \"119082\",\n \"close\": \"119082\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:34:00Z\",\n \"open\": \"119082\",\n \"high\": \"119082\",\n \"low\": \"119082\",\n \"close\": \"119082\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:33:00Z\",\n \"open\": \"119082\",\n \"high\": \"119082\",\n \"low\": \"119082\",\n \"close\": \"119082\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:32:00Z\",\n \"open\": \"119082\",\n \"high\": \"119082\",\n \"low\": \"119082\",\n \"close\": \"119082\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:31:00Z\",\n \"open\": \"119082\",\n \"high\": \"119082\",\n \"low\": \"119082\",\n \"close\": \"119082\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:30:00Z\",\n \"open\": \"119092\",\n \"high\": \"119092\",\n \"low\": \"119082\",\n \"close\": \"119082\",\n \"volume\": \"0.01368986\",\n \"quoteVolume\": \"1630.29991912\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:29:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:28:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:27:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:26:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:25:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:24:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:23:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:22:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:21:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:20:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:19:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:18:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:17:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:16:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:15:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:14:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:13:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:12:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:11:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:10:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:09:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:08:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:07:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:06:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:05:00Z\",\n \"open\": \"119000\",\n \"high\": \"119000\",\n \"low\": \"119000\",\n \"close\": \"119000\",\n \"volume\": \"0.00105937\",\n \"quoteVolume\": \"126.06503\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:04:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:03:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:02:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:01:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T11:00:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:59:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:58:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:57:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:56:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:55:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:54:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:53:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:52:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:51:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:50:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:49:00Z\",\n \"open\": \"118795\",\n \"high\": \"118795\",\n \"low\": \"118795\",\n \"close\": \"118795\",\n \"volume\": \"0.0000867\",\n \"quoteVolume\": \"10.2995265\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:48:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:47:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:46:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:45:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:44:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:43:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:42:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:41:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:40:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:39:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:38:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:37:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:36:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:35:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:34:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:33:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:32:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:31:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:30:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:29:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:28:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:27:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:26:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:25:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:24:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:23:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:22:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:21:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:20:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:19:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:18:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:17:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:16:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:15:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:14:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:13:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:12:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:11:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:10:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:09:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:08:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:07:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:06:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:05:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:04:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:03:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:02:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:01:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T10:00:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:59:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:58:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:57:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:56:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:55:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:54:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:53:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:52:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:51:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:50:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:49:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:48:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:47:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:46:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:45:00Z\",\n \"open\": \"118600\",\n \"high\": \"118600\",\n \"low\": \"118600\",\n \"close\": \"118600\",\n \"volume\": \"0.00059328\",\n \"quoteVolume\": \"70.363008\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:44:00Z\",\n \"open\": \"118501\",\n \"high\": \"118501\",\n \"low\": \"118501\",\n \"close\": \"118501\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:43:00Z\",\n \"open\": \"118501\",\n \"high\": \"118501\",\n \"low\": \"118501\",\n \"close\": \"118501\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:42:00Z\",\n \"open\": \"118501\",\n \"high\": \"118501\",\n \"low\": \"118501\",\n \"close\": \"118501\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:41:00Z\",\n \"open\": \"118501\",\n \"high\": \"118501\",\n \"low\": \"118501\",\n \"close\": \"118501\",\n \"volume\": \"0.0010868\",\n \"quoteVolume\": \"128.7868868\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:40:00Z\",\n \"open\": \"118440\",\n \"high\": \"118440\",\n \"low\": \"118440\",\n \"close\": \"118440\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:39:00Z\",\n \"open\": \"118468\",\n \"high\": \"118469\",\n \"low\": \"118440\",\n \"close\": \"118440\",\n \"volume\": \"0.00715637\",\n \"quoteVolume\": \"847.61455178\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:38:00Z\",\n \"open\": \"118460\",\n \"high\": \"118517\",\n \"low\": \"118460\",\n \"close\": \"118517\",\n \"volume\": \"0.02652613\",\n \"quoteVolume\": \"3142.30043704\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:37:00Z\",\n \"open\": \"118518\",\n \"high\": \"118518\",\n \"low\": \"118518\",\n \"close\": \"118518\",\n \"volume\": \"0.00012656\",\n \"quoteVolume\": \"14.99963808\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:36:00Z\",\n \"open\": \"118326\",\n \"high\": \"118326\",\n \"low\": \"118326\",\n \"close\": \"118326\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:35:00Z\",\n \"open\": \"118326\",\n \"high\": \"118326\",\n \"low\": \"118326\",\n \"close\": \"118326\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:34:00Z\",\n \"open\": \"118326\",\n \"high\": \"118326\",\n \"low\": \"118326\",\n \"close\": \"118326\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:33:00Z\",\n \"open\": \"118326\",\n \"high\": \"118326\",\n \"low\": \"118326\",\n \"close\": \"118326\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:32:00Z\",\n \"open\": \"118326\",\n \"high\": \"118326\",\n \"low\": \"118326\",\n \"close\": \"118326\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:31:00Z\",\n \"open\": \"118321\",\n \"high\": \"118326\",\n \"low\": \"118321\",\n \"close\": \"118326\",\n \"volume\": \"0.03893405\",\n \"quoteVolume\": \"4606.72139975\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:30:00Z\",\n \"open\": \"118348\",\n \"high\": \"118348\",\n \"low\": \"118323\",\n \"close\": \"118323\",\n \"volume\": \"0.0778529\",\n \"quoteVolume\": \"9213.7271777\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:29:00Z\",\n \"open\": \"118321\",\n \"high\": \"118321\",\n \"low\": \"118321\",\n \"close\": \"118321\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:28:00Z\",\n \"open\": \"118335\",\n \"high\": \"118335\",\n \"low\": \"118321\",\n \"close\": \"118321\",\n \"volume\": \"0.00734436\",\n \"quoteVolume\": \"869.09184796\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:27:00Z\",\n \"open\": \"118320\",\n \"high\": \"118346\",\n \"low\": \"118320\",\n \"close\": \"118341\",\n \"volume\": \"0.04549633\",\n \"quoteVolume\": \"5383.90469714\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:26:00Z\",\n \"open\": \"118130\",\n \"high\": \"118130\",\n \"low\": \"118130\",\n \"close\": \"118130\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:25:00Z\",\n \"open\": \"118130\",\n \"high\": \"118130\",\n \"low\": \"118130\",\n \"close\": \"118130\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:24:00Z\",\n \"open\": \"118130\",\n \"high\": \"118130\",\n \"low\": \"118130\",\n \"close\": \"118130\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:23:00Z\",\n \"open\": \"118130\",\n \"high\": \"118130\",\n \"low\": \"118130\",\n \"close\": \"118130\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:22:00Z\",\n \"open\": \"118130\",\n \"high\": \"118130\",\n \"low\": \"118130\",\n \"close\": \"118130\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:21:00Z\",\n \"open\": \"118130\",\n \"high\": \"118130\",\n \"low\": \"118130\",\n \"close\": \"118130\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:20:00Z\",\n \"open\": \"118130\",\n \"high\": \"118130\",\n \"low\": \"118130\",\n \"close\": \"118130\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:19:00Z\",\n \"open\": \"118130\",\n \"high\": \"118130\",\n \"low\": \"118130\",\n \"close\": \"118130\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:18:00Z\",\n \"open\": \"118130\",\n \"high\": \"118130\",\n \"low\": \"118130\",\n \"close\": \"118130\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:17:00Z\",\n \"open\": \"118130\",\n \"high\": \"118130\",\n \"low\": \"118130\",\n \"close\": \"118130\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:16:00Z\",\n \"open\": \"118130\",\n \"high\": \"118130\",\n \"low\": \"118130\",\n \"close\": \"118130\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:15:00Z\",\n \"open\": \"118130\",\n \"high\": \"118130\",\n \"low\": \"118130\",\n \"close\": \"118130\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:14:00Z\",\n \"open\": \"118130\",\n \"high\": \"118130\",\n \"low\": \"118130\",\n \"close\": \"118130\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:13:00Z\",\n \"open\": \"118130\",\n \"high\": \"118130\",\n \"low\": \"118130\",\n \"close\": \"118130\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:12:00Z\",\n \"open\": \"118130\",\n \"high\": \"118130\",\n \"low\": \"118130\",\n \"close\": \"118130\",\n \"volume\": \"0.00001904\",\n \"quoteVolume\": \"2.2491952\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:11:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:10:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:09:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:08:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:07:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:06:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:05:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:04:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:03:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:02:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:01:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T09:00:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:59:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:58:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:57:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:56:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:55:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:54:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:53:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:52:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:51:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:50:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:49:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:48:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:47:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:46:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:45:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:44:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:43:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:42:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:41:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:40:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:39:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:38:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:37:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:36:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:35:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:34:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:33:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:32:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:31:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:30:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:29:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:28:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:27:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:26:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:25:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:24:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:23:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:22:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:21:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:20:00Z\",\n \"open\": \"117965\",\n \"high\": \"117965\",\n \"low\": \"117965\",\n \"close\": \"117965\",\n \"volume\": \"0.00051617\",\n \"quoteVolume\": \"60.88999405\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:19:00Z\",\n \"open\": \"117716\",\n \"high\": \"117716\",\n \"low\": \"117716\",\n \"close\": \"117716\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:18:00Z\",\n \"open\": \"117716\",\n \"high\": \"117716\",\n \"low\": \"117716\",\n \"close\": \"117716\",\n \"volume\": \"0.00135393\",\n \"quoteVolume\": \"159.37922388\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:17:00Z\",\n \"open\": \"117639\",\n \"high\": \"117639\",\n \"low\": \"117639\",\n \"close\": \"117639\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:16:00Z\",\n \"open\": \"117639\",\n \"high\": \"117639\",\n \"low\": \"117639\",\n \"close\": \"117639\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:15:00Z\",\n \"open\": \"117639\",\n \"high\": \"117639\",\n \"low\": \"117639\",\n \"close\": \"117639\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:14:00Z\",\n \"open\": \"117639\",\n \"high\": \"117639\",\n \"low\": \"117639\",\n \"close\": \"117639\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:13:00Z\",\n \"open\": \"117639\",\n \"high\": \"117639\",\n \"low\": \"117639\",\n \"close\": \"117639\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:12:00Z\",\n \"open\": \"117639\",\n \"high\": \"117639\",\n \"low\": \"117639\",\n \"close\": \"117639\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:11:00Z\",\n \"open\": \"117639\",\n \"high\": \"117639\",\n \"low\": \"117639\",\n \"close\": \"117639\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:10:00Z\",\n \"open\": \"117639\",\n \"high\": \"117639\",\n \"low\": \"117639\",\n \"close\": \"117639\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:09:00Z\",\n \"open\": \"117639\",\n \"high\": \"117639\",\n \"low\": \"117639\",\n \"close\": \"117639\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:08:00Z\",\n \"open\": \"117639\",\n \"high\": \"117639\",\n \"low\": \"117639\",\n \"close\": \"117639\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:07:00Z\",\n \"open\": \"117639\",\n \"high\": \"117639\",\n \"low\": \"117639\",\n \"close\": \"117639\",\n \"volume\": \"0.00014306\",\n \"quoteVolume\": \"16.82943534\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:06:00Z\",\n \"open\": \"117967\",\n \"high\": \"117967\",\n \"low\": \"117967\",\n \"close\": \"117967\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:05:00Z\",\n \"open\": \"117967\",\n \"high\": \"117967\",\n \"low\": \"117967\",\n \"close\": \"117967\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:04:00Z\",\n \"open\": \"117967\",\n \"high\": \"117967\",\n \"low\": \"117967\",\n \"close\": \"117967\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:03:00Z\",\n \"open\": \"117967\",\n \"high\": \"117967\",\n \"low\": \"117967\",\n \"close\": \"117967\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:02:00Z\",\n \"open\": \"117967\",\n \"high\": \"117967\",\n \"low\": \"117967\",\n \"close\": \"117967\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:01:00Z\",\n \"open\": \"117967\",\n \"high\": \"117967\",\n \"low\": \"117967\",\n \"close\": \"117967\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T08:00:00Z\",\n \"open\": \"117967\",\n \"high\": \"117967\",\n \"low\": \"117967\",\n \"close\": \"117967\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T07:59:00Z\",\n \"open\": \"117967\",\n \"high\": \"117967\",\n \"low\": \"117967\",\n \"close\": \"117967\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T07:58:00Z\",\n \"open\": \"117967\",\n \"high\": \"117967\",\n \"low\": \"117967\",\n \"close\": \"117967\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n },\n {\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2025-07-22T07:57:00Z\",\n \"open\": \"117967\",\n \"high\": \"117967\",\n \"low\": \"117967\",\n \"close\": \"117967\",\n \"volume\": \"0\",\n \"quoteVolume\": \"0\"\n }\n]"}],"_postman_id":"438aa673-dd05-45cc-a7de-ad78932a14db"},{"name":"Server Time","id":"95f84056-2ac7-4f92-a5d9-fd0d9c104f01","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/time","description":"Get the server time. Please note: The server time is returned in seconds.
\n","urlObject":{"path":["v1","public","time"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"9f7a0ba9-5e17-42a1-87a8-f672772a7651","name":"Server Time","originalRequest":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/time"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 17 Jun 2025 13:02:41 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"0"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"n/a"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"epochTime\": 1750165361,\n \"time\": \"2025-06-17T13:02:41.280178906Z\"\n}"}],"_postman_id":"95f84056-2ac7-4f92-a5d9-fd0d9c104f01"},{"name":"Slippage","id":"f8c2caf3-6dfb-421b-96f9-5868e24676f6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/slippage","description":"Returns all slippage configurations for every currency pair available on the platform, including both Spot and Futures markets.
\n","urlObject":{"path":["v1","public","slippage"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"ebe76fe0-7aba-4b76-b7a2-25a6235b7b9c","name":"Slippage","originalRequest":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/slippage"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"cache-control","value":"max-age=120,public"},{"key":"x-valr-upstream-service-time","value":"2"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Tue, 17 Feb 2026 10:20:17 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencyPair\": \"XRPZAR\",\n \"currencyPairType\": \"SPOT\",\n \"limitSlippagePercent\": \"5\",\n \"marketSlippagePercent\": \"5\"\n },\n {\n \"currencyPair\": \"BTCUSDT\",\n \"currencyPairType\": \"SPOT\",\n \"limitSlippagePercent\": \"5\",\n \"marketSlippagePercent\": \"5\"\n },\n {\n \"currencyPair\": \"ETHUSDT\",\n \"currencyPairType\": \"SPOT\",\n \"limitSlippagePercent\": \"5\",\n \"marketSlippagePercent\": \"5\"\n },\n {\n \"currencyPair\": \"BTCUSDTPERP\",\n \"currencyPairType\": \"FUTURE\",\n \"limitSlippagePercent\": \"3\",\n \"marketSlippagePercent\": \"3\"\n }\n]"}],"_postman_id":"f8c2caf3-6dfb-421b-96f9-5868e24676f6"},{"name":"Trade History","id":"68ecbf66-c8ab-4460-a1f3-5b245b15877e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/:currencyPair/trades?skip=0&limit=10","description":"Get the trade history for a given currency pair.
\nPlease note: This is not an authenticated call. More constrained rate-limiting rules will apply than when you use /marketdata/:currencyPair/tradehistory route.
Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"10"}],"variable":[{"description":{"content":"Specify the currency pair for which you want to query the trade history.
\n","type":"text/plain"},"type":"any","value":"BTCUSDT","key":"currencyPair"}]}},"response":[{"id":"01245762-f06a-4570-9630-ccd562e758d5","name":"Trade History","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.valr.com/v1/public/:currencyPair/trades?skip=0&limit=10","host":["https://api.valr.com"],"path":["v1","public",":currencyPair","trades"],"query":[{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"10","description":"Limit the results to this number. (Default and Max 100)"}],"variable":[{"key":"currencyPair","value":"BTCUSDT","description":" Specify the currency pair for which you want to query the trade history."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"cache-control","value":"max-age=30,public"},{"key":"x-valr-upstream-service-time","value":"9"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Wed, 16 Jul 2025 11:41:48 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"price\": \"93129\",\n \"quantity\": \"0.00119363\",\n \"currencyPair\": \"BTCUSDT\",\n \"tradedAt\": \"2025-07-15T12:19:21.501Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986638852,\n \"id\": \"01980e06-771d-73f1-aec8-b2fe69d943f1\",\n \"quoteVolume\": \"111.16156827\"\n },\n {\n \"price\": \"93129\",\n \"quantity\": \"0.0004428\",\n \"currencyPair\": \"BTCUSDT\",\n \"tradedAt\": \"2025-07-14T05:22:52.344Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986638835,\n \"id\": \"01980762-cd38-719d-b7ea-d75c1872719d\",\n \"quoteVolume\": \"41.2375212\"\n },\n {\n \"price\": \"93129\",\n \"quantity\": \"0.00025957\",\n \"currencyPair\": \"BTCUSDT\",\n \"tradedAt\": \"2025-07-13T12:53:11.924Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986638834,\n \"id\": \"019803d8-ba74-7e30-94e5-750c88ed6e30\",\n \"quoteVolume\": \"24.17349453\"\n },\n {\n \"price\": \"93129\",\n \"quantity\": \"0.00000637\",\n \"currencyPair\": \"BTCUSDT\",\n \"tradedAt\": \"2025-07-07T09:59:54.743Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986638499,\n \"id\": \"0197e453-ec77-74aa-aece-7c437b42f4aa\",\n \"quoteVolume\": \"0.59323173\"\n },\n {\n \"price\": \"93129\",\n \"quantity\": \"0.00003763\",\n \"currencyPair\": \"BTCUSDT\",\n \"tradedAt\": \"2025-07-07T09:59:49.731Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986638497,\n \"id\": \"0197e453-d8e3-7fb7-a8a8-2cd0c16b7fb7\",\n \"quoteVolume\": \"3.50444427\"\n }\n]"}],"_postman_id":"68ecbf66-c8ab-4460-a1f3-5b245b15877e"},{"name":"Trade History (Paginated by ID)","id":"e363142a-811d-4afe-b1e9-8ec3f97d43fa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/:currencyPair/trades?limit=5&beforeId=35f07b86-d788-43e2-96f0-9e5a7b9b56d0","description":"Get the trade history for a given currency pair.\nTrade history may be paginated by supplying a trade ID in the beforeId parameter. Only trades which occurred before the given ID will be included in the result. This allows backwards traversal of trade history by increments of limit.
To apply this method of pagination, use the last trade ID from the previous result set as the beforeId parameter of the next request.
limit and other filters can be applied with beforeId.
Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"5"},{"description":{"content":"Only include trades before this ID
\n","type":"text/plain"},"key":"beforeId","value":"35f07b86-d788-43e2-96f0-9e5a7b9b56d0"}],"variable":[{"description":{"content":"Specify the currency pair for which you want to query the trade history.
\n","type":"text/plain"},"type":"any","value":"BTCUSDC","key":"currencyPair"}]}},"response":[{"id":"5a79397c-d2b1-4244-9dac-76b562b82370","name":"Trade History (Paginated by ID)","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.valr.com/v1/public/:currencyPair/trades?limit=5&beforeId=c13c5166-c3fa-11ee-b1a8-c700095e5df0","protocol":"https","host":["api","valr","com"],"path":["v1","public",":currencyPair","trades"],"query":[{"key":"limit","value":"5","description":"Limit the results to this number. (Default and Max 100)"},{"key":"beforeId","value":"c13c5166-c3fa-11ee-b1a8-c700095e5df0","description":"Only include trades before this ID"}],"variable":[{"key":"currencyPair","value":"BTCUSDC","description":" Specify the currency pair for which you want to query the trade history."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Mon, 30 Nov 2020 09:46:48 GMT"},{"key":"cache-control","value":"max-age=30,public"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"5"},{"key":"server","value":"envoy"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"price\": \"43010\",\n \"quantity\": \"0.0001\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2024-02-05T07:39:40.198Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1203968169262186496,\n \"id\": \"b8562435-c3f9-11ee-b1a8-c700095e5df0\",\n \"quoteVolume\": \"4.301\"\n },\n {\n \"price\": \"43000\",\n \"quantity\": \"0.0001\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2024-02-05T07:38:57.121Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1203967988584153088,\n \"id\": \"9ea91c6b-c3f9-11ee-b1a8-c700095e5df0\",\n \"quoteVolume\": \"4.3\"\n },\n {\n \"price\": \"42910\",\n \"quantity\": \"0.0001\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2024-02-05T07:36:49.221Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1203967452128477184,\n \"id\": \"526cf789-c3f9-11ee-b1a8-c700095e5df0\",\n \"quoteVolume\": \"4.291\"\n },\n {\n \"price\": \"42900\",\n \"quantity\": \"0.0001\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2024-02-05T07:35:50.906Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1203967207541833728,\n \"id\": \"2faace8a-c3f9-11ee-b1a8-c700095e5df0\",\n \"quoteVolume\": \"4.29\"\n },\n {\n \"price\": \"42810\",\n \"quantity\": \"0.0001\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2024-02-05T07:21:44.816Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1203963658783162368,\n \"id\": \"375bde52-c3f7-11ee-b1a8-c700095e5df0\",\n \"quoteVolume\": \"4.281\"\n }\n]"}],"_postman_id":"e363142a-811d-4afe-b1e9-8ec3f97d43fa"},{"name":"Trade History (With Filters)","id":"f34f0b86-3f74-456f-b72c-93baa57ad20c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/:currencyPair/trades?limit=10&startTime=2025-01-01T08:51:21.604113Z&endTime=2025-07-01T08:55:29.339000Z","description":"Get the trade history for a given currency pair.\nThe results of this request may be filtered by datetime. The skip and limit parameters may be applied to paginate the filtered results.
startTime or endTimeThe startTime or endTime parameters may be used to filter the returned items by the trade date. The parameters will be interpreted as being in the UTC time zone and must be supplied in the ISO 8601 format (2020-02-29T22:00:00.000Z). These two parameters may be used together or separately. When startTime is used, trades that have occurred since startTime are returned. When endTime is used, trades that have occurred up to and including endTime are returned.
NOTE\nThe startTime and endTime parameters are optional filters. However, omitting these parameters may result in slower response times. To mitigate this, a default time window such as the most recent 30 days may be automatically applied to the request.
Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"10"},{"description":{"content":"Include only trades after this ISO 8601 start time
\n","type":"text/plain"},"key":"startTime","value":"2025-01-01T08:51:21.604113Z"},{"description":{"content":"Include only transactions before this ISO 8601 end time
\n","type":"text/plain"},"key":"endTime","value":"2025-07-01T08:55:29.339000Z"}],"variable":[{"description":{"content":"Specify the currency pair for which you want to query the trade history.
\n","type":"text/plain"},"type":"any","value":"BTCUSDC","key":"currencyPair"}]}},"response":[{"id":"cfb11097-7b7a-4b24-a0d2-c1314969c696","name":"Trade History (With Filters)","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.valr.com/v1/public/:currencyPair/trades?limit=10&startTime=2025-01-01T08:51:21.604113Z&endTime=2025-07-01T08:55:29.339000Z","host":["https://api.valr.com"],"path":["v1","public",":currencyPair","trades"],"query":[{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)","disabled":true},{"key":"limit","value":"10","description":"Limit the results to this number. (Default and Max 100)"},{"key":"startTime","value":"2025-01-01T08:51:21.604113Z","description":"Include only trades after this ISO 8601 start time"},{"key":"endTime","value":"2025-07-01T08:55:29.339000Z","description":"Include only transactions before this ISO 8601 end time"}],"variable":[{"key":"currencyPair","value":"BTCUSDC","description":" Specify the currency pair for which you want to query the trade history."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"cache-control","value":"max-age=30,public"},{"key":"x-valr-upstream-service-time","value":"31"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Wed, 16 Jul 2025 11:43:54 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"price\": \"104465\",\n \"quantity\": \"0.00017919\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-06-30T18:09:02.729Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986637005,\n \"id\": \"0197c207-3909-7fe8-b3ae-8d2a54c30fe8\",\n \"quoteVolume\": \"18.71908335\"\n },\n {\n \"price\": \"104465\",\n \"quantity\": \"0.00081797\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-06-30T18:08:22.766Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986637004,\n \"id\": \"0197c206-9cee-7f95-8df4-dc3f77027f95\",\n \"quoteVolume\": \"85.44923605\"\n },\n {\n \"price\": \"104465\",\n \"quantity\": \"0.00346537\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-06-30T18:07:55.144Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986637003,\n \"id\": \"0197c206-3108-7483-b635-1c34292cd483\",\n \"quoteVolume\": \"362.00987705\"\n },\n {\n \"price\": \"98196\",\n \"quantity\": \"0.00002036\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-06-30T14:41:47.344Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986637000,\n \"id\": \"0197c149-7950-796f-814c-6c1d82b5496f\",\n \"quoteVolume\": \"1.99927056\"\n },\n {\n \"price\": \"98196\",\n \"quantity\": \"0.00002036\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-06-30T14:36:47.235Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986636999,\n \"id\": \"0197c144-e503-7406-98dc-e65b7e4f6406\",\n \"quoteVolume\": \"1.99927056\"\n },\n {\n \"price\": \"98196\",\n \"quantity\": \"0.00002036\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-06-30T14:35:47.163Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986636998,\n \"id\": \"0197c143-fa5b-7b39-9331-3cd368f47b39\",\n \"quoteVolume\": \"1.99927056\"\n },\n {\n \"price\": \"98196\",\n \"quantity\": \"0.00002036\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-06-30T14:34:47.081Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986636997,\n \"id\": \"0197c143-0fa9-714b-835f-dc4bbeb1a14b\",\n \"quoteVolume\": \"1.99927056\"\n },\n {\n \"price\": \"98196\",\n \"quantity\": \"0.00002036\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-06-30T14:34:47.076Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986636996,\n \"id\": \"0197c143-0fa4-70c8-b9fd-4b0aa5e2f0c8\",\n \"quoteVolume\": \"1.99927056\"\n },\n {\n \"price\": \"98196\",\n \"quantity\": \"0.00002036\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-06-30T14:34:47.069Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986636995,\n \"id\": \"0197c143-0f9d-70e2-88aa-9b4b77a5e0e2\",\n \"quoteVolume\": \"1.99927056\"\n },\n {\n \"price\": \"98196\",\n \"quantity\": \"0.00002036\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-06-30T14:34:47.065Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986636994,\n \"id\": \"0197c143-0f99-78d5-8153-f32a8ec468d5\",\n \"quoteVolume\": \"1.99927056\"\n }\n]"}],"_postman_id":"f34f0b86-3f74-456f-b72c-93baa57ad20c"},{"name":"VALR Status","id":"16ccc087-4f8c-49b0-aa43-fd4f472c6a52","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/status","description":"Get the current status of VALR.
\nMay be \"online\" when all functionality is available, or \"read-only\" when only GET and OPTIONS requests are accepted. All other requests in read-only mode will respond with a 503 error code.
\n","urlObject":{"path":["v1","public","status"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"20a64a3e-9c89-46f5-b502-4e2023be27d7","name":"Online","originalRequest":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Jun 2020 08:38:14 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"Deny"},{"key":"Content-Security-Policy","value":"default-src 'none'"},{"key":"Via","value":"1.1 google"},{"key":"Cache-Control","value":"max-age=14400"},{"key":"CF-Cache-Status","value":"MISS"},{"key":"cf-request-id","value":"0310a1173f0000f47e98ae1200000001"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"59c79e053d5cf47e-JNB"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"online\"\n}"},{"id":"a8d12828-7c73-42ab-96b6-571c3b7bab3e","name":"Read Only","originalRequest":{"method":"GET","header":[],"url":"https://api.valr.com/v1/public/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Jun 2020 08:38:14 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"Deny"},{"key":"Content-Security-Policy","value":"default-src 'none'"},{"key":"Via","value":"1.1 google"},{"key":"Cache-Control","value":"max-age=14400"},{"key":"CF-Cache-Status","value":"MISS"},{"key":"cf-request-id","value":"0310a1173f0000f47e98ae1200000001"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Vary","value":"Accept-Encoding"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"59c79e053d5cf47e-JNB"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"read-only\"\n}"}],"_postman_id":"16ccc087-4f8c-49b0-aa43-fd4f472c6a52"}],"id":"7d993732-7f64-42cb-86d3-1a1d1bf04557","description":"Public APIs (APIs starting with the prefix /public) do not require authentication.
These public APIs are subject to a more constrained rate-limiting rule compared to the APIs that require authentication. These API calls will be rate limited at 10 calls per minute (as opposed to 360 calls per minute for the authenticated calls).
\nPublic routes are cached. Each response includes the following headers relating to cache directives.
\nFor additional performance or functionality, please consider the following endpoints:
\n","event":[{"listen":"prerequest","script":{"id":"95b9e25a-320a-4cad-bb9b-229a07cab2e3","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"7304e58e-857d-479c-b229-b8f7e56279d5","type":"text/javascript","exec":[""]}}],"_postman_id":"7d993732-7f64-42cb-86d3-1a1d1bf04557"},{"name":"Account","item":[{"name":"API Keys","item":[{"name":"Current API Key Info","id":"af083ac6-0514-4979-9bab-f599ea1bed4f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the current API Key's information and permissions. This information includes the label, date created, and permissions. Permission levels are View Access, Trade , Withdraw or Link Bank Account. If an API key has Whitelisted IP address ranges or Whitelisted Withdrawal addresses, the IP addresses and Currency withdrawal addresses will also be returned.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Exchange a One-Time Token (OTT) for API credentials. A partner application sends a VALROT-prefixed token issued when a user authorises the integration on VALR and receives back an API key and secret. The token is single-use and expires if not redeemed. The returned credentials inherit the OTT permissions and IP restrictions the user selected during authorisation, and can be used to sign authenticated requests to the VALR API on their behalf.
\nNote: The exchange request must be made using an existing API key with View permissions.
See How to set up your API keys for more information about using One-Time Tokens.
\n","urlObject":{"path":["v1","partner","exchange"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"a70fee59-147a-4885-8fb1-cb4457d07dfd","name":"OTT exchange","originalRequest":{"method":"POST","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"ottToken\": \"VALROT_4uNneaFRRiqoposStCrDcgy_ZcroOLZ-bkWBpYSyGDE\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.valr.com/v1/partner/exchange"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"37"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 09 Apr 2026 08:00:30 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"apiKey\": \"073079dc459ab871aa6e2abf3b63b9bd2a1da09412f902184d662470c3056bb9\",\n \"apiSecret\": \"edd3077747e43889edeb0467ba81b0a65301aae32d93bed9f667252eb368be37\",\n \"permissions\": [\n \"View access\",\n \"Trade\",\n \"Internal Transfer\",\n \"Link bank account\"\n ],\n \"allowedIpAddressCidr\": \"105.244.154.87\",\n \"whitelistedWithdrawalAddresses\": []\n}"},{"id":"bee9618b-4873-424f-aa8a-c6fe3343247f","name":"Invalid/expired OTT exchange","originalRequest":{"method":"POST","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"ottToken\": \"VALROT_4uNneaFRRiqoposStCrDcgy_ZcroOLZ-bkWBpYSyGD\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.valr.com/v1/partner/exchange"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"7"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 09 Apr 2026 08:01:30 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -11281,\n \"message\": \"Partner OTT not found\"\n}"}],"_postman_id":"c687004a-ac74-4632-9337-3af6b52c130b"}],"id":"6aef582f-f06a-4bf8-9a16-8ff357fee8b9","_postman_id":"6aef582f-f06a-4bf8-9a16-8ff357fee8b9","description":""},{"name":"Subaccounts","item":[{"name":"Subaccount","id":"3cb812ed-5511-4035-b0b7-1e89410296dd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\n"}],"url":"https://api.valr.com/v1/account/subaccount/:id","description":"Returns the subaccount and its KYC info, if available, for the provided id path variable.
The sensitive subaccount KYC data is encrypted at rest.
\n","urlObject":{"path":["v1","account","subaccount",":id"],"host":["https://api.valr.com"],"query":[],"variable":[{"id":"7bc4bb78-276a-43a7-8af1-28b8af183357","description":{"content":"The id of the subaccount.
\n","type":"text/plain"},"type":"any","value":"903671169785507840","key":"id"}]}},"response":[{"id":"09175d1e-0e4a-429c-98f2-3f793eb64654","name":"Subaccount With KYC","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n"}],"url":{"raw":"https://api.valr.com/v1/account/subaccount/:id","host":["https://api.valr.com"],"path":["v1","account","subaccount",":id"],"variable":[{"key":"id","value":"903671169785507840","description":"The id of the subaccount."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"903671169785507840\",\n \"label\": \"SubAccountWithKyc\",\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"dateOfBirth\": \"1985-06-15\",\n \"residentialCountry\": \"ZA\",\n \"identityIssuingCountry\": \"ZA\",\n \"identityType\": \"PASSPORT\",\n \"identityNumber\": \"A123456789\",\n \"identityExpiryDate\": \"2030-12-31\",\n \"cellNumber\": \"+12345678901234\",\n \"email\": \"johndoe@example.com\",\n \"purpose\": \"TRADING\",\n \"employmentStatus\": \"EMPLOYED_FULL_TIME\",\n \"sourceOfFunds\": \"ALLOWANCE\"\n}"},{"id":"7f9b8d78-762a-411c-8161-6bfffa79ec83","name":"Subaccount Without KYC","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n"}],"url":{"raw":"https://api.valr.com/v1/account/subaccount/:id","host":["https://api.valr.com"],"path":["v1","account","subaccount",":id"],"variable":[{"key":"id","value":"1278315779595685888","description":"The id of the subaccount."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"1278315779595685888\",\n \"label\": \"Arbitrage Acc 002\"\n}"}],"_postman_id":"3cb812ed-5511-4035-b0b7-1e89410296dd"},{"name":"Retrieve Subaccounts","id":"9443d7ce-c1c5-4597-b43e-d8fc2e7b49a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\n","type":"text"}],"url":"https://api.valr.com/v1/account/subaccounts","description":"Returns the list of all subaccounts that belong to a primary account, with each subaccount's label and id.
Can only be called by a primary account API key.
\n","urlObject":{"path":["v1","account","subaccounts"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"3ae538c0-8c5a-4b3a-bf6b-2a10bb32478f","name":"Retrieve Subaccounts","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature.","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n","type":"text"}],"url":"https://api.valr.com/v1/account/subaccounts"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 29 Oct 2021 15:48:19 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"196"},{"key":"server","value":"n/a"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"label\": \"Arbitrage Acc 001\",\n \"id\": \"903671169785507840\"\n },\n {\n \"label\": \"Another Test Arbitrage Acc From API\",\n \"id\": \"903670867401564160\"\n },\n {\n \"label\": \"Test Trade Acc From API\",\n \"id\": \"903267690654658560\"\n },\n {\n \"label\": \"Test Arbitrage Acc From API\",\n \"id\": \"903260643187945472\"\n },\n {\n \"label\": \"Trading\",\n \"id\": \"902529770612256768\"\n },\n {\n \"label\": \"Primary\",\n \"id\": \"0\"\n }\n]"}],"_postman_id":"9443d7ce-c1c5-4597-b43e-d8fc2e7b49a7"},{"name":"All Non Zero Balances","id":"f690f824-c254-4d85-8013-27e317addf67","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the entire portfolio's balances that are greater than 0, grouped by account for the primary account and its subaccounts. Accounts with neither balance nor debt will be returned with an empty array.
\nCan only be called using a primary account API key.
\n","urlObject":{"path":["v1","account","balances","all"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"267bb558-f7c7-4324-9a90-cf5680cb35f2","name":"All Non Zero Balances","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v1/account/balances/all"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"8"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 03 Jul 2025 07:19:07 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"account\": {\n \"label\": \"ox\",\n \"id\": \"1385226517613019136\"\n },\n \"balances\": [\n {\n \"currency\": \"ZAR\",\n \"available\": \"0\",\n \"reserved\": \"0\",\n \"total\": \"15\",\n \"updatedAt\": \"2025-07-01T10:46:29.408Z\",\n \"lendReserved\": \"0\",\n \"borrowReserved\": \"15\",\n \"borrowedAmount\": \"0\"\n }\n ]\n },\n {\n \"account\": {\n \"label\": \"API key test\",\n \"id\": \"1385148772766830592\"\n },\n \"balances\": []\n },\n {\n \"account\": {\n \"label\": \"Primary\",\n \"id\": \"0\"\n },\n \"balances\": [\n {\n \"currency\": \"ZAR\",\n \"available\": \"1265172.33437585412\",\n \"reserved\": \"0\",\n \"total\": \"1665172.33437585412\",\n \"updatedAt\": \"2025-07-01T14:14:37.218Z\",\n \"lendReserved\": \"400000\",\n \"borrowReserved\": \"0\",\n \"borrowedAmount\": \"0\"\n },\n {\n \"currency\": \"USDC\",\n \"available\": \"83241.870104015439\",\n \"reserved\": \"5.5\",\n \"total\": \"83247.370104015439\",\n \"updatedAt\": \"2025-07-03T07:19:01.245Z\",\n \"lendReserved\": \"0\",\n \"borrowReserved\": \"0\",\n \"borrowedAmount\": \"0\"\n }\n ]\n }\n]"}],"_postman_id":"f690f824-c254-4d85-8013-27e317addf67"},{"name":"Register Subaccount","id":"8e882538-9063-48c7-9620-5ec28996d69a","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"method":"POST","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\n"}],"body":{"mode":"raw","raw":"{\n\t\"label\": \"Arbitrage Acc 001\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.valr.com/v1/account/subaccount","description":"Creates a new subaccount.
\nCan only be called by a primary account API key with Trade permissions.
{\n \"label\": \"Arbitrage Acc 001\"\n}\n\nSuccessful requests return 200 - OK with the subaccount id in the body.
Note: Currently the number of subaccounts per primary account is limited to a maximum of 2000. Please contact us at business@valr.com if you require a higher limit.
\n","urlObject":{"path":["v1","account","subaccount"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"02ab100b-3fd2-40c5-a4c0-293e859642a9","name":"Register Subaccount","originalRequest":{"method":"POST","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"label\": \"Arbitrage Acc 001\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.valr.com/v1/account/subaccount"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 29 Oct 2021 15:46:35 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"482"},{"key":"server","value":"n/a"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"903671169785507840\"\n}"}],"_postman_id":"8e882538-9063-48c7-9620-5ec28996d69a"},{"name":"Register Subaccount With KYC Info","id":"526608f8-c87f-435b-ae1c-cc94104e4a82","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"method":"POST","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\n"}],"body":{"mode":"raw","raw":"{\n \"label\": \"SubAccountKyc28\",\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"dateOfBirth\": \"1985-06-15\",\n \"residentialCountry\": \"ZA\",\n \"identityIssuingCountry\": \"ZA\",\n \"identityType\": \"passport\",\n \"identityNumber\": \"A123456788\",\n \"identityExpiryDate\": \"2030-12-31\",\n \"cellNumber\": \"+123456788\",\n \"email\": \"johndoe@example.com\",\n \"purpose\": \"TRADING\",\n \"employmentStatus\": \"EMPLOYED_FULL_TIME\",\n \"sourceOfFunds\": \"ALLOWANCE\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.valr.com/v1/account/subaccount?isProprietarySubAccount=false","description":"Registering subaccounts with KYC information is not available to all clients and will not work unless VALR has specifically enabled this for your account. Please contact help@valr.com if you have already been enabled to utilise these endpoints but are having technical difficulty using them. Please contact business@valr.com if you believe these endpoints are required for your use case. Please describe in detail your business model, corporate information and regulatory licensing.
\nThese endpoints can only be called by a primary account API key with Trade permissions.
isProprietarySubAccountAn optional boolean value indicating whether to create a proprietary subaccount (label only) or a customer subaccount (including KYC data). If not provided, the default is false
Note that label, identityNumber, and cellNumber should be unique per subaccount.
The query parameter isProprietarySubAccount should be set to false.
{\n \"label\": \"SubAccountWithKyc\",\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"dateOfBirth\": \"1985-06-15\",\n \"residentialCountry\": \"ZA\",\n \"identityIssuingCountry\": \"ZA\",\n \"identityType\": \"passport\",\n \"identityNumber\": \"A123456789\",\n \"identityExpiryDate\": \"2030-12-31\",\n \"cellNumber\": \"+123456789\",\n \"email\": \"johndoe@example.com\",\n \"purpose\": \"TRADING\",\n \"employmentStatus\": \"EMPLOYED_FULL_TIME\",\n \"sourceOfFunds\": \"ALLOWANCE\"\n}\n\nNote that label should be unique per subaccount.
The query parameter isProprietarySubAccount should be set to true.
{\n \"label\": \"Arbitrage Acc 001\"\n}\n\nSuccessful requests return 200 - OK with the subaccount id in the body.
Note: Currently the number of subaccounts per primary account is limited to a maximum of 2000. Please contact us at business@valr.com if you require a higher limit.
\n","urlObject":{"path":["v1","account","subaccount"],"host":["https://api.valr.com"],"query":[{"description":{"content":"A boolean value indicating whether a proprietary subaccount or a customer subaccount will be created.
\n","type":"text/plain"},"key":"isProprietarySubAccount","value":"false"}],"variable":[]}},"response":[{"id":"221b9859-a2b6-41b7-83b2-1e9e49ce4707","name":"Register Customer Subaccount","originalRequest":{"method":"POST","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"label\": \"SubAccountWithKyc\",\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"dateOfBirth\": \"1985-06-15\",\n \"residentialCountry\": \"ZA\",\n \"identityIssuingCountry\": \"ZA\",\n \"identityType\": \"PASSPORT\",\n \"identityNumber\": \"A123456789\",\n \"identityExpiryDate\": \"2030-12-31\",\n \"cellNumber\": \"+12345678901234\",\n \"email\": \"johndoe@example.com\",\n \"purpose\": \"TRADING\",\n \"employmentStatus\": \"EMPLOYED_FULL_TIME\",\n \"sourceOfFunds\": \"ALLOWANCE\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/account/subaccount?isProprietarySubAccount=false","protocol":"https","host":["api","valr","com"],"path":["v1","account","subaccount"],"query":[{"key":"isProprietarySubAccount","value":"false","description":"A boolean value indicating whether a proprietary subaccount or a customer subaccount will be created."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 29 Oct 2021 15:46:35 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"482"},{"key":"server","value":"n/a"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"903671169785507840\"\n}"},{"id":"9e5b3de3-751a-433f-a2b1-08608356a4fc","name":"Register Proprietary Subaccount","originalRequest":{"method":"POST","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"label\": \"Arbitrage Acc 001\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/account/subaccount?isProprietarySubAccount=true","host":["https://api.valr.com"],"path":["v1","account","subaccount"],"query":[{"key":"isProprietarySubAccount","value":"true","description":"A boolean value indicating whether a proprietary subaccount or a customer subaccount will be created."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 29 Oct 2021 15:46:35 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"482"},{"key":"server","value":"n/a"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"903671169785507840\"\n}"},{"id":"7c532273-420c-4431-9971-59b9194468da","name":"Register Proprietary Subaccount failed (isProprietarySubAccount = false)","originalRequest":{"method":"POST","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"label\": \"Arbitrage Acc 001\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/account/subaccount?isProprietarySubAccount=false","host":["https://api.valr.com"],"path":["v1","account","subaccount"],"query":[{"key":"isProprietarySubAccount","value":"false","description":"A boolean value indicating whether a proprietary subaccount or a customer subaccount will be created."}]}},"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 29 Oct 2021 15:46:35 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"482"},{"key":"server","value":"n/a"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -11,\n \"message\": \"Invalid Request, please check your request and try again\",\n \"validationErrors\": {\n \"errors\": [\n {\n \"field\": \"lastName\",\n \"message\": \"must not be blank\"\n },\n {\n \"field\": \"identityIssuingCountry\",\n \"message\": \"must not be blank\"\n },\n {\n \"field\": \"sourceOfFunds\",\n \"message\": \"Invalid source of funds\"\n },\n {\n \"field\": \"dateOfBirth\",\n \"message\": \"must not be null\"\n },\n {\n \"field\": \"identityType\",\n \"message\": \"Invalid identity type\"\n },\n {\n \"field\": \"sourceOfFunds\",\n \"message\": \"must not be null\"\n },\n {\n \"field\": \"purpose\",\n \"message\": \"must not be null\"\n },\n {\n \"field\": \"identityNumber\",\n \"message\": \"must not be null\"\n },\n {\n \"field\": \"identityType\",\n \"message\": \"must not be null\"\n },\n {\n \"field\": \"purpose\",\n \"message\": \"Invalid purpose\"\n },\n {\n \"field\": \"residentialCountry\",\n \"message\": \"must not be blank\"\n },\n {\n \"field\": \"employmentStatus\",\n \"message\": \"Invalid employment status\"\n },\n {\n \"field\": \"firstName\",\n \"message\": \"must not be blank\"\n },\n {\n \"field\": \"employmentStatus\",\n \"message\": \"must not be null\"\n }\n ]\n }\n}"}],"_postman_id":"526608f8-c87f-435b-ae1c-cc94104e4a82"},{"name":"Transaction History For All Subaccounts (With Filters)","id":"e34a6e0f-8857-4a54-aab5-1fecaed779d1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Transaction history for all your sub accounts.
\nThe results of this request may be filtered by transaction types, currency and start and end time. The skip and limit parameters may be applied to paginate the filtered results.
Please note that all transactions that are returned using the provided filter criteria will be ordered by the date the transactions were created in descending order.
\nskip or limitPaginate the query results by skipping the skip newest results, and limiting the results to limit records. The default value of skip, if omitted, is 0, and the default value of limit is 100. The maximum allowed value of limit is 200.
startTime or endTimeThe startTime or endTime parameters may be used to filter the returned items by the transaction date. The parameters will be interpreted as being in the UTC time zone and must be supplied in the ISO 8601 format (2020-02-29T22:00:00.000Z). These two parameters may be used together or separately. When startTime is used, transactions that have occurred since startTime are returned. When endTime is used, transactions that have occurred up to and including endTime are returned.
Possible Scenarios:
\nWhen startTime and endTime are not provided the startTime will be defaulted to 1 day before current time and endTime will be defaulted to current time.
When startTime is specified and endTime is not specified, endTime will be defaulted to 7 days after startTime, to a maximum of current time.
When startTime is not specified and endTime is specified, startTime will be defaulted to 7 days prior to endTime.
startTime and endTime may not differ by more than 7 days.
NOTE\nThe startTime and endTime parameters are optional filters. However, omitting these parameters may result in slower response times. To mitigate this, a default time window such as the most recent 30 days may be automatically applied to the request.
transactionTypesThe transactionTypes parameter may be used to filter the returned items by a comma-separated list of transaction types from the following list of supported types:
LIMIT_BUY
\nLIMIT_SELL
\nMARKET_BUY
\nMARKET_SELL
\nSIMPLE_BUY
\nSIMPLE_SELL
\nAUTO_BUY
\nMAKER_REWARD
\nBLOCKCHAIN_RECEIVE
\nBLOCKCHAIN_SEND
\nFIAT_DEPOSIT
\nFIAT_WITHDRAWAL
\nREFERRAL_REBATE
\nREFERRAL_REWARD
\nPROMOTIONAL_REBATE
\nINTERNAL_TRANSFER
\nFIAT_WITHDRAWAL_REVERSAL
\nPAYMENT_SENT
\nPAYMENT_RECEIVED
\nPAYMENT_REVERSED
\nPAYMENT_REWARD
\nOFF_CHAIN_BLOCKCHAIN_WITHDRAW
\nOFF_CHAIN_BLOCKCHAIN_DEPOSIT
\nAUTO_BUY
\nSIMPLE_SWAP_BUY
\nSIMPLE_SWAP_SELL
\nSIMPLE_SWAP_FAILURE_REVERSAL
\ncurrencyThe currency parameter may be used to filter the returned items by the currency symbol (Example: USDC, BTC etc.). Results will include transactions where the creditCurrency or the debitCurrency matches this parameter.
Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"100"},{"disabled":true,"description":{"content":"Comma-separated list of transaction types to include
\n","type":"text/plain"},"key":"transactionTypes","value":"SIMPLE_BUY,LIMIT_BUY,MARKET_BUY"},{"disabled":true,"description":{"content":"Include only transactions in this currency
\n","type":"text/plain"},"key":"currency","value":"USDC"},{"disabled":true,"description":{"content":"Include only transactions after this ISO 8601 start time. Refer to documenration for default behaviour
\n","type":"text/plain"},"key":"startTime","value":"2024-04-24T23:14:34.252Z"},{"disabled":true,"description":{"content":"Include only transactions before this ISO 8601 end time. Refer to documenration for default behaviour
\n","type":"text/plain"},"key":"endTime","value":"2024-04-24T23:44:34.252Z"}],"variable":[]}},"response":[{"id":"fc8032f8-1059-4c42-b116-f9c1ff557e56","name":"Transaction History For All Subaccounts (With Filters)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/account/transactionhistory/subaccounts?skip=0&limit=100","host":["https://api.valr.com"],"path":["v1","account","transactionhistory","subaccounts"],"query":[{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)"},{"key":"transactionTypes","value":"SIMPLE_BUY,LIMIT_BUY,MARKET_BUY","description":"Comma-separated list of transaction types to include","disabled":true},{"key":"currency","value":"USDC","description":"Include only transactions in this currency","disabled":true},{"key":"startTime","value":"2024-04-24T23:14:34.252Z","description":"Include only transactions after this ISO 8601 start time. Refer to documenration for default behaviour","disabled":true},{"key":"endTime","value":"2024-04-24T23:44:34.252Z","description":"Include only transactions before this ISO 8601 end time. Refer to documenration for default behaviour","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"42"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 03 Jul 2025 11:44:11 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"1306231494450782208\",\n \"label\": \"Margin Trading\",\n \"transactions\": [\n {\n \"transactionType\": {\n \"type\": \"SPOT_BORROW_INTEREST_CHARGE\",\n \"description\": \"Spot Borrow Interest Charge\"\n },\n \"debitCurrency\": \"AVAX\",\n \"debitValue\": \"0.00000184\",\n \"eventAt\": \"2025-07-03T08:00:00.461Z\",\n \"additionalInfo\": {\n \"borrowAmount\": \"3.0520996\",\n \"hourlyRate\": \"6.00E-7\"\n },\n \"id\": \"0197cf4c-b5cd-7f4a-8c32-7f183d3f2f4a\"\n },\n {\n \"transactionType\": {\n \"type\": \"FUTURES_FUNDING_PAID\",\n \"description\": \"Futures Funding Paid\"\n },\n \"debitCurrency\": \"ZAR\",\n \"debitValue\": \"17.3601\",\n \"eventAt\": \"2025-07-03T08:00:00.283Z\",\n \"additionalInfo\": {\n \"notionalAmount\": \"10211.7750\",\n \"fundingRate\": \"0.001700\"\n },\n \"id\": \"0197cf4c-b51b-7cfb-8091-c4106e934cfb\"\n },\n {\n \"transactionType\": {\n \"type\": \"FUTURES_PNL_LOSS\",\n \"description\": \"Futures PNL Loss\"\n },\n \"debitCurrency\": \"USDT\",\n \"debitValue\": \"7.7287\",\n \"eventAt\": \"2025-07-03T08:00:00.081Z\",\n \"id\": \"0197cf4c-b451-7d2e-8ebd-70ecf4a37d2e\"\n },\n {\n \"transactionType\": {\n \"type\": \"FUTURES_PNL_PROFIT\",\n \"description\": \"Futures PNL Profit\"\n },\n \"creditCurrency\": \"USDT\",\n \"creditValue\": \"2.4106\",\n \"eventAt\": \"2025-07-03T00:00:00.039Z\",\n \"id\": \"0197cd95-4027-7c4a-be0e-1b3341783c4a\"\n },\n {\n \"transactionType\": {\n \"type\": \"LIMIT_SELL\",\n \"description\": \"Limit Sell\"\n },\n \"debitCurrency\": \"BNB\",\n \"debitValue\": \"0.00170601\",\n \"creditCurrency\": \"ZAR\",\n \"creditValue\": \"19.2432127566\",\n \"feeCurrency\": \"ZAR\",\n \"feeValue\": \"0.0347002434\",\n \"eventAt\": \"2025-07-03T07:08:27.822Z\",\n \"additionalInfo\": {\n \"costPerCoin\": 11300,\n \"costPerCoinSymbol\": \"R\",\n \"currencyPairSymbol\": \"BNBZAR\",\n \"orderId\": \"0197a179-8d7c-744d-9ae8-bd24830293d0\"\n },\n \"id\": \"0197cf1d-852e-7ee5-b7b6-37c630dfaee5\"\n },\n {\n \"transactionType\": {\n \"type\": \"FUTURES_FUNDING_EARNED\",\n \"description\": \"Futures Funding Earned\"\n },\n \"creditCurrency\": \"ZAR\",\n \"creditValue\": \"1876.8471\",\n \"eventAt\": \"2025-07-03T08:00:00.279Z\",\n \"additionalInfo\": {\n \"notionalAmount\": \"1104027.7500\",\n \"fundingRate\": \"0.001700\"\n },\n \"id\": \"0197cf4c-b517-7911-8d0b-7b7914129911\"\n },\n {\n \"transactionType\": {\n \"type\": \"INTERNAL_TRANSFER\",\n \"description\": \"Transfer\"\n },\n \"debitCurrency\": \"USDC\",\n \"debitValue\": \"83241.870104015439\",\n \"eventAt\": \"2025-07-03T07:19:01.245Z\",\n \"additionalInfo\": {\n \"reason\": \"SUB_ACCOUNT\",\n \"reasonDescription\": \"Transfer between subaccounts\",\n \"additional\": \"Transfer from API key test to Primary\",\n \"transferId\": \"443661\"\n },\n \"id\": \"0197cf27-2f7d-7ac8-9d29-578d356d7ac8\"\n }\n ]\n }\n]"}],"_postman_id":"e34a6e0f-8857-4a54-aab5-1fecaed779d1"},{"name":"Delete Subaccount","id":"635bd01c-61d0-45b8-bf4d-1bd9eabd9d74","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"method":"DELETE","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\n"}],"body":{"mode":"raw","raw":"{\n\t\"id\": \"1068214337466658816\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.valr.com/v1/account/subaccount","description":"Deletes an existing subaccount.
\nCan only be called by a primary account API key with Trade permissions.
{\n \"id\": \"1068214337466658816\"\n}\n\nSuccessful requests return 204 - OK.
Note: Please note the subaccount can only be deleted once all balances are transferred out.
\n","urlObject":{"path":["v1","account","subaccount"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"0b33e9cb-5453-4f72-9a8f-9f2286b083b6","name":"Delete Subaccount Accepted","originalRequest":{"method":"DELETE","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"id\": \"1242374963910606848\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.valr.com/v1/account/subaccount"},"status":"No Content","code":204,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 21 May 2024 07:15:02 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"9"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"}],"cookie":[],"responseTime":null,"body":null},{"id":"5e793ce1-78e9-49d3-975f-0d14dda56b38","name":"Delete Subaccount With Nonzero Balance","originalRequest":{"method":"DELETE","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"id\": \"1068214337466658816\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.valr.com/v1/account/subaccount"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 21 May 2024 07:16:19 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"5"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -11163,\n \"message\": \"Cannot disable sub account with balances\"\n}"}],"_postman_id":"635bd01c-61d0-45b8-bf4d-1bd9eabd9d74"},{"name":"Rename Subaccount","id":"85f683dd-7b2a-41a7-99e8-783bc92a6546","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\n"}],"body":{"mode":"raw","raw":"{\n\t\"id\": \"1068214337466658816\",\n \"label\": \"Arbitrage Acc 002\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.valr.com/v1/account/subaccount","description":"Renames subaccount label.
\nCan only be called by a primary account API key with Trade permissions.
{\n \"id\": \"1068214337466658816\",\n \"label\": \"Arbitrage Acc 002\"\n}\n\nSuccessful requests return 202 - Accepted.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\n"}],"body":{"mode":"raw","raw":"{\n \"id\": \"1277294828062744576\",\n \"label\": \"SubAccountKyc43\",\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"dateOfBirth\": \"1985-06-15\",\n \"residentialCountry\": \"ZA\",\n \"identityIssuingCountry\": \"ZA\",\n \"identityType\": \"passport\",\n \"identityNumber\": \"A293456789\",\n \"identityExpiryDate\": \"2030-12-31\",\n \"cellNumber\": \"+293456789\",\n \"email\": \"johndoe+29@example.com\",\n \"purpose\": \"TRADING\",\n \"employmentStatus\": \"FREELANCER\",\n \"sourceOfFunds\": \"ALLOWANCE\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.valr.com/v1/account/subaccount?isProprietarySubAccount=false","description":"Registering subaccounts with KYC information is not available to all clients and will not work unless VALR has specifically enabled this for your account. Please contact help@valr.com if you have already been enabled to utilise these endpoints but are having technical difficulty using them. Please contact business@valr.com if you believe these endpoints are required for your use case. Please describe in detail your business model, corporate information and regulatory licensing.
\nAdditionally these endpoints can only be called by a primary account API key with Trade permissions.
isProprietarySubAccountA boolean value indicating whether to update a proprietary subaccount (label only) or a customer subaccount (including KYC data).
\nExisting proprietary sub-accounts (label only) can be converted to customer sub-accounts (including KYC data) by making an update request with isProprietarySubAccount set to false and providing the necessary KYC information.
Note that label, identityNumber and cellNumber should be unique per subaccount.
\n{\n \"id\": \"903671169785507840\",\n \"label\": \"SubAccountWithKyc\",\n \"firstName\": \"John\",\n \"lastName\": \"Updated\",\n \"dateOfBirth\": \"1985-06-15\",\n \"residentialCountry\": \"ZA\",\n \"identityIssuingCountry\": \"ZA\",\n \"identityType\": \"PASSPORT\",\n \"identityNumber\": \"A123456789\",\n \"identityExpiryDate\": \"2030-12-31\",\n \"cellNumber\": \"+12345678901234\",\n \"email\": \"johndoe@example.com\",\n \"purpose\": \"TRADING\",\n \"employmentStatus\": \"EMPLOYED_FULL_TIME\",\n \"sourceOfFunds\": \"ALLOWANCE\"\n}\n\nA boolean value indicating whether a proprietary subaccount or a customer subaccount will be updated.
\n","type":"text/plain"},"key":"isProprietarySubAccount","value":"false"}],"variable":[]}},"response":[{"id":"1d29d370-d38b-4727-b91c-02696d103c9d","name":"Update Subaccount","originalRequest":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n"}],"body":{"mode":"raw","raw":"{\n \"id\": \"903671169785507840\",\n \"label\": \"SubAccountWithKyc\",\n \"firstName\": \"John\",\n \"lastName\": \"Updated\",\n \"dateOfBirth\": \"1985-06-15\",\n \"residentialCountry\": \"ZA\",\n \"identityIssuingCountry\": \"ZA\",\n \"identityType\": \"PASSPORT\",\n \"identityNumber\": \"A123456789\",\n \"identityExpiryDate\": \"2030-12-31\",\n \"cellNumber\": \"+12345678901234\",\n \"email\": \"johndoe@example.com\",\n \"purpose\": \"TRADING\",\n \"employmentStatus\": \"EMPLOYED_FULL_TIME\",\n \"sourceOfFunds\": \"ALLOWANCE\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/account/subaccount?isProprietarySubAccount=false","protocol":"https","host":["api","valr","com"],"path":["v1","account","subaccount"],"query":[{"key":"isProprietarySubAccount","value":"false"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"Text","header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"1e33eeb6-d9b1-45ca-bf27-90c4d8c4b38a"},{"name":"Internal Transfer Subaccounts","id":"f065f4d0-bde5-4793-874d-3b2c67f5e42d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\n","type":"text"}],"body":{"mode":"raw","raw":"{\n \"fromId\": \"0\",\n \"toId\": \"1364175408828567552\",\n \"currencyCode\": \"ZAR\",\n \"amount\": \"2.99\",\n \"allowBorrow\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://api.valr.com/v1/account/subaccounts/transfer","description":"Transfer funds between 2 accounts.
\nThe primary API key can transfer from and to any subaccount.
The subaccount API key can only transfer from itself.
Please note: The transfer process is asyncronous, to verify completion listen for balance changes or TX updates on the Account WebSocket.
\nBorrowing:
Use the allowBorrow option to borrow funds against assets in your account. Collateral is locked while the loan is outstanding. Interest accrues hourly and is capitalised into the loan. You can repay the loan whenever you prefer. Crypto Loans are only available in margin-enabled Subaccounts.
This section describes the subaccounts APIs and how to interact with them.
\nNote: An API key created on the main (primary) account can impersonate a subaccount by including the header X-VALR-SUB-ACCOUNT-ID and specifying the subaccount id, as well as adding the id to request signature. This allows the primary account to transact on behalf of the impersonated subaccount. Please see the Authentication section for more details.
Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the list of all wallets with their respective balances.
\nYou can view zero balances by specifying the excludeZeroBalances parameter to false
Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Transaction history for your account. Note: This API supports pagination.
\n","urlObject":{"path":["v1","account","transactionhistory"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Max 200)
\n","type":"text/plain"},"key":"limit","value":"100"}],"variable":[]}},"response":[{"id":"1c8531f1-30a8-4faa-a193-d401654cec9d","name":"Transaction History","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/account/transactionhistory?skip=0&limit=100","host":["https://api.valr.com"],"path":["v1","account","transactionhistory"],"query":[{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"100","description":"Limit the results to this number. (Max 200)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"302"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Fri, 04 Jul 2025 08:58:00 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"transactionType\": {\n \"type\": \"REFERRAL_REBATE\",\n \"description\": \"Referral Rebate\"\n },\n \"creditCurrency\": \"XRP\",\n \"creditValue\": \"0.00032\",\n \"eventAt\": \"2025-07-04T08:38:13.550Z\",\n \"additionalInfo\": {\n \"sourceTransactionId\": \"1057478\"\n },\n \"id\": \"0197d496-0f2e-726a-baeb-5d8b993e826a\"\n },\n {\n \"transactionType\": {\n \"type\": \"SIMPLE_BUY\",\n \"description\": \"Simple Buy\"\n },\n \"debitCurrency\": \"ZAR\",\n \"debitValue\": \"9.997956\",\n \"creditCurrency\": \"XRP\",\n \"creditValue\": \"0.1971936\",\n \"feeCurrency\": \"XRP\",\n \"feeValue\": \"0.0032064\",\n \"eventAt\": \"2025-07-04T08:38:13.407Z\",\n \"additionalInfo\": {\n \"costPerCoin\": 49.89,\n \"costPerCoinSymbol\": \"R\",\n \"currencyPairSymbol\": \"XRPZAR\",\n \"orderId\": \"0197d496-0e4e-7453-ae5b-1d930e8f3a81\"\n },\n \"id\": \"0197d496-0e9f-7ef5-8476-c45cd13ccef5\"\n },\n {\n \"transactionType\": {\n \"type\": \"SPOT_BORROW_INTEREST_CHARGE\",\n \"description\": \"Spot Borrow Interest Charge\"\n },\n \"debitCurrency\": \"AVAX\",\n \"debitValue\": \"0.00000184\",\n \"eventAt\": \"2025-07-04T08:00:00.292Z\",\n \"additionalInfo\": {\n \"borrowAmount\": \"3.05214376\",\n \"hourlyRate\": \"6.00E-7\"\n },\n \"id\": \"0197d473-1124-7a33-8f06-e6491a720a33\"\n },\n {\n \"transactionType\": {\n \"type\": \"FUTURES_FUNDING_PAID\",\n \"description\": \"Futures Funding Paid\"\n },\n \"debitCurrency\": \"ZAR\",\n \"debitValue\": \"17.5939\",\n \"eventAt\": \"2025-07-04T08:00:00.194Z\",\n \"additionalInfo\": {\n \"notionalAmount\": \"10228.9947\",\n \"fundingRate\": \"0.001720\"\n },\n \"id\": \"0197d473-10c2-7b7a-81cb-e872db623b7a\"\n },\n {\n \"transactionType\": {\n \"type\": \"FUTURES_PNL_PROFIT\",\n \"description\": \"Futures PNL Profit\"\n },\n \"creditCurrency\": \"USDT\",\n \"creditValue\": \"0.0584\",\n \"eventAt\": \"2025-07-04T08:00:00.095Z\",\n \"id\": \"0197d473-105f-762d-b6f7-a52bfa9c062d\"\n }\n]"}],"_postman_id":"a84bf578-adb8-4023-8aa0-5f74550490a8"},{"name":"Transaction History (With Filters)","id":"0d7cc0ff-b8ca-4e1f-980e-36d07672e53d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Transaction history for your account.
\nThe results of this request may be filtered by transaction types, currency and datetime. The skip and limit parameters may be applied to paginate the filtered results.
transactionTypesThe transactionTypes parameter may be used to filter the returned items by a comma-separated list of transaction types from the following list of supported types:
LIMIT_BUY
\nLIMIT_SELL
\nMARKET_BUY
\nMARKET_SELL
\nSIMPLE_BUY
\nSIMPLE_SELL
\nAUTO_BUY
\nMAKER_REWARD
\nBLOCKCHAIN_RECEIVE
\nBLOCKCHAIN_SEND
\nFIAT_DEPOSIT
\nFIAT_WITHDRAWAL
\nREFERRAL_REBATE
\nREFERRAL_REWARD
\nPROMOTIONAL_REBATE
\nINTERNAL_TRANSFER
\nFIAT_WITHDRAWAL_REVERSAL
\nPAYMENT_SENT
\nPAYMENT_RECEIVED
\nPAYMENT_REVERSED
\nPAYMENT_REWARD
\nOFF_CHAIN_BLOCKCHAIN_WITHDRAW
\nOFF_CHAIN_BLOCKCHAIN_DEPOSIT
\nSIMPLE_SWAP_BUY
\nSIMPLE_SWAP_SELL
\nSIMPLE_SWAP_FAILURE_REVERSAL
\nACCOUNT_FUNDING
\nFUND
\nFIAT_WITHDRAWAL_FEE_REVERSAL
\nCREDIT_CARD_DEPOSIT
\nSPOT_BORROW_INTEREST_CHARGE
\nSPOT_LEND_INTEREST_PAYMENT
\nLIQUIDATION_LIMIT_BUY
\nLIQUIDATION_LIMIT_SELL
\nLIQUIDATION_TAKEOVER_ASSET_TRANSFER
\nLIQUIDATION_TAKEOVER_DEBT_TRANSFER
\nFUTURES_FUNDING_EARNED
\nFUTURES_FUNDING_PAID
\nFUTURES_PNL_PROFIT
\nFUTURES_PNL_LOSS
\nFUTURES_TRADE_FEE
\nCOLLATERAL_CONVERSION_LIMIT_BUY
\nCOLLATERAL_CONVERSION_LIMIT_SELL
\ncurrencyThe currency parameter may be used to filter the returned items by the currency symbol (Example: ZAR, BTC etc.). It will include transactions where the creditCurrency or the debitCurrency matches this parameter.
startTime or endTimeThe startTime or endTime parameters may be used to filter the returned items by the transaction date. The parameters will be interpreted as being in the UTC time zone and must be supplied in the ISO 8601 format (2020-02-29T22:00:00.000Z). These two parameters may be used together or separately. When startTime is used, transactions that have occurred since startTime are returned. When endTime is used, transactions that have occurred up to and including endTime are returned.
NOTE\nThe startTime and endTime parameters are optional filters. However, omitting these parameters may result in slower response times. To mitigate this, a default time window such as the most recent 30 days may be automatically applied to the request.
Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Max 200)
\n","type":"text/plain"},"key":"limit","value":"100"},{"description":{"content":"Comma-separated list of transaction types to include.
\n","type":"text/plain"},"key":"transactionTypes","value":"SIMPLE_BUY,LIMIT_BUY,MARKET_BUY"},{"description":{"content":"Include only transactions in this currency.
\n","type":"text/plain"},"key":"currency","value":"ZAR"},{"description":{"content":"Include only transactions after this ISO 8601 start time.
\n","type":"text/plain"},"key":"startTime","value":"2020-02-29T22:00:00.000Z"},{"description":{"content":"Include only transactions before this ISO 8601 end time.
\n","type":"text/plain"},"key":"endTime","value":"2021-04-30T21:59:59.999Z"}],"variable":[]}},"response":[{"id":"af4f61b7-8b76-4679-8f10-81ad8b5292ae","name":"Transaction History (With Filters - Fiat Withdrawal)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/account/transactionhistory?skip=0&limit=100&transactionTypes=FIAT_WITHDRAWAL¤cy=ZAR&startTime=2020-02-29T22:00:00.000Z&endTime=2021-04-30T21:59:59.999Z","host":["https://api.valr.com"],"path":["v1","account","transactionhistory"],"query":[{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"100","description":"Limit the results to this number. (Max 200)"},{"key":"transactionTypes","value":"FIAT_WITHDRAWAL","description":"Comma-separated list of transaction types to include"},{"key":"currency","value":"ZAR","description":"Include only transactions in this currency"},{"key":"startTime","value":"2020-02-29T22:00:00.000Z","description":"Include only transactions after this ISO 8601 start time"},{"key":"endTime","value":"2021-04-30T21:59:59.999Z","description":"Include only transactions before this ISO 8601 end time"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Mon, 08 Feb 2021 12:13:29 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"8"},{"key":"server","value":"envoy"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"transactionType\": {\n \"type\": \"FIAT_WITHDRAWAL\",\n \"description\": \"Withdraw\"\n },\n \"debitCurrency\": \"ZAR\",\n \"debitValue\": \"1500\",\n \"feeCurrency\": \"ZAR\",\n \"feeValue\": \"8.5\",\n \"eventAt\": \"2020-12-15T15:28:12.159949Z\",\n \"additionalInfo\": {\n \"bankName\": \"Standard Bank\",\n \"accountNumber\": \"****3239\"\n },\n \"id\": \"25b83ec9-db25-4f07-882b-eddfced29341\"\n },\n {\n \"transactionType\": {\n \"type\": \"FIAT_WITHDRAWAL\",\n \"description\": \"Withdraw\"\n },\n \"debitCurrency\": \"ZAR\",\n \"debitValue\": \"14000\",\n \"feeCurrency\": \"ZAR\",\n \"feeValue\": \"8.5\",\n \"eventAt\": \"2020-12-10T19:52:45.923283Z\",\n \"additionalInfo\": {\n \"bankName\": \"Standard Bank\",\n \"accountNumber\": \"****3239\"\n },\n \"id\": \"23207113-6fe8-4236-af8e-1ed23bbc6e1c\"\n }\n]"},{"id":"ec5de17f-2cf4-416f-9616-31a673166e03","name":"Transaction History, including only buy transactions, in USDC, for a specific period","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/account/transactionhistory?skip=0&limit=100&transactionTypes=SIMPLE_BUY,LIMIT_BUY,MARKET_BUY¤cy=USDC&startTime=2023-02-29T22:00:00.000Z&endTime=2024-02-08T21:59:59.999Z","host":["https://api.valr.com"],"path":["v1","account","transactionhistory"],"query":[{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"100","description":"Limit the results to this number. (Max 200)"},{"key":"transactionTypes","value":"SIMPLE_BUY,LIMIT_BUY,MARKET_BUY","description":"Comma-separated list of transaction types to include"},{"key":"currency","value":"USDC","description":"Include only transactions in this currency"},{"key":"startTime","value":"2023-02-29T22:00:00.000Z","description":"Include only transactions after this ISO 8601 start time"},{"key":"endTime","value":"2024-02-08T21:59:59.999Z","description":"Include only transactions before this ISO 8601 end time"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Mon, 08 Feb 2021 12:16:36 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"10"},{"key":"server","value":"envoy"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"transactionType\": {\n \"type\": \"LIMIT_BUY\",\n \"description\": \"Limit Buy\"\n },\n \"debitCurrency\": \"USDC\",\n \"debitValue\": \"39.99991926\",\n \"creditCurrency\": \"BTC\",\n \"creditValue\": \"0.001378846222\",\n \"feeCurrency\": \"BTC\",\n \"feeValue\": \"0.000000413778\",\n \"eventAt\": \"2024-02-07T06:00:30.180Z\",\n \"additionalInfo\": {\n \"costPerCoin\": 29001,\n \"costPerCoinSymbol\": \"USDC\",\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"orderId\": \"3fda280f-e87e-44c8-babf-852da844e514\"\n },\n \"id\": \"32ad1950-c57e-11ee-9935-593da58a6690\"\n },\n {\n \"transactionType\": {\n \"type\": \"MARKET_BUY\",\n \"description\": \"Market Buy\"\n },\n \"debitCurrency\": \"USDC\",\n \"debitValue\": \"49.99975407\",\n \"creditCurrency\": \"BTC\",\n \"creditValue\": \"0.001723552779\",\n \"feeCurrency\": \"BTC\",\n \"feeValue\": \"0.000000517221\",\n \"eventAt\": \"2024-02-07T05:59:46.717Z\",\n \"additionalInfo\": {\n \"costPerCoin\": 29001,\n \"costPerCoinSymbol\": \"USDC\",\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"orderId\": \"da4d11b7-9bf3-4eb4-ba0b-97fd3d5be352\"\n },\n \"id\": \"18c5c7b3-c57e-11ee-9935-593da58a6690\"\n },\n {\n \"transactionType\": {\n \"type\": \"SIMPLE_BUY\",\n \"description\": \"Simple Buy\"\n },\n \"debitCurrency\": \"USDC\",\n \"debitValue\": \"99.99979815\",\n \"creditCurrency\": \"BTC\",\n \"creditValue\": \"0.0034274611\",\n \"feeCurrency\": \"BTC\",\n \"feeValue\": \"0.0000206889\",\n \"eventAt\": \"2024-02-07T05:55:26.216Z\",\n \"additionalInfo\": {\n \"costPerCoin\": 29001,\n \"costPerCoinSymbol\": \"USDC\",\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"orderId\": \"bb636989-1b1c-4aaf-bb08-e50d9713d5d0\"\n },\n \"id\": \"7d805447-c57d-11ee-9935-593da58a6690\"\n }\n]"},{"id":"2a93fc1f-1936-4b0f-b815-e4481e4de542","name":"Transaction History - Internal Transfer","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/account/transactionhistory?skip=0&limit=100&transactionTypes=INTERNAL_TRANSFER¤cy=ZAR&startTime=2024-12-09T09:29:50.254Z","host":["https://api.valr.com"],"path":["v1","account","transactionhistory"],"query":[{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"100","description":"Limit the results to this number. (Max 200)"},{"key":"transactionTypes","value":"INTERNAL_TRANSFER","description":"Comma-separated list of transaction types to include"},{"key":"currency","value":"ZAR","description":"Include only transactions in this currency"},{"key":"startTime","value":"2024-12-09T09:29:50.254Z","description":"Include only transactions after this ISO 8601 start time"},{"key":"endTime","value":"2021-04-30T21:59:59.999Z","description":"Include only transactions before this ISO 8601 end time","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Mon, 09 Dec 2024 09:38:42 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"7"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"n/a"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"transactionType\": {\n \"type\": \"INTERNAL_TRANSFER\",\n \"description\": \"Transfer\"\n },\n \"debitCurrency\": \"ZAR\",\n \"debitValue\": \"2.99\",\n \"eventAt\": \"2024-12-09T09:29:50.254Z\",\n \"additionalInfo\": {\n \"reason\": \"SUB_ACCOUNT\",\n \"reasonDescription\": \"Transfer between subaccounts\",\n \"additional\": \"Transfer from Primary to Sub Acc 001\",\n \"transferId\": \"95513\"\n },\n \"id\": \"2377cbf2-b610-11ef-b428-d52ceccfe664\"\n }\n]"}],"_postman_id":"0d7cc0ff-b8ca-4e1f-980e-36d07672e53d"},{"name":"Transaction History (Paginated by ID)","id":"c2f6db65-1fe4-4561-9e5e-d28d6a4fca9d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Transaction history for your account.
\nTransaction history may be paginated by supplying a transaction ID in the beforeId parameter. Only transactions which occurred before the given ID will be included in the result. This allows backwards traversal of transaction history by increments of limit.
To apply this method of pagination, use the last transaction ID from the previous result set as the beforeId parameter of the next request.
limit and other filters can be applied with beforeId.
Limit the results to this number. (Max 200)
\n","type":"text/plain"},"key":"limit","value":"100"},{"description":{"content":"Only include transactions before this ID
\n","type":"text/plain"},"key":"beforeId","value":"22861141-62a7-49e2-8d3f-acbaf14dd4ba"}],"variable":[]}},"response":[{"id":"5b6d5c8d-e628-42ee-b18f-352b704714e6","name":"Transaction History (Paginated by ID)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/account/transactionhistory?limit=100&beforeId=22861141-62a7-49e2-8d3f-acbaf14dd4ba","host":["https://api.valr.com"],"path":["v1","account","transactionhistory"],"query":[{"key":"limit","value":"100","description":"Limit the results to this number. (Max 200)"},{"key":"beforeId","value":"22861141-62a7-49e2-8d3f-acbaf14dd4ba","description":"Only include transactions before this ID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Mon, 08 Feb 2021 12:19:35 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"10"},{"key":"server","value":"envoy"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"transactionType\": {\n \"type\": \"MARKET_BUY\",\n \"description\": \"Market Buy\"\n },\n \"debitCurrency\": \"USDC\",\n \"debitValue\": \"49.99975407\",\n \"creditCurrency\": \"BTC\",\n \"creditValue\": \"0.001723552779\",\n \"feeCurrency\": \"BTC\",\n \"feeValue\": \"0.000000517221\",\n \"eventAt\": \"2024-02-07T05:59:46.717Z\",\n \"additionalInfo\": {\n \"costPerCoin\": 29001,\n \"costPerCoinSymbol\": \"USDC\",\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"orderId\": \"da4d11b7-9bf3-4eb4-ba0b-97fd3d5be352\"\n },\n \"id\": \"18c5c7b3-c57e-11ee-9935-593da58a6690\"\n },\n {\n \"transactionType\": {\n \"type\": \"MARKET_SELL\",\n \"description\": \"Market Sell\"\n },\n \"debitCurrency\": \"BTC\",\n \"debitValue\": \"0.00342746\",\n \"creditCurrency\": \"USDC\",\n \"creditValue\": \"99.366521098\",\n \"feeCurrency\": \"USDC\",\n \"feeValue\": \"0.029818902\",\n \"eventAt\": \"2024-02-07T05:59:35.240Z\",\n \"additionalInfo\": {\n \"costPerCoin\": 29000,\n \"costPerCoinSymbol\": \"USDC\",\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"orderId\": \"62456682-7d8b-4a6e-9da2-88887d56d1dd\"\n },\n \"id\": \"11ee122d-c57e-11ee-9935-593da58a6690\"\n },\n {\n \"transactionType\": {\n \"type\": \"SIMPLE_BUY\",\n \"description\": \"Simple Buy\"\n },\n \"debitCurrency\": \"USDC\",\n \"debitValue\": \"99.99979815\",\n \"creditCurrency\": \"BTC\",\n \"creditValue\": \"0.0034274611\",\n \"feeCurrency\": \"BTC\",\n \"feeValue\": \"0.0000206889\",\n \"eventAt\": \"2024-02-07T05:55:26.216Z\",\n \"additionalInfo\": {\n \"costPerCoin\": 29001,\n \"costPerCoinSymbol\": \"USDC\",\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"orderId\": \"bb636989-1b1c-4aaf-bb08-e50d9713d5d0\"\n },\n \"id\": \"7d805447-c57d-11ee-9935-593da58a6690\"\n },\n {\n \"transactionType\": {\n \"type\": \"INTERNAL_TRANSFER\",\n \"description\": \"Transfer\"\n },\n \"creditCurrency\": \"USDC\",\n \"creditValue\": \"100\",\n \"eventAt\": \"2023-08-30T08:44:40.529436Z\",\n \"additionalInfo\": {\n \"reason\": \"SUB_ACCOUNT\",\n \"reasonDescription\": \"Transfer between subaccounts\",\n \"additional\": \"Transfer from Primary to LL-API-Demo\"\n },\n \"id\": \"756f0448-4711-11ee-8047-611d9219726d\"\n }\n]"}],"_postman_id":"c2f6db65-1fe4-4561-9e5e-d28d6a4fca9d"},{"name":"Trade History","id":"d9fa96cd-63b3-487b-b62e-0c4b6f769ea2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Fetch the most recent trades on your account.
\nbeforeIdThe beforeId parameter may be used to paginate the trade history. Only trades which occurred before the given ID will be included in the result. This allows backwards traversal of trade history by increments of limit.
startTime or endTimeThe startTime or endTime parameters may be used to filter the returned items by the traded date. The parameters will be interpreted as being in the UTC time zone and must be supplied in the ISO 8601 format (2020-02-29T22:00:00.000Z). These two parameters may be used together or separately. When startTime is used, trades that have occurred since startTime are returned. When endTime is used, trades that have occurred up to and including endTime are returned.
NOTE\nThe startTime and endTime parameters are optional filters. However, omitting these parameters may result in slower response times. To mitigate this, a default time window such as the most recent 30 days may be automatically applied to the request.
Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"100"},{"disabled":true,"description":{"content":"Only include transactions before this ID.
\n","type":"text/plain"},"key":"beforeId","value":"c4bb69c9-b0cf-11ef-b5e9-0dde11a83386"},{"disabled":true,"description":{"content":"Include only transactions after this ISO 8601 start time.
\n","type":"text/plain"},"key":"startTime","value":"2024-11-01T13:12:12.358Z"},{"disabled":true,"description":{"content":"Include only transactions before this ISO 8601 end time.
\n","type":"text/plain"},"key":"endTime","value":"2024-11-24T11:17:02.258Z"}],"variable":[]}},"response":[{"id":"f337b54a-492b-4edf-9fde-f5a1293604fe","name":"Trade History For All Currency Pairs","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/account/tradehistory?skip=0&limit=100","host":["https://api.valr.com"],"path":["v1","account","tradehistory"],"query":[{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)"},{"key":"beforeId","value":"c4bb69c9-b0cf-11ef-b5e9-0dde11a83386","description":"Only include transactions before this ID","disabled":true},{"key":"startTime","value":"2024-11-01T13:12:12.358Z","description":"Include only transactions after this ISO 8601 start time","disabled":true},{"key":"endTime","value":"2024-11-24T11:17:02.258Z","description":"Include only transactions before this ISO 8601 end time","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"22"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Tue, 08 Jul 2025 09:17:52 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"price\": \"49.89\",\n \"quantity\": \"0.2004\",\n \"currencyPair\": \"XRPZAR\",\n \"tradedAt\": \"2025-07-04T08:38:13.407Z\",\n \"side\": \"buy\",\n \"sequenceId\": 1368928567986638030,\n \"id\": \"0197d496-0e9f-7230-9aa1-4699655e7230\",\n \"orderId\": \"0197d496-0e4e-7453-ae5b-1d930e8f3a81\",\n \"fee\": \"0.0032064\",\n \"feeCurrency\": \"XRP\"\n }\n]"},{"id":"5f739c0d-3181-4ecc-a8e6-d71857539056","name":"Trade History Paginating With beforeId","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/account/tradehistory?skip=0&limit=100&beforeId=0197d496-0e9f-7230-9aa1-4699655e7230","host":["https://api.valr.com"],"path":["v1","account","tradehistory"],"query":[{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)"},{"key":"beforeId","value":"0197d496-0e9f-7230-9aa1-4699655e7230","description":"Only include transactions before this ID."},{"key":"startTime","value":"2024-11-01T13:12:12.358Z","description":"Include only transactions after this ISO 8601 start time.","disabled":true},{"key":"endTime","value":"2024-11-24T11:17:02.258Z","description":"Include only transactions before this ISO 8601 end time.","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"19"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Tue, 08 Jul 2025 10:16:22 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"price\": \"109800\",\n \"quantity\": \"0.0001\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-04T08:37:01.499Z\",\n \"side\": \"buy\",\n \"sequenceId\": 1368928567986638028,\n \"id\": \"0197d494-f5bb-71f5-9df6-33c92a7a01f5\",\n \"orderId\": \"0197d494-f5ba-77e1-83f1-37a1fcffe446\",\n \"fee\": \"0.0000001\",\n \"feeCurrency\": \"BTC\"\n }\n]"},{"id":"9138b305-c823-4ab0-a9d8-b78c3c16bfe9","name":"Trade History With startTime And endTime","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/account/tradehistory?skip=0&limit=100&startTime=2025-07-03T12:17:02.258Z&endTime=2025-07-07T11:17:02.258Z","host":["https://api.valr.com"],"path":["v1","account","tradehistory"],"query":[{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)"},{"key":"beforeId","value":"0197d496-0e9f-7230-9aa1-4699655e7230","description":"Only include transactions before this ID.","disabled":true},{"key":"startTime","value":"2025-07-03T12:17:02.258Z","description":"Include only transactions after this ISO 8601 start time."},{"key":"endTime","value":"2025-07-07T11:17:02.258Z","description":"Include only transactions before this ISO 8601 end time."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"4"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Tue, 08 Jul 2025 10:28:22 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"price\": \"49.89\",\n \"quantity\": \"0.2004\",\n \"currencyPair\": \"XRPZAR\",\n \"tradedAt\": \"2025-07-04T08:38:13.407Z\",\n \"side\": \"buy\",\n \"sequenceId\": 1368928567986638030,\n \"id\": \"0197d496-0e9f-7230-9aa1-4699655e7230\",\n \"orderId\": \"0197d496-0e4e-7453-ae5b-1d930e8f3a81\",\n \"fee\": \"0.0032064\",\n \"feeCurrency\": \"XRP\"\n },\n {\n \"price\": \"109800\",\n \"quantity\": \"0.0001\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-04T08:37:01.499Z\",\n \"side\": \"buy\",\n \"sequenceId\": 1368928567986638028,\n \"id\": \"0197d494-f5bb-71f5-9df6-33c92a7a01f5\",\n \"orderId\": \"0197d494-f5ba-77e1-83f1-37a1fcffe446\",\n \"fee\": \"0.0000001\",\n \"feeCurrency\": \"BTC\"\n }\n]"}],"_postman_id":"d9fa96cd-63b3-487b-b62e-0c4b6f769ea2"},{"name":"Trade History For A Currency Pair","id":"11856958-9461-490e-9e01-4b1f5a2097ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get the last 100 recent trades for a given currency pair for your account. You can limit the number of trades returned by specifying the limit parameter, and the skip parameter to exclude a specified number of the latest trades from the results.
Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"100"}],"variable":[{"description":{"content":"Specify the currency pair for which you want to query the trade history.
\nExamples: SOLUSDC, BTCUSDT, ETHUSDT, AVAXUSDT.
\n","type":"text/plain"},"type":"any","value":"BTCUSDC","key":"currencyPair"}]}},"response":[{"id":"3360f0b2-1fca-4cc9-99cc-db0d4049b8f9","name":"Trade History For A Currency Pair","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/account/:currencyPair/tradehistory?limit=100","host":["https://api.valr.com"],"path":["v1","account",":currencyPair","tradehistory"],"query":[{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)","disabled":true},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)"}],"variable":[{"key":"currencyPair","value":"BTCUSDT","description":" Specify the currency pair for which you want to query the trade history. \n\nExamples: BTCUSDC, ETHUSDC, XRPUSDC, ADABTC, ADAETH etc."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"24"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Wed, 16 Jul 2025 12:34:32 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"price\": \"93129\",\n \"quantity\": \"0.0001\",\n \"currencyPair\": \"BTCUSDT\",\n \"tradedAt\": \"2025-06-13T09:21:48.393Z\",\n \"side\": \"buy\",\n \"sequenceId\": 1368928567986636114,\n \"id\": \"01976898-6969-7c30-b002-bb021d376c30\",\n \"orderId\": \"01976898-6967-7d63-88c1-8223d40cc39e\",\n \"fee\": \"0.0000001\",\n \"feeCurrency\": \"BTC\"\n }\n]"},{"id":"9ccdb4f6-04db-46f6-8ce6-93f46f172c46","name":"Trade History For A Currency Pair With Skip","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/account/:currencyPair/tradehistory?skip=0&limit=100","host":["https://api.valr.com"],"path":["v1","account",":currencyPair","tradehistory"],"query":[{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)"}],"variable":[{"key":"currencyPair","value":"BTCUSDT","description":" Specify the currency pair for which you want to query the trade history. \n\nExamples: BTCUSDC, ETHUSDC, XRPUSDC, ADABTC, ADAETH etc."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"12"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Wed, 16 Jul 2025 12:35:00 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"price\": \"93129\",\n \"quantity\": \"0.0001\",\n \"currencyPair\": \"BTCUSDT\",\n \"tradedAt\": \"2025-06-13T09:21:48.393Z\",\n \"side\": \"buy\",\n \"sequenceId\": 1368928567986636114,\n \"id\": \"01976898-6969-7c30-b002-bb021d376c30\",\n \"orderId\": \"01976898-6967-7d63-88c1-8223d40cc39e\",\n \"fee\": \"0.0000001\",\n \"feeCurrency\": \"BTC\"\n }\n]"}],"_postman_id":"11856958-9461-490e-9e01-4b1f5a2097ae"},{"name":"Trade Fees","id":"00502bc7-bf1e-40d5-b284-25fa719f0229","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the list of all currency pairs and their respective fees per order type maker, taker and simple.
The following APIs allow you to query your account balances and full transaction history.
\nThese APIs are protected and will require authentication. See the section on Authentication above to learn how to authenticate your API calls.
Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the default deposit address associated with currency specified in the path variable :currencyCode and the query param networkType (if specified).
If networkType is not specified, it will be defaulted based on the configuration for the currency that can be found at /v1/public/currencies
Please also consult the supporting documentation for the /v1/public/currencies api which illustrates different network type scenarios.
(Optional) The network type to use when depositing the specified currency. If not specified, it will be defaulted based on the currency configuration.
\n","type":"text/plain"},"key":"networkType","value":"Ethereum"}],"variable":[{"description":{"content":"The currency for which to get your deposit address
\n","type":"text/plain"},"type":"any","value":"ETH","key":"currencyCode"}]}},"response":[{"id":"7b17f895-49e1-420b-acd6-b8fb67af6faa","name":"Deposit Address","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/wallet/crypto/:currencyCode/deposit/address","host":["https://api.valr.com"],"path":["v1","wallet","crypto",":currencyCode","deposit","address"],"query":[{"key":"networkType","value":"Ethereum","description":"(Optional) The network type to use when depositing the specified currency. If not specified, it will be defaulted based on the currency configuration.","disabled":true}],"variable":[{"key":"currencyCode","value":"ETH","description":"The currency for which to get your deposit address"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Mon, 08 Feb 2021 12:35:35 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"39"},{"key":"server","value":"envoy"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"currency\": \"ETH\",\n \"address\": \"0x614A03eBc3cC4a57Da341e52e4a0E9f89221710D\",\n \"networkType\": \"Ethereum\"\n}"},{"id":"5758d182-9fec-4210-bb00-c64a879b5693","name":"Deposit Address with optional network type param","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/wallet/crypto/:currencyCode/deposit/address?networkType=Avalanche","host":["https://api.valr.com"],"path":["v1","wallet","crypto",":currencyCode","deposit","address"],"query":[{"key":"networkType","value":"Avalanche","description":"(Optional) The network type to use when depositing the specified currency. If not specified, it will be defaulted based on the currency configuration."}],"variable":[{"key":"currencyCode","value":"USDC","description":"The currency for which to get your deposit address"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Mon, 08 Feb 2021 12:35:35 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"39"},{"key":"server","value":"envoy"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"currency\": \"USDC\",\n \"address\": \"0x614A03eBc3cC4a57Da341e52e4a0E9f89221710D\",\n \"networkType\": \"Avalanche\"\n}"}],"_postman_id":"b10ea5dd-00cb-4c33-bb28-53104a8f1b7b"},{"name":"Deposit History","id":"1061d8de-3792-4a0a-8ae6-715cb8a5179e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get the Deposit History records for a given currency.
\n","urlObject":{"path":["v1","wallet","crypto","deposit","history"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"10"},{"description":{"content":"ISO 8601 string (e.g., 2025-01-01T00:00:00Z) for the start of the time range. Defaults to the earliest date if not provided.
\n","type":"text/plain"},"key":"startTime","value":"2025-01-01T00:00:00Z"},{"description":{"content":"ISO 8601 string (e.g., 2025-01-31T23:59:59Z) for the end of the time range. Defaults to the latest date if not provided.
\n","type":"text/plain"},"key":"endTime","value":"2025-01-31T23:59:59Z"},{"description":{"content":"Currency Code (e.g., BTC, ETH, XRP, ADA): The code representing the currency for which you want to retrieve historical deposit records. Leave empty to retrieve records for all currencies.
\n","type":"text/plain"},"key":"currency","value":"BTC"}],"variable":[{"type":"any","value":"BTC","key":"currencyCode"}]}},"response":[{"id":"327f269f-ef3d-4a02-ab1d-e735b2bf19f8","name":"Deposit History","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/wallet/crypto/deposit/history?skip=0&limit=10","host":["https://api.valr.com"],"path":["v1","wallet","crypto","deposit","history"],"query":[{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"10","description":"Limit the results to this number. (Default and Max 100)"},{"key":"startTime","value":"2025-01-01T00:00:00Z","description":"ISO 8601 string (e.g., 2025-01-01T00:00:00Z) for the start of the time range. Defaults to the earliest date if not provided.","disabled":true},{"key":"endTime","value":"2025-01-31T23:59:59Z","description":"ISO 8601 string (e.g., 2025-01-31T23:59:59Z) for the end of the time range. Defaults to the latest date if not provided.","disabled":true},{"key":"currency","value":"BTC","description":"Currency Code (e.g., BTC, ETH, XRP, ADA): The code representing the currency for which you want to retrieve historical deposit records. Leave empty to retrieve records for all currencies.","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"19"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 31 Jul 2025 07:05:19 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencyCode\": \"ETH\",\n \"receiveAddress\": \"0xcfb6fdfc030ec1b51eb1a03689f19735fdebe3b0\",\n \"transactionHash\": \"0xd97ca2ce13707cce6ce2b211499e14d04ce104250dbeb0b59359563c05a0577d\",\n \"amount\": \"0.0005\",\n \"createdAt\": \"2025-06-05T08:40:48Z\",\n \"confirmations\": 5,\n \"confirmed\": true,\n \"confirmedAt\": \"2025-06-05T08:41:56.879293Z\"\n }\n]"}],"_postman_id":"1061d8de-3792-4a0a-8ae6-715cb8a5179e"},{"name":"Whitelisted Withdrawal Address Book","id":"b54b42e0-d721-4cc7-b6c2-59cb05b39568","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"Your API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns all the withdrawal addresses whitelisted for this account.
\nThe optional networkType can be used to filter addresses further.
Each withdrawal address has a type field indicating how it is scoped:
\nCURRENCY_SPECIFIC — the address is linked to a specific currency and network type.
UNIVERSAL — the address is linked to a network type only and can be used for any currency on that network.
(Optional) The network type used to filter the address book. If not specified, all addresses are returned.
\n","type":"text/plain"},"key":"networkType","value":"Ethereum"}],"variable":[]}},"response":[{"id":"9197401e-a4f4-4966-8e8c-1130213d3a9d","name":"Whitelisted Withdrawal Address Book","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v1/wallet/crypto/address-book"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Mon, 30 Nov 2020 13:07:47 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"15"},{"key":"server","value":"envoy"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"2a22433a-1548-11eb-adc1-0242ac120002\",\n \"label\": \"My Secure Address\",\n \"currency\": \"BTC\",\n \"address\": \"2N5jUhwzndtTUXspDGJkAvP7WCCRLQkgMfX\",\n \"networkType\": \"Bitcoin\",\n \"createdAt\": \"2020-11-30T10:18:54.994930Z\",\n \"type\": \"CURRENCY_SPECIFIC\",\n \"beneficiaryName\": \"Satoshi Nakamoto\",\n \"isCorporate\": false,\n \"isSelfHosted\": false,\n \"serviceProviderName\": \"Binance\" \n },\n {\n \"id\": \"f7027162-8dc1-4619-88e2-1587145df376\",\n \"label\": \"Ethereum Universal Address\",\n \"address\": \"0xc6d9d2cd449a754c494264e1809c50e34d64562b\",\n \"networkType\": \"Ethereum\",\n \"createdAt\": \"2026-02-05T08:54:41.631247Z\",\n \"type\": \"UNIVERSAL\",\n \"beneficiaryName\": \"Wallet\",\n \"isCorporate\": false,\n \"isSelfHosted\": true\n } \n]"}],"_postman_id":"b54b42e0-d721-4cc7-b6c2-59cb05b39568"},{"name":"Whitelisted Withdrawal Address Book for a currency","id":"f4c4548b-67b0-4f55-80c0-62b605926c6d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"Your API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns all the withdrawal addresses whitelisted for this account and the currency specified in the path variable :currencyCode.
The optional networkType can be used to filter addresses further. If networkType is not provided, universal addresses will be included in the result if the :currencyCode provided is supported by those universal addresses.
Each withdrawal address has a type field indicating how it is scoped:
\nCURRENCY_SPECIFIC — the address is linked to a specific currency and network type.
UNIVERSAL — the address is linked to a network type only and can be used for any currency on that network.
(Optional) The network type used to filter the address book.
\n","type":"text/plain"},"key":"networkType","value":"Ethereum"}],"variable":[{"description":{"content":"Specify the currency for which you want to query the address book
\n","type":"text/plain"},"type":"any","value":"BTC","key":"currencyCode"}]}},"response":[{"id":"28e0ff80-f39d-459a-88b9-ba256b7aacd8","name":"Whitelisted Withdrawal Address Book for a currency","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/wallet/crypto/address-book/:currencyCode","host":["https://api.valr.com"],"path":["v1","wallet","crypto","address-book",":currencyCode"],"variable":[{"key":"currencyCode","value":"USDC"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Mon, 30 Nov 2020 13:08:45 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"6"},{"key":"server","value":"envoy"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"a6c46997-98a9-4e2f-b27b-d2b39466e1db\",\n \"label\": \"Stellar USDC\",\n \"currency\": \"USDC\",\n \"address\": \"GC6BZQERWJX36DE5YKWHUBSY5V7KNJRDKSPIMNNI2I72QXURPDE6G3VY\",\n \"networkType\": \"StellarLumens\",\n \"paymentReference\": \"123\",\n \"createdAt\": \"2025-10-03T09:48:55.483059Z\",\n \"type\": \"CURRENCY_SPECIFIC\",\n \"beneficiaryName\": \"Wallet\",\n \"isCorporate\": false,\n \"isSelfHosted\": true\n },\n {\n \"id\": \"f7027162-8dc1-4619-88e2-1587145df376\",\n \"label\": \"Ethereum Universal Address\",\n \"address\": \"0xc6d9d2cd449a754c494264e1809c50e34d64562b\",\n \"networkType\": \"Ethereum\",\n \"createdAt\": \"2026-02-05T08:54:41.631247Z\",\n \"type\": \"UNIVERSAL\",\n \"beneficiaryName\": \"Wallet\",\n \"isCorporate\": false,\n \"isSelfHosted\": true\n } \n]"}],"_postman_id":"f4c4548b-67b0-4f55-80c0-62b605926c6d"},{"name":"Withdrawal Config Info","id":"b44b9b19-3e9b-45b0-be2b-0adc35caf480","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get all the information about withdrawing a given currency from your VALR account. That will include withdrawal costs, minimum withdrawal amount etc.
\nIf networkType is not specified, it will be defaulted based on the configuration for the currency that can be found at /v1/public/currencies
Please also consult the supporting documentation for the /v1/public/currencies api which illustrates different scenarios by example.
The withdrawalDecimalPlaces specified is the maximum scale of the value that will be submitted to the network and will be rounded down to that scale if a value with a larger scale is provided.
(Optional) The network type to use when retrieving the currency config for the specified currency. If not specified, it will be defaulted based on the currency configuration.
\n","type":"text/plain"},"key":"networkType","value":"Bitcoin"}],"variable":[{"description":{"content":"This is the currency code of the currency you want withdrawal information about.
\nExamples: BTC, ETH, XRP, ADA, etc.
\n","type":"text/plain"},"type":"any","value":"BTC","key":"currencyCode"}]}},"response":[{"id":"0c40e0fa-5330-4b66-9a4d-1c0f17c9fba2","name":"Withdrawal Configuration information","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate request signature"}],"url":{"raw":"https://api.valr.com/v1/wallet/crypto/:currencyCode/withdraw","protocol":"https","host":["api","valr","com"],"path":["v1","wallet","crypto",":currencyCode","withdraw"],"query":[{"key":"networkType","value":"Bitcoin","description":"(Optional) The network type to use when retrieving the currency config for the specified currency. If not specified, it will be defaulted based on the currency configuration.","disabled":true}],"variable":[{"key":"currencyCode","value":"BTC","description":"This is the currency code of the currency you want withdrawal information about.\nExamples: BTC, ETH, XRP, ADA, etc."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 20 Apr 2019 14:38:07 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"Deny"},{"key":"Content-Security-Policy","value":"default-src 'none'"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"},{"key":"Strict-Transport-Security","value":"max-age=0; includeSubDomains; preload"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"4ca7dc2f7b99ac5a-JNB"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"currency\": \"BTC\",\n \"minimumWithdrawAmount\": \"0.0002\",\n \"withdrawalDecimalPlaces\": \"8\",\n \"isActive\": true,\n \"withdrawCost\": \"0.00013\",\n \"supportsPaymentReference\": false,\n \"networkType\": \"Bitcoin\"\n}"}],"_postman_id":"b44b9b19-3e9b-45b0-be2b-0adc35caf480"},{"name":"New Withdrawal","id":"d92b3f29-86a8-4f3b-85e6-30331409ffa8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC, then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Withdraw cryptocurrency funds to an address.
\nWithdrawals created with more decimals than the number supported by the currency will be rounded down to the withdrawalDecimalPlaces specified for the network (see documentation on the /v1/public/currencies endpoint for more info)
The request body for currencies supporting a memo or payment reference, such as XRP, XMR, XEM or XLM, will accept an optional field called \"paymentReference\". The max length for the paymentReference is 256 characters.
Withdrawal using an address:
\nNetwork Type
\nnetworkType is a request field that can be optionally supplied to specify the network that should used for the withdrawal. It is very important to make sure that the networkType supplied corresponds to the withdrawal address supplied. In cases where the incorrect networkType is supplied for an address it may result in loss of funds.
If networkType is not specified, it will be defaulted based on the configuration for the currency that can be found at /v1/public/currencies
Beneficiary Information
\nbeneficiaryName, isCorporate, isSelfHosted, serviceProviderId and serviceProviderName are new fields to support the collection of the beneficiary's (recipient's) information. This information will be mandatory after 30 April 2025 is accordance with South Africa regulation that governs crypto asset service providers like VALR.Please also consult the supporting documentation for the /v1/public/currencies API which illustrates different network type scenarios.
Withdrawal using an addressBookId:
\nNetwork Type
\naddressBookId, networkType does not need to be specified as the networkType of the addressBook entry will be used.Beneficiary Information
\nProvided that the address book has beneficiary information saved, beneficiary related fields do not need to be supplied in the withdrawal request.
\nIf the address book DOES NOT have beneficiary information stored, you can update it via our web and mobile clients, or supply the information in the same way one would when performing a withdrawal to an address.
\nbeneficiaryName, isCorporate, isSelfHosted, serviceProviderId and serviceProviderName are new fields to support the collection of the beneficiary's (recipient's) information. This information will be mandatory after 30 April 2025, in accordance with South African regulations that govern crypto asset service providers like VALR.
Borrowing:
Use the allowBorrow option to borrow funds against assets in your account. Collateral is locked while the loan is outstanding. Interest accrues hourly and is capitalised into the loan. You can repay the loan whenever you prefer. Crypto Loans are only available in margin-enabled Subaccounts.
The Request Body
\nAn example of the request body is as follows:
\n{\n \"amount\": \"0.0005\",\n \"address\": \"2N1rvRDR3fUD6L43QxG5Awy8RHC8nCavAnc\",\n \"networkType\": \"Bitcoin\",\n \"allowBorrow\": false,\n \"beneficiaryName\": \"Satoshi Nakamoto\",\n \"isCorporate\": false,\n \"isSelfHosted\": false,\n \"serviceProviderId\": \"6720c583142afc3bc573c133\"\n}\n\nThis is the currency code for the currency you are withdrawing. Examples: BTC, ETH, XRP, ADA, etc.
\n","type":"text/plain"},"type":"any","value":"BTC","key":"currencyCode"}]}},"response":[{"id":"88d72c08-6fde-452e-b037-e098c5b161b2","name":"New Withdrawal to an exchange hosted address using ID Accepted","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`, then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"amount\": \"0.0005\",\n \"address\": \"0x289008cef8Ca791Ee49a61DD0de0dF954aa2C9e8\",\n \"networkType\": \"Ethereum\",\n \"allowBorrow\": false,\n \"beneficiaryName\": \"Vitalik Buterin\",\n \"isCorporate\": false,\n \"isSelfHosted\": false,\n \"serviceProviderId\": \"6720c583142afc3bc573c133\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/wallet/crypto/:currencyCode/withdraw","host":["https://api.valr.com"],"path":["v1","wallet","crypto",":currencyCode","withdraw"],"variable":[{"key":"currencyCode","value":"ETH","description":"This is the currency code for the currency you are withdrawing. Examples: BTC, ETH, XRP, ADA, etc."}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 20 May 2025 12:55:11 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"1004"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"686ce4b8-1504-4f9c-b217-f6f24300cfb3\"\n}"},{"id":"cc1db523-a8cc-459f-a07d-17952ce134ad","name":"New Withdrawal to an exchange hosted address using Name Accepted","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`, then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"amount\": \"0.0005\",\n \"address\": \"0xCfb6fDFC030Ec1b51eB1a03689F19735fDEbE3B0\",\n \"networkType\": \"Ethereum\",\n \"allowBorrow\": false,\n \"beneficiaryName\": \"Vitalik Buterin\",\n \"isCorporate\": false,\n \"isSelfHosted\": false,\n \"serviceProviderName\": \"Unlisted Exchange (Pty) Ltd\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/wallet/crypto/:currencyCode/withdraw","host":["https://api.valr.com"],"path":["v1","wallet","crypto",":currencyCode","withdraw"],"variable":[{"key":"currencyCode","value":"ETH","description":"This is the currency code for the currency you are withdrawing. Examples: BTC, ETH, XRP, ADA, etc."}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 20 May 2025 13:00:51 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"605"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"dee33527-d514-4229-860b-35e0cfc9139f\"\n}"},{"id":"0a5ae85d-e41d-4419-9e21-cb04ba4c39bf","name":"New Withdrawal to a self-hosted address Accepted","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`, then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"amount\": \"0.0005\",\n \"address\": \"0xCfb6fDFC030Ec1b51eB1a03689F19735fDEbE3B0\",\n \"networkType\": \"Ethereum\",\n \"allowBorrow\": false,\n \"beneficiaryName\": \"Vitalik Buterin\",\n \"isCorporate\": false,\n \"isSelfHosted\": true\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/wallet/crypto/:currencyCode/withdraw","host":["https://api.valr.com"],"path":["v1","wallet","crypto",":currencyCode","withdraw"],"variable":[{"key":"currencyCode","value":"ETH","description":"This is the currency code for the currency you are withdrawing. Examples: BTC, ETH, XRP, ADA, etc."}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 20 May 2025 13:06:09 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"2059"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"bf1abcb8-16d4-48be-aace-e4d465437c7e\"\n}"},{"id":"ec22d235-17bb-4c46-985b-479e2e98e6c9","name":"New Withdrawal using an address book id Accepted","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`, then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"amount\": \"0.0002\",\n \"addressBookId\": \"ed35f60b-9dcf-4baf-bcdd-643691044ac3\",\n \"allowBorrow\": false\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/wallet/crypto/:currencyCode/withdraw","host":["https://api.valr.com"],"path":["v1","wallet","crypto",":currencyCode","withdraw"],"variable":[{"key":"currencyCode","value":"BTC","description":"This is the currency code for the currency you are withdrawing. Examples: BTC, ETH, XRP, ADA, etc."}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 20 May 2025 13:10:30 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"72"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"bcff39b3-7fbc-4582-b6f7-53a3597373a0\"\n}"},{"id":"fc7829cc-bdeb-4ac3-98b4-c711d9a3e42d","name":"Allow borrow margin not enabled for account Unsuccessful","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`, then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"amount\": \"0.0005\",\n \"address\": \"2N1rvRDR3fUD6L43QxG5Awy8RHC8nCavAnc\",\n \"networkType\": \"Bitcoin\",\n \"allowBorrow\": true,\n \"beneficiaryName\": \"Vitalik Buterin\",\n \"isCorporate\": false,\n \"isSelfHosted\": false,\n \"serviceProviderId\": \"6720c583142afc3bc573c133\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/wallet/crypto/:currencyCode/withdraw","host":["https://api.valr.com"],"path":["v1","wallet","crypto",":currencyCode","withdraw"],"variable":[{"key":"currencyCode","value":"BTC","description":"This is the currency code for the currency you are withdrawing. Examples: BTC, ETH, XRP, ADA, etc."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 20 May 2025 13:14:38 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"60"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -19213,\n \"message\": \"Margin not enabled for account\"\n}"},{"id":"0f9272dc-ab8d-491e-b9fb-40e20e744d33","name":"Invalid JSON","originalRequest":{"method":"POST","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate request signature"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"amount\": \"0.0001\",\n \"address\": \"194CnYJwAYaW3Pj1GvCoBESmPRTFHy68JK\",\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/wallet/crypto/:currencyCode/withdraw","protocol":"https","host":["api","valr","com"],"path":["v1","wallet","crypto",":currencyCode","withdraw"],"variable":[{"key":"currencyCode","value":"BTC","description":"This is the currency code for the currency you are withdrawing. Examples: BTC, ETH, XRP, ADA, etc."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 20 Apr 2019 14:32:48 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"Deny"},{"key":"Content-Security-Policy","value":"default-src 'none'"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"},{"key":"Strict-Transport-Security","value":"max-age=0; includeSubDomains; preload"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"4ca7d4653cc7ac5a-JNB"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -113,\n \"message\": \"Invalid JSON payload\"\n}"}],"_postman_id":"d92b3f29-86a8-4f3b-85e6-30331409ffa8"},{"name":"Withdrawal Status","id":"b1f5aae3-c896-4a7f-a20a-ff4d67ea8007","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Check the status of a withdrawal.
\n","urlObject":{"path":["v1","wallet","crypto",":currencyCode","withdraw",":withdrawId"],"host":["https://api.valr.com"],"query":[],"variable":[{"description":{"content":"This is the currency code for the currency you have withdrawn. Examples: BTC, ETH, XRP, ADA, etc.
\n","type":"text/plain"},"type":"string","value":"BTC","key":"currencyCode"},{"description":{"content":"The unique id that represents your withdrawal request. This is provided as a response to the API call to withdraw.
\n","type":"text/plain"},"type":"string","value":"b8e2e6c0-5215-4f6b-80b4-a664b2b6ef94","key":"withdrawId"}]}},"response":[{"id":"f5c9f88e-ce2b-4a17-8115-d850670d6d48","name":"Withdrawal Status","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/wallet/crypto/:currencyCode/withdraw/:withdrawId","host":["https://api.valr.com"],"path":["v1","wallet","crypto",":currencyCode","withdraw",":withdrawId"],"variable":[{"key":"currencyCode","value":"BTC","description":"This is the currency code for the currency you have withdrawn. Examples: BTC, ETH, XRP, ADA, etc.\n"},{"key":"withdrawId","value":"b8e2e6c0-5215-4f6b-80b4-a664b2b6ef94","description":"The unique id that represents your withdrawal request. This is provided as a response to the API call to withdraw.\n"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 20 May 2019 14:50:49 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"Deny"},{"key":"Content-Security-Policy","value":"default-src 'none'"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"4d9f2009085f563d-JNB"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"currency\": \"BTC\",\n \"address\": \"mkHS9ne12qx9pS9VojpwU5xtRd4T7X7ZUt\",\n \"amount\": \"0.001\",\n \"feeAmount\": \"0.0002\",\n \"transactionHash\": \"1558363779645\",\n \"confirmations\": 2,\n \"lastConfirmationAt\": \"2019-05-20T14:49:59.659675\",\n \"uniqueId\": \"b8e2e6c0-5215-4f6b-80b4-a664b2b6ef94\",\n \"createdAt\": \"2019-05-20T14:49:39.609Z\",\n \"verified\": true,\n \"status\": \"Processing\",\n \"networkType\": \"Bitcoin\"\n}"}],"_postman_id":"b1f5aae3-c896-4a7f-a20a-ff4d67ea8007"},{"name":"Service Providers","id":"5ad83869-49e9-4f38-b79d-f5c1df2c4266","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the list of known service providers for use when performing a new crypto withdrawal.
\n","urlObject":{"path":["v1","wallet","crypto","service-providers"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"fa0cce41-eeca-4dfe-9f78-1c51fb2feabd","name":"Service Providers","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v1/wallet/crypto/service-providers"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Mon, 08 Feb 2021 12:35:35 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"39"},{"key":"server","value":"envoy"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"672b1ff8a1ff8a027906ff39\",\n \"name\": \"Bybit\"\n },\n {\n \"id\": \"676d1c189ef2fd542e5bbf33\",\n \"name\": \"Binance\"\n }\n]"}],"_postman_id":"5ad83869-49e9-4f38-b79d-f5c1df2c4266"},{"name":"Withdrawal History","id":"d166dbf5-e922-4037-b0a7-5d490796662c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get Withdrawal History records for a given currency.
\n","urlObject":{"path":["v1","wallet","crypto","withdraw","history"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"10"},{"description":{"content":"Currency Code (e.g., BTC, ETH, XRP, ADA): The code representing the currency for which you want to retrieve historical withdrawal records. Leave empty to retrieve records for all currencies.
\n","type":"text/plain"},"key":"currency","value":"BTC"},{"description":{"content":"ISO 8601 string (e.g., 2025-01-01T00:00:00Z) for the start of the time range. Defaults to the earliest available date if not provided.
\n","type":"text/plain"},"key":"startTime","value":"2025-01-01T00:00:00Z"},{"description":{"content":"ISO 8601 string (e.g., 2025-02-31T23:59:59Z) for the end of the time range. Defaults to the latest date if not provided.
\n","type":"text/plain"},"key":"endTime","value":"2025-01-31T23:59:59Z"}],"variable":[{"type":"any","value":"BTC","key":"currencyCode"}]}},"response":[{"id":"ed5e2e7a-c869-4359-9df2-b8e9b9548129","name":"Withdrawal History","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate request signature"}],"url":"https://api.valr.com/v1/wallet/crypto/withdraw/history"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 23 Apr 2019 07:42:10 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"Deny"},{"key":"Content-Security-Policy","value":"default-src 'none'"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"},{"key":"Strict-Transport-Security","value":"max-age=0; includeSubDomains; preload"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"4cbe33024de15645-JNB"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currency\": \"USDC\",\n \"address\": \"0x388C818CA8B9251b393131C08a736A67ccB11297\",\n \"amount\": \"10\",\n \"feeAmount\": \"20\",\n \"transactionHash\": \"0xbf21b35945b41aeab5a081a878b0ed6c317639018718a56b0446a6747b3407a5\",\n \"confirmations\": 6,\n \"lastConfirmationAt\": \"2025-01-07T14:22:32.419194\",\n \"uniqueId\": \"e1221de5-c494-4b75-bd0d-63e106879c08\",\n \"createdAt\": \"2025-01-07T14:19:17.861765Z\",\n \"verified\": true,\n \"status\": \"Complete\",\n \"networkType\": \"Ethereum\"\n },\n {\n \"currency\": \"ETH\",\n \"address\": \"0x388C818CA8B1251b393131C08a736A67ccB19297\",\n \"amount\": \"0.001\",\n \"feeAmount\": \"0.0018\",\n \"transactionHash\": \"0xae971c7f1bc35f53203c14f289e80ba4c30c4f1591e3be19fbc6bffbcd5d46aa\",\n \"confirmations\": 6,\n \"lastConfirmationAt\": \"2025-01-07T14:12:55.543998\",\n \"uniqueId\": \"ff9614bb-78f4-44ca-9694-7d8cfd341633\",\n \"createdAt\": \"2025-01-07T14:11:06.482998Z\",\n \"verified\": true,\n \"status\": \"Complete\",\n \"networkType\": \"Ethereum\"\n }\n]"}],"_postman_id":"d166dbf5-e922-4037-b0a7-5d490796662c"}],"id":"4a7b4353-3f48-45d1-b096-b7638901ddf7","description":"This section describes how to use the Cryptocurrency Wallet APIs.
\n","event":[{"listen":"prerequest","script":{"id":"8591d350-c4a4-43b5-a5ac-a930f115c484","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"777c966d-375f-4b93-ae80-b1221b5c52c3","type":"text/javascript","exec":[""]}}],"_postman_id":"4a7b4353-3f48-45d1-b096-b7638901ddf7"},{"name":"Fiat","item":[{"name":"Add Bank Account","id":"63a97644-8783-48cb-999c-31b6f0b54753","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Link a bank account to your VALR account for fiat withdrawals.
\nThe bank field should contain a valid bank identifier. Use the Banks for Currency request for a list of supported banks for the given currency.
The country field must be the valid 2 character ISO 3166‑1 code for the country in which the bank account is registered.
The currency code for the fiat currency. Supported: ZAR.
\n","type":"text/plain"},"type":"any","value":"ZAR","key":"currencyCode"}]}},"response":[{"id":"0ed2eced-901f-4ee1-981c-6d392950b970","name":"Add Bank Account","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"bank\": \"FNB\",\n \"accountHolder\": \"Frodo Baggins\",\n \"accountNumber\": \"62792461544\",\n \"branchCode\": \"040000\",\n \"accountType\": \"CHEQUE\",\n \"country\": \"ZA\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/wallet/fiat/:currencyCode/accounts","host":["https://api.valr.com"],"path":["v1","wallet","fiat",":currencyCode","accounts"],"variable":[{"key":"currencyCode","value":"ZAR","description":"The currency code for the fiat currency. Supported: ZAR, ZMW."}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 03 Mar 2023 14:41:52 GMT"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"Deny"},{"key":"Content-Security-Policy","value":"default-src 'none'"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"a317d907-7439-447c-879f-c05bddfedadc\",\n \"bankCode\": \"FNB\",\n \"bankName\": \"FNB/RMB\",\n \"accountHolder\": \"Frodo Baggins\",\n \"accountNumber\": \"62792461544\",\n \"branchCode\": \"040000\",\n \"accountType\": \"Current/Cheque\",\n \"status\": \"VERIFIED\",\n \"insertedAt\": \"2023-03-03T14:41:53.841072Z\",\n \"updatedAt\": \"2023-03-03T14:41:54.062808Z\",\n \"country\": \"ZA\",\n \"currency\": {\n \"symbol\": \"R\",\n \"decimalPlaces\": 2,\n \"isActive\": true,\n \"shortName\": \"ZAR\",\n \"longName\": \"Rand\",\n \"supportedWithdrawDecimalPlaces\": 2,\n \"collateral\": true,\n \"collateralWeight\": \"1\"\n }\n}"}],"_postman_id":"63a97644-8783-48cb-999c-31b6f0b54753"},{"name":"Bank Account Detail","id":"379d73fd-52dd-47bb-9aed-a20baf44b4d0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get the details of a linked bank account.
\n","urlObject":{"path":["v1","wallet","fiat",":currencyCode","accounts",":id"],"host":["https://api.valr.com"],"query":[],"variable":[{"description":{"content":"The currency code for the fiat currency. Supported: ZAR.
\n","type":"text/plain"},"type":"any","value":"ZAR","key":"currencyCode"},{"description":{"content":"The UUID identifier of the linked bank account.
\n","type":"text/plain"},"type":"any","value":"47818b9d-1fdf-48b3-97f4-2578b5456a9a","key":"id"}]}},"response":[{"id":"6199052f-688a-43bf-a231-24b0dcf3fd15","name":"Bank Account Detail","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/wallet/fiat/:currencyCode/accounts/:id","host":["https://api.valr.com"],"path":["v1","wallet","fiat",":currencyCode","accounts",":id"],"variable":[{"key":"currencyCode","value":"ZAR","description":"The currency code for the fiat currency. Supported: ZAR, ZMW."},{"key":"id","value":"47818b9d-1fdf-48b3-97f4-2578b5456a9a","description":"The UUID identifier of the linked bank account."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Mon, 27 Feb 2023 13:49:08 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"115"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"47818b9d-1fdf-48b3-97f4-2578b5456a9a\",\n \"bank\": \"FNB/RMB\",\n \"accountHolder\": \"Frodo Baggins\",\n \"accountNumber\": \"62004626662\",\n \"branchCode\": \"250655\",\n \"accountType\": \"Current/Cheque\",\n \"createdAt\": \"2019-08-08T08:30:27.495181Z\",\n \"country\": \"ZA\"\n}"}],"_postman_id":"379d73fd-52dd-47bb-9aed-a20baf44b4d0"},{"name":"Bank Accounts","id":"e7b13f1d-9740-4452-9653-141e1055d03b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get a list of bank accounts that are linked to your VALR account. Bank accounts can be linked by signing in to your account on www.VALR.com or by using the Add Bank Account request.
The currency code for the fiat currency. Supported: ZAR.
\n","type":"text/plain"},"type":"any","value":"ZAR","key":"currencyCode"}]}},"response":[{"id":"e6a0d20f-a89a-45ee-8692-d7999efb2dcf","name":"Bank Accounts","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/wallet/fiat/:currencyCode/accounts","host":["https://api.valr.com"],"path":["v1","wallet","fiat",":currencyCode","accounts"],"variable":[{"key":"currencyCode","value":"ZAR","description":"The currency code for the fiat currency. Supported: ZAR, ZMW."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 03 Mar 2023 14:42:42 GMT"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"Deny"},{"key":"Content-Security-Policy","value":"default-src 'none'"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"a4368195-571b-499f-93ae-717c44f92b1b\",\n \"bank\": \"FNB/RMB\",\n \"accountHolder\": \"Frodo Baggins\",\n \"accountNumber\": \"62792461544\",\n \"branchCode\": \"040000\",\n \"accountType\": \"Current/Cheque\",\n \"createdAt\": \"2023-03-03T14:37:24.095872Z\",\n \"country\": \"ZA\"\n }\n]"}],"_postman_id":"e7b13f1d-9740-4452-9653-141e1055d03b"},{"name":"Delete Bank Account","id":"44e93d34-9fb6-4483-b1c9-30a8c731d65f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Delete a linked bank account.
\n","urlObject":{"path":["v1","wallet","fiat",":currencyCode","accounts",":id"],"host":["https://api.valr.com"],"query":[],"variable":[{"description":{"content":"The currency code for the fiat currency. Supported: ZAR.
\n","type":"text/plain"},"type":"any","value":"ZAR","key":"currencyCode"},{"description":{"content":"The UUID identifier of the linked bank account to delete.
\n","type":"text/plain"},"type":"any","value":"3d33ca42-73d3-45b3-a44d-434dd159ec6d","key":"id"}]}},"response":[{"id":"408f7af5-676b-4134-b5e5-8d348328b075","name":"Delete Bank Account","originalRequest":{"method":"DELETE","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/wallet/fiat/:currencyCode/accounts/:id","host":["https://api.valr.com"],"path":["v1","wallet","fiat",":currencyCode","accounts",":id"],"variable":[{"key":"currencyCode","value":"ZAR","description":"The currency code for the fiat currency. Supported: ZAR, ZMW."},{"key":"id","value":"a4368195-571b-499f-93ae-717c44f92b1b","description":"The UUID identifier of the linked bank account to delete."}]}},"status":"No Content","code":204,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 03 Mar 2023 14:44:05 GMT"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"Deny"},{"key":"Content-Security-Policy","value":"default-src 'none'"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"44e93d34-9fb6-4483-b1c9-30a8c731d65f"},{"name":"Banks for Currency","id":"77cf29a8-4573-4745-831a-58516ba1bcf4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get a list of banks supported for a given currency.
\n","urlObject":{"path":["v1","wallet","fiat",":currencyCode","banks"],"host":["https://api.valr.com"],"query":[],"variable":[{"description":{"content":"The currency code for the fiat currency. Supported: ZAR.
\n","type":"text/plain"},"type":"any","value":"ZAR","key":"currencyCode"}]}},"response":[{"id":"b33d3603-0b6b-48ba-aaa7-f1606b6044c4","name":"Banks for Currency","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/wallet/fiat/:currencyCode/banks","host":["https://api.valr.com"],"path":["v1","wallet","fiat",":currencyCode","banks"],"variable":[{"key":"currencyCode","value":"ZAR","description":"The currency code for the fiat currency. Supported: ZAR, ZMW."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 03 Mar 2023 14:44:30 GMT"},{"key":"Cache-Control","value":"max-age=600"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"Deny"},{"key":"Content-Security-Policy","value":"default-src 'none'"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"code\": \"ABSA\",\n \"displayName\": \"ABSA Bank\",\n \"defaultBranchCode\": \"632005\",\n \"rtcParticipant\": true,\n \"rtgsParticipant\": true,\n \"countryCode\": \"ZA\"\n },\n {\n \"code\": \"CAPITEC\",\n \"displayName\": \"Capitec Bank\",\n \"defaultBranchCode\": \"470010\",\n \"rtcParticipant\": true,\n \"rtgsParticipant\": true,\n \"countryCode\": \"ZA\"\n },\n {\n \"code\": \"FNB\",\n \"displayName\": \"FNB/RMB\",\n \"defaultBranchCode\": \"250655\",\n \"rtcParticipant\": true,\n \"rtgsParticipant\": true,\n \"countryCode\": \"ZA\"\n },\n {\n \"code\": \"NEDBANK\",\n \"displayName\": \"Nedbank\",\n \"defaultBranchCode\": \"198765\",\n \"rtcParticipant\": true,\n \"rtgsParticipant\": true,\n \"countryCode\": \"ZA\"\n },\n {\n \"code\": \"STANDARD\",\n \"displayName\": \"Standard Bank\",\n \"defaultBranchCode\": \"051001\",\n \"rtcParticipant\": true,\n \"rtgsParticipant\": true,\n \"countryCode\": \"ZA\"\n }\n]"}],"_postman_id":"77cf29a8-4573-4745-831a-58516ba1bcf4"},{"name":"Deposit Reference","id":"619d83fa-f562-4ed3-a573-81afbafd2f1c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get the unique Deposit Reference for the primary account or subaccount whose API Key is authorised.
\nPayments made with this reference will be credited to your account.
\n","urlObject":{"path":["v1","wallet","fiat",":currencyCode","deposit","reference"],"host":["https://api.valr.com"],"query":[],"variable":[{"description":{"content":"The currency code for the fiat currency. Supported: ZAR, USD.
\n","type":"text/plain"},"type":"any","value":"ZAR","key":"currencyCode"}]}},"response":[{"id":"4f4dc752-7376-4a23-bd50-30c989fc131e","name":"Deposit Reference","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature.","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate request signature","type":"text"}],"url":{"raw":"https://api.valr.com/v1/wallet/fiat/:currencyCode/deposit/reference","protocol":"https","host":["api","valr","com"],"path":["v1","wallet","fiat",":currencyCode","deposit","reference"],"variable":[{"key":"currencyCode","value":"ZAR","description":"Fiat currency code. Supported: ZAR"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 20 Apr 2019 14:48:39 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"Deny"},{"key":"Content-Security-Policy","value":"default-src 'none'"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"},{"key":"Strict-Transport-Security","value":"max-age=0; includeSubDomains; preload"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"4ca7eb9bdb9dac5a-JNB"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"reference\": \"VR8AFU9DD6\"\n}"}],"_postman_id":"619d83fa-f562-4ed3-a573-81afbafd2f1c"},{"name":"Auto-Buy Deposit Reference","id":"d085a371-339a-49e1-8c4f-a20cf582217e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get the unique auto-buy Deposit Reference for the primary account or subaccount whose API Key is authorised.
\nPayments in the currencyCode currency made with this reference will be used to buy buyCurrencySymbol currency.
Use the Supported Auto-Buy Currencies request for the list of currencies supported for auto-buy with the pay currency.
The currency code for the fiat currency. Supported: ZAR, USD.
\n","type":"text/plain"},"type":"any","value":"ZAR","key":"currencyCode"},{"description":{"content":"The currency code to buy. See Supported Auto-Buy Currencies.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get a list of currencies supported for auto-buying with the currencyCode currency.
The currency code for the fiat currency. Supported: ZAR, USD.
\n","type":"text/plain"},"type":"any","value":"ZAR","key":"currencyCode"}]}},"response":[{"id":"ccfd2b68-522a-413d-885a-e680fd68f963","name":"Supported Auto-Buy Currencies","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/wallet/fiat/:currencyCode/auto-buy","host":["https://api.valr.com"],"path":["v1","wallet","fiat",":currencyCode","auto-buy"],"variable":[{"key":"currencyCode","value":"ZAR","description":"The currency code for the fiat currency. Supported: ZAR, ZMW."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 03 Mar 2023 14:45:18 GMT"},{"key":"Cache-Control","value":"max-age=60"},{"key":"Cache-Control","value":"public"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"Deny"},{"key":"Content-Security-Policy","value":"default-src 'none'"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n \"BTC\",\n \"ETH\",\n \"XRP\"\n]"}],"_postman_id":"d1894fc7-23da-49fc-a8bd-1ba48ce54a82"},{"name":"New Withdrawal","id":"fb4db187-530b-4632-b933-7bdfd192bcf5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Withdraw your ZAR funds into one of your linked bank accounts.
\nThe request body accepts an optional field called \"fast\". If the value of this field is \"true\" the withdrawal will be processed with real-time clearing (\"RTC\") (participating banks only) or real-time gross settlement (\"RTGS\") during our next withdrawal run.
\nThe first 30 normal withdrawals per month are free, but higher fees apply to fast withdrawals. Learn more
\nBorrowing:
Use the allowBorrow option to borrow funds against assets in your account. Collateral is locked while the loan is outstanding. Interest accrues hourly and is capitalised into the loan. You can repay the loan whenever you prefer. Crypto Loans are only available in margin-enabled Subaccounts.
The currency code for the fiat currency. Supported: ZAR.
\n","type":"text/plain"},"type":"any","value":"ZAR","key":"currencyCode"}]}},"response":[{"id":"649bb03d-db1d-4a94-b7cf-fbfe103c58c3","name":"New Withdrawal Accepted","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n\t\"linkedBankAccountId\": \"1f5aefb3-3ed0-4e79-99cc-efbee7dddbdf\",\n\t\"amount\": \"500\",\n\t\"fast\": true,\n \"allowBorrow\": false\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/wallet/fiat/:currencyCode/withdraw","host":["https://api.valr.com"],"path":["v1","wallet","fiat",":currencyCode","withdraw"],"variable":[{"key":"currencyCode","value":"ZAR","description":"The currency code for the fiat currency. Supported: ZAR."}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 20 May 2025 10:06:06 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"409"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"e5bc0b2f-8fa2-4c3d-baa9-9548666cfedd\"\n}"},{"id":"fbe98f82-9dc1-4a1a-8e34-7b4f6458c205","name":"Allow borrow margin not enabled for account Unsuccessful","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n\t\"linkedBankAccountId\": \"d6408e34-adcb-484d-a060-795abd1b2bf2\",\n\t\"amount\": \"500\",\n\t\"fast\": true,\n \"allowBorrow\": true\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/wallet/fiat/:currencyCode/withdraw","host":["https://api.valr.com"],"path":["v1","wallet","fiat",":currencyCode","withdraw"],"variable":[{"key":"currencyCode","value":"ZAR","description":"The currency code for the fiat currency. Supported: ZAR."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 20 May 2025 13:22:17 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"155"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -19213,\n \"message\": \"Margin not enabled for account available=0|amount=500|fee=25\"\n}"}],"_postman_id":"fb4db187-530b-4632-b933-7bdfd192bcf5"}],"id":"0f46df3b-fb89-4b22-b5f4-d3f3ca6f1e70","description":"This section describes how to use the fiat Wallet APIs.
\n","event":[{"listen":"prerequest","script":{"id":"02349666-de2e-4a34-a7ef-58d399c89dd4","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"f14c9ab4-935f-4a3f-a2cb-d2c0f8e5b9a5","type":"text/javascript","exec":[""]}}],"_postman_id":"0f46df3b-fb89-4b22-b5f4-d3f3ca6f1e70"}],"id":"dd0c482d-4449-4390-b9c2-aab4d6293592","description":"Access your wallets programmatically.
\nThese APIs are protected and will require authentication. See the section on Authentication above to learn how to authenticate your API calls.
Your API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate request signature
\n","key":"X-VALR-TIMESTAMP","type":"text","value":"{{requestTimestamp}}"}],"url":"https://api.valr.com/v1/marketdata/:currencyPair/orderbook","description":"Returns a list of the top 40 bids and asks in the order book. Ask orders are sorted by price ascending. Bid orders are sorted by price descending. Orders of the same price are aggregated.
\n","urlObject":{"path":["v1","marketdata",":currencyPair","orderbook"],"host":["https://api.valr.com"],"query":[],"variable":[{"description":{"content":"The currency pair for which you would like to query the order book.
\n","type":"text/plain"},"type":"any","value":"BTCUSDC","key":"currencyPair"}]}},"response":[{"id":"13ea8e91-2f19-4915-bbae-81330d04395c","name":"Order Book","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate request signature"}],"url":{"raw":"https://api.valr.com/v1/marketdata/:currencyPair/orderbook","host":["https://api.valr.com"],"path":["v1","marketdata",":currencyPair","orderbook"],"variable":[{"key":"currencyPair","value":"BTCUSDC","description":"The currency pair for which you would like to query the order book."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"cache-control","value":"max-age=1"},{"key":"x-valr-upstream-service-time","value":"11"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Wed, 06 Aug 2025 09:44:51 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"Asks\": [\n {\n \"side\": \"sell\",\n \"quantity\": \"0.998418\",\n \"price\": \"118000\",\n \"currencyPair\": \"BTCUSDC\",\n \"orderCount\": 1\n }\n ],\n \"Bids\": [\n {\n \"side\": \"buy\",\n \"quantity\": \"0.0001\",\n \"price\": \"117820\",\n \"currencyPair\": \"BTCUSDC\",\n \"orderCount\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.0000143\",\n \"price\": \"117819\",\n \"currencyPair\": \"BTCUSDC\",\n \"orderCount\": 2\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.00002\",\n \"price\": \"117818\",\n \"currencyPair\": \"BTCUSDC\",\n \"orderCount\": 2\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.00002\",\n \"price\": \"117817\",\n \"currencyPair\": \"BTCUSDC\",\n \"orderCount\": 2\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.00002\",\n \"price\": \"117816\",\n \"currencyPair\": \"BTCUSDC\",\n \"orderCount\": 2\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.00002\",\n \"price\": \"117815\",\n \"currencyPair\": \"BTCUSDC\",\n \"orderCount\": 2\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.00003\",\n \"price\": \"117814\",\n \"currencyPair\": \"BTCUSDC\",\n \"orderCount\": 3\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.00001\",\n \"price\": \"117813\",\n \"currencyPair\": \"BTCUSDC\",\n \"orderCount\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.00001\",\n \"price\": \"117810\",\n \"currencyPair\": \"BTCUSDC\",\n \"orderCount\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.99924\",\n \"price\": \"117700\",\n \"currencyPair\": \"BTCUSDC\",\n \"orderCount\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.28698179\",\n \"price\": \"2000\",\n \"currencyPair\": \"BTCUSDC\",\n \"orderCount\": 18\n }\n ],\n \"LastChange\": \"2025-08-05T08:51:11.470Z\",\n \"SequenceNumber\": 2907775\n}"}],"_postman_id":"926f9245-35d1-4bca-a114-0af07bc229f7"},{"name":"Order Book (Non aggregated)","id":"c2acf6b9-dbba-4e6a-9075-a7907360812d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"Your API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate request signature
\n","key":"X-VALR-TIMESTAMP","type":"text","value":"{{requestTimestamp}}"}],"url":"https://api.valr.com/v1/marketdata/:currencyPair/orderbook/full","description":"Returns a list of all the bids and asks in the order book. Ask orders are sorted by price ascending. Bid orders are sorted by price descending. Orders of the same price are NOT aggregated. The LastChange field indicates the timestamp of the last update to the order book.
The currency pair for which you would like to query the order book.
\n","type":"text/plain"},"type":"any","value":"BTCUSDC","key":"currencyPair"}]}},"response":[{"id":"9df2d147-bab0-4614-9ff6-0e8d662087f6","name":"Order Book (Non aggregated)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate request signature"}],"url":{"raw":"https://api.valr.com/v1/marketdata/:currencyPair/orderbook/full","host":["https://api.valr.com"],"path":["v1","marketdata",":currencyPair","orderbook","full"],"variable":[{"key":"currencyPair","value":"BTCUSDC","description":"The currency pair for which you would like to query the order book."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"cache-control","value":"max-age=1"},{"key":"x-valr-upstream-service-time","value":"8"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Wed, 06 Aug 2025 09:46:41 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"Asks\": [\n {\n \"side\": \"sell\",\n \"quantity\": \"0.998418\",\n \"price\": \"118000\",\n \"currencyPair\": \"BTCUSDC\",\n \"id\": \"0198187f-528b-7856-a6e0-8349fbc5f607\",\n \"positionAtPrice\": 1\n }\n ],\n \"Bids\": [\n {\n \"side\": \"buy\",\n \"quantity\": \"0.0000043\",\n \"price\": \"117819\",\n \"currencyPair\": \"BTCUSDC\",\n \"id\": \"01981a20-ea17-702f-b0ab-62b4b0526be2\",\n \"positionAtPrice\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.00001\",\n \"price\": \"117819\",\n \"currencyPair\": \"BTCUSDC\",\n \"id\": \"01981a20-ea7b-7dce-bc85-5d3c6f4fc7e6\",\n \"positionAtPrice\": 2\n }\n ],\n \"LastChange\": \"2025-08-05T08:51:11.470Z\",\n \"SequenceNumber\": 2907775\n}"}],"_postman_id":"c2acf6b9-dbba-4e6a-9075-a7907360812d"},{"name":"Trade History","id":"8e9429c0-f43b-4483-a2be-d03cd1bbb230","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get the last 100 recent trades for a given currency pair. You can limit the number of trades returned by specifying the limit parameter.
Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"10"}],"variable":[{"description":{"content":"Specify the currency pair for which you want to query the trade history.
\n","type":"text/plain"},"type":"any","value":"BTCUSDC","key":"currencyPair"}]}},"response":[{"id":"bf3ac3ea-4071-4c57-a8b8-b351cc02226e","name":"Trade History","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/marketdata/:currencyPair/tradehistory?skip=0&limit=10","host":["https://api.valr.com"],"path":["v1","marketdata",":currencyPair","tradehistory"],"query":[{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"10","description":"Limit the results to this number. (Default and Max 100)"}],"variable":[{"key":"currencyPair","value":"BTCUSDC","description":"Specify the currency pair for which you want to query the trade history."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"cache-control","value":"max-age=1"},{"key":"x-valr-upstream-service-time","value":"4"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Wed, 06 Aug 2025 09:51:22 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"price\": \"118000\",\n \"quantity\": \"0.00058147\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-08-04T12:38:10.282Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986639370,\n \"id\": \"01987516-e06a-756c-825d-82ada5ded56c\",\n \"quoteVolume\": \"68.61346\"\n },\n {\n \"price\": \"118000\",\n \"quantity\": \"0.00000847\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-31T12:04:27.246Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986639360,\n \"id\": \"0198605e-91ee-7219-9f45-bdced9b23219\",\n \"quoteVolume\": \"0.99946\"\n },\n {\n \"price\": \"117819\",\n \"quantity\": \"0.0000057\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-27T09:59:35.211Z\",\n \"takerSide\": \"sell\",\n \"sequenceId\": 1368928567986639203,\n \"id\": \"01984b52-d02b-7d03-95dd-5093feec1d03\",\n \"quoteVolume\": \"0.6715683\"\n },\n {\n \"price\": \"117820\",\n \"quantity\": \"0.00000215\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-27T09:59:35.211Z\",\n \"takerSide\": \"sell\",\n \"sequenceId\": 1368928567986639202,\n \"id\": \"01984b52-d02b-7ecf-9807-0228a0764ecf\",\n \"quoteVolume\": \"0.253313\"\n },\n {\n \"price\": \"118000\",\n \"quantity\": \"0.00001694\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-25T10:17:16.560Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986639191,\n \"id\": \"01984116-4a10-7f42-81d8-593826d8cf42\",\n \"quoteVolume\": \"1.99892\"\n },\n {\n \"price\": \"118000\",\n \"quantity\": \"0.00000847\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-25T10:16:16.471Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986639190,\n \"id\": \"01984115-5f57-7c72-9b1c-2a2defedbc72\",\n \"quoteVolume\": \"0.99946\"\n },\n {\n \"price\": \"118000\",\n \"quantity\": \"0.00000847\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-25T10:11:16.374Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986639189,\n \"id\": \"01984110-cb16-75a7-ab11-2dcf939315a7\",\n \"quoteVolume\": \"0.99946\"\n },\n {\n \"price\": \"118000\",\n \"quantity\": \"0.00000847\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-25T10:06:16.819Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986639188,\n \"id\": \"0198410c-38f3-76e9-8571-6baa82bab6e9\",\n \"quoteVolume\": \"0.99946\"\n },\n {\n \"price\": \"117820\",\n \"quantity\": \"0.00000785\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-25T09:59:16.743Z\",\n \"takerSide\": \"sell\",\n \"sequenceId\": 1368928567986639187,\n \"id\": \"01984105-d007-7bc1-a5ad-86466dbc0bc1\",\n \"quoteVolume\": \"0.924887\"\n },\n {\n \"price\": \"118000\",\n \"quantity\": \"0.00000847\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-24T11:37:11.776Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986639156,\n \"id\": \"01983c39-1960-7b37-a507-68e8327b6b37\",\n \"quoteVolume\": \"0.99946\"\n }\n]"}],"_postman_id":"8e9429c0-f43b-4483-a2be-d03cd1bbb230"},{"name":"Trade History (With Filters)","id":"3063f94e-bc91-4ae5-a956-aebc2b0bee37","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","type":"text","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","type":"text","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","type":"text","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get the trade history for a given currency pair.\nThe results of this request may be filtered by datetime. The skip and limit parameters may be applied to paginate the filtered results.
startTime or endTimeThe startTime or endTime parameters may be used to filter the returned items by the trade date. The parameters will be interpreted as being in the UTC time zone and must be supplied in the ISO 8601 format (2020-02-29T22:00:00.000Z). These two parameters may be used together or separately. When startTime is used, trades that have occurred since startTime are returned. When endTime is used, trades that have occurred up to and including endTime are returned.
NOTE\nThe startTime and endTime parameters are optional filters. However, omitting these parameters may result in slower response times. To mitigate this, a default time window such as the most recent 30 days may be automatically applied to the request.
Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"disabled":true,"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"10"},{"description":{"content":"Include only trades after this ISO 8601 start time.
\n","type":"text/plain"},"key":"startTime","value":"2020-11-30T08:51:21.604113Z"},{"description":{"content":"Include only transactions before this ISO 8601 end time.
\n","type":"text/plain"},"key":"endTime","value":"2020-11-30T08:55:29.339000Z"}],"variable":[{"description":{"content":"Specify the currency pair for which you want to query the trade history.
\n","type":"text/plain"},"type":"any","value":"BTCUSDC","key":"currencyPair"}]}},"response":[{"id":"662707d0-f8e8-46f4-a802-ada219a8b686","name":"Trade History (With Filters)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/marketdata/:currencyPair/tradehistory?startTime=2025-07-01T08:51:21.604113Z&endTime=2025-07-01T10:55:29.339000Z","host":["https://api.valr.com"],"path":["v1","marketdata",":currencyPair","tradehistory"],"query":[{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)","disabled":true},{"key":"limit","value":"10","description":"Limit the results to this number. (Default and Max 100)","disabled":true},{"key":"startTime","value":"2025-07-01T08:51:21.604113Z","description":"Include only trades after this ISO 8601 start time."},{"key":"endTime","value":"2025-07-01T10:55:29.339000Z","description":"Include only transactions before this ISO 8601 end time."}],"variable":[{"key":"currencyPair","value":"BTCUSDC","description":"Specify the currency pair for which you want to query the trade history."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"cache-control","value":"max-age=1"},{"key":"x-valr-upstream-service-time","value":"7"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Wed, 06 Aug 2025 09:55:43 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"price\": \"104465\",\n \"quantity\": \"0.1\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-01T09:53:00.345Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986637010,\n \"id\": \"0197c567-71b9-7ef8-970a-7fc6d5f5bef8\",\n \"quoteVolume\": \"10446.5\"\n }\n]"}],"_postman_id":"3063f94e-bc91-4ae5-a956-aebc2b0bee37"},{"name":"Trade History (Paginated by ID)","id":"88a15718-5f1c-4cb5-86dc-300c70d60edb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","type":"text","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","type":"text","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","type":"text","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get the trade history for a given currency pair.\nTrade history may be paginated by supplying a trade ID in the beforeId parameter. Only trades which occurred before the given ID will be included in the result. This allows backwards traversal of trade history by increments of limit.
To apply this method of pagination, use the last trade ID from the previous result set as the beforeId parameter of the next request.
limit and other filters can be applied with beforeId.
Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"5"},{"description":{"content":"Only include trades before this ID.
\n","type":"text/plain"},"key":"beforeId","value":"35f07b86-d788-43e2-96f0-9e5a7b9b56d0"}],"variable":[{"description":{"content":"Specify the currency pair for which you want to query the trade history.
\n","type":"text/plain"},"type":"any","value":"BTCUSDC","key":"currencyPair"}]}},"response":[{"id":"5953ad04-128b-4add-b1c2-59120b44bd47","name":"Trade History (Paginated by ID)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/marketdata/:currencyPair/tradehistory?limit=5&beforeId=0198410c-38f3-76e9-8571-6baa82bab6e9","host":["https://api.valr.com"],"path":["v1","marketdata",":currencyPair","tradehistory"],"query":[{"key":"limit","value":"5","description":"Limit the results to this number. (Default and Max 100)"},{"key":"beforeId","value":"0198410c-38f3-76e9-8571-6baa82bab6e9","description":"Only include trades before this ID."}],"variable":[{"key":"currencyPair","value":"BTCUSDC","description":"Specify the currency pair for which you want to query the trade history."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"cache-control","value":"max-age=1"},{"key":"x-valr-upstream-service-time","value":"23"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Wed, 06 Aug 2025 09:58:05 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"price\": \"117820\",\n \"quantity\": \"0.00000785\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-25T09:59:16.743Z\",\n \"takerSide\": \"sell\",\n \"sequenceId\": 1368928567986639187,\n \"id\": \"01984105-d007-7bc1-a5ad-86466dbc0bc1\",\n \"quoteVolume\": \"0.924887\"\n },\n {\n \"price\": \"118000\",\n \"quantity\": \"0.00000847\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-24T11:37:11.776Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986639156,\n \"id\": \"01983c39-1960-7b37-a507-68e8327b6b37\",\n \"quoteVolume\": \"0.99946\"\n },\n {\n \"price\": \"118000\",\n \"quantity\": \"0.00000847\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-24T11:35:45.163Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986639155,\n \"id\": \"01983c37-c70b-7b03-a2a3-617206487b03\",\n \"quoteVolume\": \"0.99946\"\n },\n {\n \"price\": \"118000\",\n \"quantity\": \"0.00003194\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-23T13:41:22.681Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986639130,\n \"id\": \"01983784-6e79-7ed7-acbf-4a78fcb97ed7\",\n \"quoteVolume\": \"3.76892\"\n },\n {\n \"price\": \"118000\",\n \"quantity\": \"0.00000847\",\n \"currencyPair\": \"BTCUSDC\",\n \"tradedAt\": \"2025-07-23T10:57:41.446Z\",\n \"takerSide\": \"buy\",\n \"sequenceId\": 1368928567986639126,\n \"id\": \"019836ee-9246-7166-a3fa-108a05032166\",\n \"quoteVolume\": \"0.99946\"\n }\n]"}],"_postman_id":"88a15718-5f1c-4cb5-86dc-300c70d60edb"}],"id":"bf6f17de-8513-4b5b-9802-c3a5c92f8839","description":"These API calls can be used to receive the market data.
\nThese APIs are protected and will require authentication. See the section on Authentication above to learn how to authenticate your API calls.
Your API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get a quote to buy or sell instantly using Simple Buy.
\nA sample request body is as follows:
\n{\n \"payInCurrency\": \"BTC\",\n \"payAmount\": \"0.001\",\n \"side\": \"SELL\"\n}\n\nExample usage of payInCurrency and side for the BTCUSDC currency pair:
If you want to sell BTC for USDC, payInCurrency will be BTC and the side would be SELL
If you want to buy BTC with USDC, payInCurrency will be USDC and the side would be BUY
Example usage of payInCurrency and side for the ETHBTC currency pair:
If you want to sell ETH for BTC, payInCurrency will be ETH and the side would be SELL
If you want to buy ETH with BTC, payInCurrency will be BTC and the side would be BUY
The currency pair to get a simple quote for. Any currency pair that supports the \"simple\" order type, can be specified.
\n","type":"text/plain"},"type":"any","value":"BTCUSDC","key":"currencyPair"}]}},"response":[{"id":"c98e0bb4-f049-46fc-a6c5-9a74560bbd4e","name":"Unable to fulfill","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"payInCurrency\": \"BTC\",\n \"payAmount\": \"1\",\n \"side\": \"SELL\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/simple/:currencyPair/quote","host":["https://api.valr.com"],"path":["v1","simple",":currencyPair","quote"],"variable":[{"key":"currencyPair","value":"BTCUSDC","description":"The currency pair to get a simple quote for. Any currency pair that supports the \"simple\" order type, can be specified."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"5"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Fri, 08 Aug 2025 08:27:31 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -39,\n \"message\": \"Please decrease your amount. The maximum is 0.78546762 BTC\"\n}"},{"id":"f7ecf635-35d4-4446-aba4-308037c07c06","name":"Simple Buy/Sell Quote","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"payInCurrency\": \"BTC\",\n \"payAmount\": \"0.78546761\",\n \"side\": \"SELL\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/simple/:currencyPair/quote","host":["https://api.valr.com"],"path":["v1","simple",":currencyPair","quote"],"variable":[{"key":"currencyPair","value":"BTCUSDC","description":"The currency pair to get a simple quote for. Any currency pair that supports the \"simple\" order type, can be specified."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"21"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Fri, 08 Aug 2025 08:23:39 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"currencyPair\": \"BTCUSDC\",\n \"payAmount\": \"0.78546761\",\n \"receiveAmount\": \"90970.3614988\",\n \"fee\": \"1479.19286989\",\n \"feeCurrency\": \"USDC\",\n \"createdAt\": \"2025-08-08T08:23:39.782984109\",\n \"id\": \"019888c7-4e07-7bbc-9319-f925f931828f\",\n \"ordersToMatch\": [\n {\n \"price\": \"117819\",\n \"quantity\": \"0.0000043\"\n },\n {\n \"price\": \"117819\",\n \"quantity\": \"0.00001\"\n },\n {\n \"price\": \"117818\",\n \"quantity\": \"0.00001\"\n },\n {\n \"price\": \"117818\",\n \"quantity\": \"0.00001\"\n },\n {\n \"price\": \"117817\",\n \"quantity\": \"0.00001\"\n },\n {\n \"price\": \"117817\",\n \"quantity\": \"0.00001\"\n },\n {\n \"price\": \"117816\",\n \"quantity\": \"0.00001\"\n },\n {\n \"price\": \"117816\",\n \"quantity\": \"0.00001\"\n },\n {\n \"price\": \"117815\",\n \"quantity\": \"0.00001\"\n },\n {\n \"price\": \"117815\",\n \"quantity\": \"0.00001\"\n },\n {\n \"price\": \"117814\",\n \"quantity\": \"0.00001\"\n },\n {\n \"price\": \"117814\",\n \"quantity\": \"0.00001\"\n },\n {\n \"price\": \"117814\",\n \"quantity\": \"0.00001\"\n },\n {\n \"price\": \"117813\",\n \"quantity\": \"0.00001\"\n },\n {\n \"price\": \"117810\",\n \"quantity\": \"0.00001\"\n },\n {\n \"price\": \"117700\",\n \"quantity\": \"0.78532331\"\n }\n ]\n}"}],"_postman_id":"8c1df98d-5878-44f0-9090-2211f793fd6f"},{"name":"Simple Buy/Sell Order","id":"b064c7f3-d789-47ea-a427-e86a8039fdda","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Submit an order to buy or sell instantly using Simple Buy/Sell.
\nA sample request body is as follows:
\n{\n \"payInCurrency\": \"BTC\",\n \"payAmount\": \"0.001\",\n \"side\": \"SELL\"\n}\n\nExample usage of payInCurrency and side for the BTCUSDC currency pair:
If you want to sell BTC for USDC, payInCurrency will be BTC and the side would be SELL
If you want to buy BTC with USDC, payInCurrency will be USDC and the side would be BUY
Example usage of payInCurrency and side for the ETHBTC currency pair:
payInCurrency will be ETH and the side would be SELLpayInCurrency will be BTC and the side would be BUYThe currency pair to place a simple order for. Any currency pair that supports the \"simple\" order type, can be specified.
\n","type":"text/plain"},"type":"any","value":"BTCUSDC","key":"currencyPair"}]}},"response":[{"id":"b63bf742-3ddb-4021-b74a-9cbc0706d7a0","name":"Currency Pair does not support order type","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"payInCurrency\": \"USDT\",\n \"payAmount\": \"10\",\n \"side\": \"BUY\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/simple/:currencyPair/order","host":["https://api.valr.com"],"path":["v1","simple",":currencyPair","order"],"variable":[{"key":"currencyPair","value":"AVAXUSDTPERP","description":"The currency pair to place a simple order for. Any currency pair that supports the \"simple\" order type, can be specified."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"13"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Wed, 16 Jul 2025 13:37:44 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -12005,\n \"message\": \"Selected order type is not allowed for the currency pair.\"\n}"},{"id":"d684c2a1-8613-4bc3-91c4-8ea98aff9550","name":"Pair is not active","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"payInCurrency\": \"BTC\",\n \"payAmount\": \"0.0001\",\n \"side\": \"BUY\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/simple/:currencyPair/order","host":["https://api.valr.com"],"path":["v1","simple",":currencyPair","order"],"variable":[{"key":"currencyPair","value":"ADABTC","description":"The currency pair to place a simple order for. Any currency pair that supports the \"simple\" order type, can be specified."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"4"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Fri, 08 Aug 2025 08:43:07 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -32,\n \"message\": \"The given currency pair is not active\"\n}"},{"id":"649c2fd5-99f3-4844-bae0-6b8b959f556a","name":"Amount too low","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"payInCurrency\": \"BTC\",\n \"payAmount\": \"0.0001\",\n \"side\": \"SELL\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/simple/:currencyPair/order","host":["https://api.valr.com"],"path":["v1","simple",":currencyPair","order"],"variable":[{"key":"currencyPair","value":"ADABTC","description":"The currency pair to place a simple order for. Any currency pair that supports the \"simple\" order type, can be specified."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"4"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Fri, 08 Aug 2025 08:43:07 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -38,\n \"message\": \"Please increase your amount. The minimum is 0.0008 BTC\"\n}"},{"id":"db255c42-f61b-4676-b492-0e4bf0edd132","name":"Simple Buy Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate request signature"}],"body":{"mode":"raw","raw":"{\n \"payInCurrency\": \"BTC\",\n \"payAmount\": \"0.0008\",\n \"side\": \"BUY\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/simple/:currencyPair/order","protocol":"https","host":["api","valr","com"],"path":["v1","simple",":currencyPair","order"],"variable":[{"key":"currencyPair","value":"ADABTC","description":"The currency pair to place a simple order for. Any currency pair that supports the \"simple\" order type, can be specified."}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 20 Apr 2019 13:57:54 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"Deny"},{"key":"Content-Security-Policy","value":"default-src 'none'"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"},{"key":"Strict-Transport-Security","value":"max-age=0; includeSubDomains; preload"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"4ca7a1475a79ac30-JNB"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"9fed72b4-5d59-4bd7-b4fc-26cf43d27c94\"\n}"}],"_postman_id":"b064c7f3-d789-47ea-a427-e86a8039fdda"},{"name":"Simple Buy/Sell Order Status","id":"c001557e-0356-4b5f-92cf-64d3b2fe98ed","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get the status of a Simple Buy/Sell order.
\n","urlObject":{"path":["v1","simple",":currencyPair","order",":orderId"],"host":["https://api.valr.com"],"query":[],"variable":[{"description":{"content":"(Optional) The currency pair to place a simple order for. Any currency pair that supports the \"simple\" order type, can be specified.
\n","type":"text/plain"},"type":"any","value":"ADABTC","key":"currencyPair"},{"description":{"content":"Order Id of the order for which you are querying the status.
\n","type":"text/plain"},"type":"any","value":"9fed72b4-5d59-4bd7-b4fc-26cf43d27c94","key":"orderId"}]}},"response":[{"id":"557820bf-79a7-4410-a21d-832e95c9649d","name":"Simple Buy Order Status","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate request signature"}],"url":{"raw":"https://api.valr.com/v1/simple/:currencyPair/order/:orderId","protocol":"https","host":["api","valr","com"],"path":["v1","simple",":currencyPair","order",":orderId"],"variable":[{"key":"currencyPair","value":"ADABTC","description":"(Optional) The currency pair to place a simple order for. Any currency pair that supports the \"simple\" order type, can be specified."},{"key":"orderId","value":"9fed72b4-5d59-4bd7-b4fc-26cf43d27c94","description":"Order Id of the order for which you are querying the status."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 20 Apr 2019 14:00:46 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"Deny"},{"key":"Content-Security-Policy","value":"default-src 'none'"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"},{"key":"Strict-Transport-Security","value":"max-age=0; includeSubDomains; preload"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"4ca7a576991cac30-JNB"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"9fed72b4-5d59-4bd7-b4fc-26cf43d27c94\",\n \"success\": true,\n \"processing\": false,\n \"paidAmount\": \"0.0008\",\n \"paidCurrency\": \"BTC\",\n \"receivedAmount\": \"54.49553877\",\n \"receivedCurrency\": \"ADA\",\n \"feeAmount\": \"0.000006\",\n \"feeCurrency\": \"BTC\",\n \"orderExecutedAt\": \"2019-04-20T13:57:56.618\"\n}"}],"_postman_id":"c001557e-0356-4b5f-92cf-64d3b2fe98ed"}],"id":"e5f1a41c-e5a0-4560-9726-8b736752f6be","description":"Make use of our Simple Buy/Sell API to instantly buy and sell currencies.
\nThese APIs are protected and will require authentication. See the section on Authentication above to learn how to authenticate your API calls.
Your API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Initiate an instant payment using VALR Pay by specifying the recipient email, recipient cellphone number or their account payment reference (VALR PayID)
\nA sample request body is as follows:
\n{\n \"amount\": 15.00,\n \"recipientEmail\": \"test@gmail.com\",\n //\"recipientCellNumber\": \"+27724761002\", \n // \"recipientPayId\": \"AUCSAB4GC5DZJJ7UJ345\",\n \"currency\": \"ZAR\",\n \"recipientNote\": \"Thanks for a great service\",\n \"senderNote\": \"Tip\",\n \"anonymous\": \"false\"\n}\n\nPayment limit.202 - Accepted with an identifier and transactionId in the body.Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Reverse an instant payment using VALR Pay by specifying the payment transaction id. An anonymous payment will be made back to the original sender's VALR Pay ID with the exact amount and identical currency.
\nOnly a recipient of a payment can perform the reversal.
\n202 - Accepted with an identifier and transactionId in the body.Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Partially reverse an instant payment using VALR Pay by specifying the payment transaction id. An anonymous payment will be made back to the original sender's VALR Pay ID with the exact amount and identical currency.
\nOnly a recipient of a payment can perform the partial reversal.
\n202 - Accepted with an identifier and transactionId in the body.A sample request body is as follows:
\n{\n \"amountToReverse\": \"1.00\"\n}\n\nYour API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Retrieves all the payment limits applicable to your account. This will include minimum payment amount, maximum payment amount, payment currency and limit type (currently per transaction)
\n","urlObject":{"path":["v1","pay","limits"],"host":["https://api.valr.com"],"query":[{"description":{"content":"The currency shortname in which the limits should be denominated
\n","type":"text/plain"},"key":"currency","value":"BTC"}],"variable":[]}},"response":[{"id":"5481c4e8-eb0c-4629-bbc0-6cdb87ad8610","name":"Payment Limits","originalRequest":{"method":"GET","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature.","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds.","type":"text"}],"url":"https://api.valr.com/v1/pay/limits"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Thu, 09 Dec 2021 13:00:35 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"10"},{"key":"server","value":"envoy"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"maxPaymentAmount\": 50000.00,\n \"minPaymentAmount\": 5.0,\n \"paymentCurrency\": \"ZAR\",\n \"limitType\": \"per transaction\"\n}"}],"_postman_id":"a6fbee20-b283-4693-91f1-7a35e81deee8"},{"name":"Pay ID","id":"16783a18-d56c-48c3-a491-1db883df43b8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get your account's unique VALR PayID.
Payments made with this reference will be credited to your account.
\n","urlObject":{"path":["v1","pay","payid"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"d79b1f1e-0409-40c1-82e4-4f128891a3ff","name":"Pay ID","originalRequest":{"method":"GET","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature.","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds.","type":"text"}],"url":"https://api.valr.com/v1/pay/payid"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Thu, 09 Dec 2021 13:01:41 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"27"},{"key":"server","value":"envoy"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"payId\": \"8KDR68R4NA7HUD63CDCR\"\n}"}],"_postman_id":"16783a18-d56c-48c3-a491-1db883df43b8"},{"name":"Payment History","id":"04abb3b3-6c1e-49fd-b599-5e04fb8d204a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Fetches a list of all payments made from and made to the current users account.
\nPayments received (incoming) have type = CREDIT and Payments sent (outgoing) have type = DEBIT
The results of this request may be filtered by Status i.e.STATUS=COMPLETE,FAILED
Valid Status are INITIATED, AUTHORISED, COMPLETE, RETURNED, FAILED, EXPIRED
The skip and limit parameters may be applied to paginate the filtered results.
Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get the payment details by specifying the payment identifier
Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get the status and details of a payment transaction, by specifying a transactionId
Make use of our Pay API to instantly initiate new payments, get status, details and a history of your payments made and received using VALR Pay.
\nThese APIs are protected and will require authentication. See the section on Authentication above to learn how to authenticate your API calls.
Note: Your API key needs Withdrawal permissions in order to make or reverse payments.
\n","event":[{"listen":"prerequest","script":{"id":"ac2fa6f4-c4cd-4473-8cfa-e4cce10fc816","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"3b9a158d-3b42-45f3-ab9d-782e881413a2","type":"text/javascript","exec":[""]}}],"_postman_id":"f63d1a60-863b-4e6e-94ee-ab7151ed24de"},{"name":"Exchange Buy/Sell","item":[{"name":"Limit Order V1","id":"5beb7328-24ca-4d8a-84f2-6029725ad923","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Create a new limit order.
\nThe JSON body used to create a limit order looks like this:
\n{\n \"side\": \"SELL\",\n \"quantity\": \"0.100000\",\n \"price\": \"64250\",\n \"pair\": \"BTCUSDC\",\n \"postOnly\": true,\n \"customerOrderId\": \"1234\",\n \"timeInForce\": \"GTC\",\n \"allowMargin\": \"false\",\n \"reduceOnly\": \"false\"\n}\n\nNotes
\nThe customerOrderId is an optional field which can be specified by clients to track this order using their own internal order management systems. It supports alphanumeric characters and dashes (\"-\"), with a 50-character limit. Special characters are not allowed. The customerOrderId must be unique across all open orders for a given account. Reusing an id from an active order will prevent the new order from being placed (use the order status API to check an order’s status).
timeInForce:
Defines how long an order remains active:
GTC: Good Till Cancelled
FOK: Fill or Kill
IOC: Immediate or Cancel
allowMargin:
Set to true for margin/leverage trades. Only subaccounts can trade on margin, and each must be enabled individually via the account/status API.
reduceOnly:
Set to true for Perpetual Futures order(s) where the limit order should only ever reduce a position, never create or increase.
conditionalOrderData:
Conditional orders are used to add Take Profit and Stop Loss (TPSL) conditions to manage your futures Perpetual Futures order(s). These fields are used to define the conditions under which the TPSL will trigger, and how the order will be placed when triggered.
The key thing to note is that you do not need the linkedOrderId or pair because it refers to the limit order that you are placing.
More information can be found in the Conditional Orders Section.
\nOrder Retrieval:
When fetching open or historical orders, the customerOrderId (if specified during creation) and VALR's orderId will be returned.
Order Cancellation:
Use either orderId or customerOrderId to cancel an order—not both.
Fee currency
\nIf you are a Maker and you are Buying BTC with USDC, your reward will be paid in USDC
\nIf you are a Maker and you are Selling BTC for USDC, your reward will be paid in BTC
\nIf you are a Taker and you are Buying BTC with USDC, your fee will be charged in BTC
\nIf you are a Taker and you are Selling BTC for USDC, your fee will be charged in USDC
\nIn short, fees will be in the currency that the taker is receiving and the maker is paying in the trade. The following example uses the BTCUSDC trading pair:
PLEASE NOTE: When you receive a response with an id, it does not always mean that the order has been placed. When the response is 202 Accepted, you can use the Order Status REST API or use WebSocket API to receive the status of this order. The reasons why an order could fail are as follows:
Insufficient balance in your account.
\nIf you're using a non-unique customerOrderId.
If you set postOnly flag to true, but your order would have matched immediately.
Self trading: If your order matches against your own order (on the other side).
\nInsufficient liquidity: If you're placing an order and there isn't liquidity to fulfill the order.
\nYour API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Create a new limit order.
\nThe JSON body used to create a limit order looks like this:
\n{\n \"side\": \"SELL\",\n \"quantity\": \"0.100000\",\n \"price\": \"10000\",\n \"pair\": \"BTCUSDT\",\n \"postOnly\": true,\n \"customerOrderId\": \"1234\"\n \"timeInForce\": \"GTC\"\n}\n\nNotes
\nThe customerOrderId is an optional field which can be specified by clients to track this order using their own internal order management systems. It supports alphanumeric characters with a 50-character limit. Special characters are not allowed. The customerOrderId must be unique across all open orders for a given account. Reusing an id from an active order will prevent the new order from being placed (use the order status API to check an order’s status).
timeInForce:
Defines how long an order remains active:
GTC: Good Till Cancelled
FOK: Fill or Kill
IOC: Immediate or Cancel
allowMargin:
Set to true for margin/leverage trades. Only subaccounts can trade on margin, and each must be enabled individually via the account/status API.
reduceOnly:
Set to true for Perpetual Futures order(s) where the limit order should only ever reduce a position, never create or increase.
Order Retrieval:
When fetching open or historical orders, the customerOrderId (if specified during creation) and VALR's orderId will be returned.
Order Cancellation:
Use either orderId or customerOrderId to cancel an order—not both.
Fee currency
\nIf you are a Maker and you are Buying BTC with USDT, your reward will be paid in USDT
\nIf you are a Maker and you are Selling BTC for USDT, your reward will be paid in BTC
\nIf you are a Taker and you are Buying BTC with USDT, your fee will be charged in BTC
\nIf you are a Taker and you are Selling BTC for USDT, your fee will be charged in USDT
\nIn short, fees will be in the currency that the taker is receiving and the maker is paying in the trade. The following example uses the BTCUSDT trading pair:
PLEASE NOTE:
\nWhen you receive a 201 Created response with an id, it means that the order has been successfully placed. You can use the Order Status REST API or use WebSocket API to receive the status of this order.
When an order fails during the order placement process you can expect to receive an orderId, code and message in the response body. You can use the Order Status REST API or use WebSocket API to receive the status of this order.
{\n \"orderId\": \"d043a37d-40b0-49e5-b3fd-104c762585e7\",\n \"code\": -6,\n \"message\": \"Insufficient Balance\"\n}\n\nYour API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
This order type allows users to specify conditional orders that only place on the order book once a trigger price is reached.
\nOn spot, it can be used to construct a take profit, stop loss as well as ordinary conditional orders. It can also be used with margin.
\nOn futures, it can be added to an existing position or limit order only as a Take Profit and Stop Loss (TPSL).
\nNotes
\nQuantity Behavior:
\nquantity = 0: Closes the entire open position.quantity > 0: Places a reduce-only order for the specified amount. If the quantity exceeds the current position, the system will use the open position's quantity.quantity = -1: Useful when adding to the position. Only closes the quantity added by the new order.Price Behavior:
\ntakeProfitOrderPrice = -1 or stopLossOrderPrice = -1: Places a market order. A limit order at the min/max slippage price is used to simulate the behavior of a market order.OCO (One-Cancels-the-Other):
\ncustomerOrderId:
id from an active order results in the order being rejected. Use the order status API to check active orders.PLEASE NOTE: When you receive a response with an id, it does not always mean that the order has been placed. When the response is 202 Accepted, you can use the Order Status REST API or use WebSocket API to receive the status of this order. The reasons why an order could fail are as follows:
customerOrderId.Your API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Create a new market order.
\nWhen the response is 202 Accepted, you can either use the Order Status REST API or use WebSocket API to receive updates about this order.
Example request body:
\n{\n \"side\": \"SELL\",\n \"baseAmount\": \"0.100000\",\n \"pair\": \"BTCUSDT\",\n \"customerOrderId\": \"1234\",\n \"allowMargin\": \"false\",\n \"timeInForce\": \"FOK\"\n}\n\nNotes
\ntimeInForce:
IOC: Fills as much of the order as possible within the allowed slippage, then cancels the remainder.\nFOK: The entire order must fill within the allowed slippage or it is canceled completely.
customerOrderId:
Optional field for tracking orders using your internal system. It supports alphanumeric characters and dashes (\"-\"), with a 50-character limit. Special characters are not allowed. The customerOrderId must be unique across all open orders for a given account. Reusing an id from an active order will prevent the new order from being placed (use the order status API to check an order’s status).
allowMargin:
Set to true for margin/leverage trades. Only subaccounts can trade on margin, and each must be enabled individually via the account/status API.
reduceOnly:
Set to true for Perpetual Futures order(s) where the market order should only ever reduce a position, never create or increase.
conditionalOrderData:
Conditional orders are used to add Take Profit and Stop Loss (TPSL) conditions to manage your futures Perpetual Futures order(s). These fields are used to define the conditions under which the TPSL will trigger, and how the order will be placed when triggered.
The key thing to note is that you do not need the linkedOrderId or pair because it refers to the market order that you are placing.
More information can be found in the Conditional Orders Section.
\nFee currency
\nWhen you place a market order, you will be charged the \"Taker fee\" on the trade.
\nAs a Taker, if you are Buying BTC with ZAR, your fee will be charged in BTC
\nAs a Taker, if you are Selling BTC for ZAR, your fee will be charged in ZAR
\nPLEASE NOTE: When you receive a response with an id, it does not always mean that the order has been placed. When the response is 202 Accepted, you can use the Order Status REST API or use WebSocket API to receive the status of this order. The reasons why an order could fail are as follows:
Insufficient balance in your account.
\nIf you're using a non-unique customerOrderId.
If you set postOnly flag to true, but your order would have matched immediately.
Self trading: If your order matches against your own order (on the other side).
\nInsufficient liquidity: If you're placing an order and there isn't liquidity to fulfill the order.
\nYour API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Create a new market order.
\nWhen the response is 201 Created, you can either use the Order Status REST API or use WebSocket API to receive updates about this order.
Example request body:
\n{\n \"side\": \"SELL\",\n \"baseAmount\": \"0.100000\",\n \"pair\": \"BTCUSDT\",\n \"customerOrderId\": \"1234\",\n \"timeInForce\": \"FOK\"\n}\n\nNotes
\ntimeInForce: \nIOC: Fills as much of the order as possible within the allowed slippage, then cancels the remainder.\nFOK: The entire order must fill within the allowed slippage or it is canceled completely.
customerOrderId:
Optional field for tracking orders using your internal system. It supports alphanumeric characters with a 50-character limit. Special characters are not allowed. The customerOrderId must be unique across all open orders for a given account. Reusing an id from an active order will prevent the new order from being placed (use the order status API to check an order’s status).
allowMargin:
Set to true for margin/leverage trades. Only subaccounts can trade on margin, and each must be enabled individually via the account/status API.
reduceOnly:
Set to true for Perpetual Futures order(s) where the limit order should only ever reduce a position, never create or increase.
Fee currency
\nWhen you place a market order, you will be charged the \"Taker fee\" on the trade.
\nAs a Taker, if you are Buying BTC with ZAR, your fee will be charged in BTC
\nAs a Taker, if you are Selling BTC for ZAR, your fee will be charged in ZAR
\nPLEASE NOTE:
\nWhen you receive a 201 Created response with an id, it means that the order has been successfully placed. You can use the Order Status REST API or use WebSocket API to receive the status of this order.
When an order fails during the order placement process you can expect to receive an orderId, code and message in the response body. See example below. You can use the Order Status REST API or use WebSocket API to receive the status of this order.
{\n \"orderId\": \"d043a37d-40b0-49e5-b3fd-104c762585e7\",\n \"code\": -6,\n \"message\": \"Insufficient Balance\"\n}\n\nYour API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Stop Limit routes will be deprecated in a future release in favour of the Conditional Order routes.
\nCreate a new Stop Loss Limit or Take Profit Limit order.
\nWhen the response is 202 Accepted, you can either use the Order Status REST API or use WebSocket API to receive updates about this order.
Example request body:
\n{\n \"side\": \"BUY\",\n \"quantity\": \"0.00015\",\n \"price\": \"645055\",\n \"pair\": \"BTCUSDT\",\n \"customerOrderId\": \"56789\",\n \"timeInForce\": \"GTC\",\n \"stopPrice\": \"644021\",\n \"type\": \"STOP_LOSS_LIMIT\"\n}\n\nNotes
\ncustomerOrderId:
Optional field for tracking orders using your internal system. It supports alphanumeric characters and dashes (\"-\"), with a 50-character limit. Special characters are not allowed. The customerOrderId must be unique across all open orders for a given account. Reusing an id from an active order will prevent the new order from being placed (use the order status API to check an order’s status).
allowMargin:
Set to true for margin/leverage trades. Only subaccounts can trade on margin, and each must be enabled individually via the account/status API.
Order Retrieval:
When fetching open or historical orders, the customerOrderId (if specified during creation) and VALR's orderId will be returned.
Order Cancellation:
Use either orderId or customerOrderId to cancel an order—not both.
PLEASE NOTE: \n When you receive a response with an id, it does not always mean that the order has been placed. When the response is 202 Accepted, you can use the WebSocket API (or Order Status REST API) to receive the status of this order. The reasons why an order could fail are as follows:
customerOrderId.Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Stop Limit routes will be deprecated in a future release in favour of the Conditional Order routes.
\nCreate a new Stop Loss Limit or Take Profit Limit order.
\nWhen the response is 201 Created, you can either use the Order Status REST API or use WebSocket API to receive updates about this order.
Example request body:
\n{\n \"side\": \"BUY\",\n \"quantity\": \"0.00015\",\n \"price\": \"645055\",\n \"pair\": \"BTCUSDT\",\n \"customerOrderId\": \"56789\",\n \"timeInForce\": \"GTC\",\n \"stopPrice\": \"644021\",\n \"type\": \"STOP_LOSS_LIMIT\"\n}\n\nNotes
\ncustomerOrderId:
Optional field for tracking orders using your internal system. It supports alphanumeric characters and dashes (\"-\"), with a 50-character limit. Special characters are not allowed. The customerOrderId must be unique across all open orders for a given account. Reusing an id from an active order will prevent the new order from being placed (use the order status API to check an order’s status).
allowMargin:
Set to true for margin/leverage trades. Only subaccounts can trade on margin, and each must be enabled individually via the account/status API.
Order Retrieval:
When fetching open or historical orders, the customerOrderId (if specified during creation) and VALR's orderId will be returned.
Order Cancellation:
Use either orderId or customerOrderId to cancel an order—not both.
PLEASE NOTE:
\n201 Created response with an id, it means that the order has been successfully placed. You can use the Order Status REST API or use WebSocket API to receive the status of this order.orderId, code and message in the response body. See example below. You can use the Order Status REST API or use WebSocket API to receive the status of this order.{\n \"orderId\": \"d043a37d-40b0-49e5-b3fd-104c762585e7\",\n \"code\": -6,\n \"message\": \"Insufficient Balance\"\n}\n\nYour API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Create a batch of multiple create, cancel or modify orders in a single request. The data parameter supports the same fields as in the non batch order for the relevant request.
\nWhen the response is 200 - OK, this means that the Batch Order has been submitted. However, this does not mean that all the orders in the Batch have been executed.
In the response body will be the outcomes of each of the orders in the batch. Values are true with an orderId for accepted orders, or false with a failure message for failed orders.
Example request body:
\n{\n \"requests\": [\n {\n \"type\": \"PLACE_MARKET\",\n \"data\": {\n \"side\": \"SELL\",\n \"quoteAmount\": \"10\",\n \"pair\": \"BTCUSDT\",\n \"customerOrderId\": \"1234\"\n }\n },\n {\n \"type\": \"PLACE_LIMIT\",\n \"data\": {\n \"pair\": \"BTCUSDT\",\n \"side\": \"BUY\",\n \"quantity\": \"0.0002\",\n \"price\": \"100000\",\n \"timeInForce\": \"GTC\"\n }\n },\n {\n \"type\": \"PLACE_LIMIT\",\n \"data\": {\n \"pair\": \"ETHZAR\",\n \"side\": \"SELL\",\n \"quantity\": \"0.2\",\n \"price\": \"32000\",\n \"postOnly\":\"false\",\n \"timeInForce\": \"GTC\"\n }\n },\n {\n \"type\": \"PLACE_STOP_LIMIT\",\n \"data\": {\n \"pair\": \"BTCUSDT\",\n \"side\": \"BUY\",\n \"quantity\": \"0.0002\",\n \"price\": \"100000\",\n \"timeInForce\": \"GTC\",\n \"stopPrice\": \"110000\",\n \"type\": \"TAKE_PROFIT_LIMIT\"\n }\n },\n {\n \"type\": \"PLACE_STOP_LIMIT\",\n \"data\": {\n \"pair\": \"BTCUSDT\",\n \"side\": \"SELL\",\n \"quantity\": \"0.0003\",\n \"price\": \"1150000\",\n \"timeInForce\": \"GTC\",\n \"stopPrice\": \"110000\",\n \"type\": \"STOP_LOSS_LIMIT\"\n }\n },\n {\n \"type\": \"PLACE_STOP_LIMIT\",\n \"data\": {\n \"pair\": \"BTCUSDT\",\n \"side\": \"BUY\",\n \"quantity\": \"0.0000002\",\n \"price\": \"100000\",\n \"timeInForce\": \"GTC\",\n \"stopPrice\": \"110000\",\n \"type\": \"STOP_LOSS_LIMIT\"\n }\n },\n {\n \"type\": \"CANCEL_ORDER\",\n \"data\": {\n \"orderId\":\"e5886f2d-191b-4330-a221-c7b41b0bc553\",\n \"pair\": \"ETHZAR\"\n }\n }\n ]\n}\n\nNotes
\ncustomerOrderId:\n Optional field for tracking orders using your internal system. It supports alphanumeric characters and dashes (\"-\"), with a 50-character limit. Special characters are not allowed. The customerOrderId must be unique across all open orders for a given account. Reusing an id from an active order will prevent the new order from being placed (use the order status API to check an order’s status).
Order Types:
The customerOrderId is valid for PLACE_MARKET, PLACE_LIMIT, and PLACE_STOP_LIMIT within a batch.
Order Retrieval:
When retrieving All Open Orders or Order History, the customerOrderId (if specified during creation) and VALR's orderId will be returned.
Order Cancellation:
For CANCEL_ORDER, use either orderId or customerOrderId to cancel an order—not both.
PLEASE NOTE:
\nA maximum of 20 orders may be submitted in a single Batch Orders request.
Responses for the orders will be returned in the same sequence that they are submitted in the request.
\nWhen you receive a response with accepted: true and an orderId, it means that the order has been accepted and will be placed if possible, and filled if matched.
When the response is 200 - OK, you can use the WebSocket API (or Order Status REST API) to receive the up to date status each of the orders in the batch by orderId.
The reasons why an order could fail are as follows:
\nInsufficient balance in your account.
\nIf it would be triggered immediately for any applicable PLACE_STOP_LIMIT orders in the batch.
If you're using a non-unique customerOrderId.
Self trading: If your order matches against your own order (on the other side).
\nInsufficient liquidity: If you're placing an order and there isn't enough liquidity on the order book to fulfil the order.
\nMinimum order size is not met. In this case, the response will be accepted:false, with the failure reason.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Create a new Limit Order which will be repriced by 1 tick to the best bid or best ask (or by the \"postOnlyRepriceTicks\" value) if the specified price were to match. This ensures Limit Post Only Reprice orders are always placed, and execute as maker trades.
\nThe JSON body used to create a limit order looks like this:
\n{\n \"side\": \"BUY\",\n \"quantity\": \"0.0001\",\n \"price\": \"656596\",\n \"pair\": \"BTCUSDT\",\n \"postOnlyReprice\": true,\n \"postOnlyRepriceTicks\": \"1\",\n \"customerOrderId\": \"Reprice1\",\n \"timeInForce\": \"GTC\"\n}\n\nNotes
\npostOnlyReprice:
Must be true for the order to reprice if the order matches as it's placed.
postOnlyRepriceTicks:
The number of ticks away from the other side of the book if the order were to match. Default value is 1, Max is 50.
customerOrderId:
An optional field which can be specified by clients to track this order using their own internal order management systems. It supports alphanumeric characters and dashes (\"-\"), with a 50-character limit. Special characters are not allowed. The customerOrderId must be unique across all open orders for a given account. Reusing an id from an active order will prevent the new order from being placed (use the order status API to check an order’s status).
postOnly:
Setting postOnly=true will place a Maker order and cause it to fail if it is matched immediately.
timeInForce:
Specifies the duration that an order will remain active. Post only reprice orders have to use GTC.
Order Retrieval:
When you retrieve open orders or order history, the customerOrderId (if specified during creation) and VALR's orderId will both be returned.
Order Cancellation:
You can cancel an order by specifying either orderId or customerOrderId, but not both.
PLEASE NOTE: When you receive a response with an id,
it does not always mean that the order has been placed.
When the response is 202 Accepted, you can use the
Order Status REST API or use WebSocket API to receive the status
of this order. The reasons why an order could fail are as follows:
Insufficient balance in your account.
\nIf you're using a non-unique customerOrderId.
Self trading: If your order matches against your own order (on the other side).
\nInsufficient liquidity: If you're placing an order and there isn't liquidity to fulfil the order.
\nPlaces a TWAP order which splits a large order into smaller sub-orders executed at regular intervals over a set duration.
\nNote
\nprice:
Set to 0 for market orders. Otherwise suborders are submitted as limit orders with the specified price.
duration:
The duration is how long the TWAP order runs for, in seconds. The total quantity is spread across this time window. Minimum is 60 seconds (1 minute), maximum is 259200 seconds (72 hours). The duration input should be a multiple of cadence.
cadence:
The cadence is how often a sub-order is placed, in seconds. Accepted values are 10, 20, 30, or 60. For example, a duration of 3600 (1 hour) with a cadence of 30 will place 120 sub-orders, one every 30 seconds.
randomQuantity:
When false (default), every sub-order is the same size (total quantity divided evenly). When set to true, each sub-order size is randomly varied, making the execution pattern less predictable. The total quantity executed remains the same regardless of this setting.
allowMargin:
Set to true for margin/leverage trades. Only subaccounts can trade on margin, and each must be enabled individually via the account/status API.
triggerPrice:
The triggerPrice parameter specifies when the TWAP execution should start - only after Mark price of the pair reaching that value does the TWAP duration begin.
PLEASE NOTE: When you receive a response with an id, it does not always mean that the order has been placed. When the response is 202 Accepted, you can use the TWAP Order History REST API to verify the current state of the order. The reasons why a suborder could fail are as follows:
Insufficient balance in your account.
\nSelf trading: If your order matches against your own order (on the other side).
\nInsufficient liquidity: If you're placing an order and there isn't liquidity to fulfill the order.
\nYour API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
This API returns the status of an order that was placed on the Exchange queried using the id provided by VALR. VALR provides an id for every order that is placed on the Exchange. Use this id to populate the path variable orderId in this API to query the status of the order.
Note: If a customerOrderId was also specified while placing the order, that customerOrderId will be returned as part of the response.
The currency pair
\n","type":"text/plain"},"type":"any","value":"BTCUSDT","key":"currencyPair"},{"description":{"content":"The order ID provided by VALR.
\n","type":"text/plain"},"type":"any","value":"9dbeb334-f1d4-405e-860e-8588b842ccbe","key":"orderId"}]}},"response":[{"id":"a6f8bef9-1998-4061-9ecb-5cac4ee80456","name":"Failed Buy","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/:currencyPair/orderid/:orderId","host":["https://api.valr.com"],"path":["v1","orders",":currencyPair","orderid",":orderId"],"variable":[{"key":"currencyPair","value":"ETHBTC","description":"The currency pair"},{"key":"orderId","value":"0198177e-54b4-7847-b87a-7f5db0f677d8","description":"The order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"41"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 17 Jul 2025 08:27:05 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"0198177e-54b4-7847-b87a-7f5db0f677d8\",\n \"orderStatusType\": \"Failed\",\n \"currencyPair\": \"ETHBTC\",\n \"originalPrice\": \"0\",\n \"remainingQuantity\": \"0.000565\",\n \"originalQuantity\": \"0.000565\",\n \"orderSide\": \"buy\",\n \"orderType\": \"market\",\n \"failedReason\": \"We did not execute this order since it would have matched with your own order on the Exchange\",\n \"orderUpdatedAt\": \"2025-07-17T08:26:51.958Z\",\n \"orderCreatedAt\": \"2025-07-17T08:26:51.956Z\",\n \"customerOrderId\": \"1234\",\n \"timeInForce\": \"IOC\"\n}"},{"id":"29b6a22d-3f97-4a07-a9a8-998d4cfe312d","name":"Cancelled","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/:currencyPair/orderid/:orderId","host":["https://api.valr.com"],"path":["v1","orders",":currencyPair","orderid",":orderId"],"variable":[{"key":"currencyPair","value":"ETHBTC","description":"The currency pair"},{"key":"orderId","value":"01981786-c482-7bae-a3da-4a756ef9d12e","description":"The order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"8"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 17 Jul 2025 08:37:49 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"01981786-c482-7bae-a3da-4a756ef9d12e\",\n \"orderStatusType\": \"Cancelled\",\n \"currencyPair\": \"ETHBTC\",\n \"originalPrice\": \"0.0355\",\n \"remainingQuantity\": \"0.000565\",\n \"originalQuantity\": \"0.000565\",\n \"orderSide\": \"sell\",\n \"orderType\": \"post-only limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2025-07-17T08:37:44.419Z\",\n \"orderCreatedAt\": \"2025-07-17T08:36:04.866Z\",\n \"customerOrderId\": \"LimitSell\",\n \"timeInForce\": \"GTC\"\n}"},{"id":"c0f3b517-96e8-4543-8ef0-f14d05d58832","name":"Filled - Order Status (orderId)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/:currencyPair/orderid/:orderId","host":["https://api.valr.com"],"path":["v1","orders",":currencyPair","orderid",":orderId"],"variable":[{"key":"currencyPair","value":"ETHBTC","description":"The currency pair"},{"key":"orderId","value":"0198178f-a957-7684-b650-eb987183f8e5","description":"The order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"8"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 17 Jul 2025 08:53:08 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"0198178f-a957-7684-b650-eb987183f8e5\",\n \"orderStatusType\": \"Filled\",\n \"currencyPair\": \"ETHBTC\",\n \"originalPrice\": \"0.03\",\n \"remainingQuantity\": \"0\",\n \"originalQuantity\": \"0.033333\",\n \"orderSide\": \"sell\",\n \"orderType\": \"post-only limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2025-07-17T08:53:00.620Z\",\n \"orderCreatedAt\": \"2025-07-17T08:45:47.735Z\",\n \"customerOrderId\": \"LimitSell\",\n \"timeInForce\": \"GTC\"\n}"},{"id":"addafb7c-dba4-4f27-b976-37f395890f54","name":"Partially Filled","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/:currencyPair/orderid/:orderId","host":["https://api.valr.com"],"path":["v1","orders",":currencyPair","orderid",":orderId"],"variable":[{"key":"currencyPair","value":"ETHBTC","description":"The currency pair"},{"key":"orderId","value":"0198178f-a957-7684-b650-eb987183f8e5","description":"The order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"41"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 17 Jul 2025 08:47:11 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"0198178f-a957-7684-b650-eb987183f8e5\",\n \"orderStatusType\": \"Partially Filled\",\n \"currencyPair\": \"ETHBTC\",\n \"originalPrice\": \"0.03\",\n \"remainingQuantity\": \"0.032333\",\n \"originalQuantity\": \"0.033333\",\n \"orderSide\": \"sell\",\n \"orderType\": \"post-only limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2025-07-17T08:47:05.537Z\",\n \"orderCreatedAt\": \"2025-07-17T08:45:47.735Z\",\n \"customerOrderId\": \"LimitSell\",\n \"timeInForce\": \"GTC\"\n}"},{"id":"9bb48f22-a49c-4936-a316-a97f33f79303","name":"Placed","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/:currencyPair/orderid/:orderId","host":["https://api.valr.com"],"path":["v1","orders",":currencyPair","orderid",":orderId"],"variable":[{"key":"currencyPair","value":"ETHBTC","description":"The currency pair"},{"key":"orderId","value":"01981786-c482-7bae-a3da-4a756ef9d12e","description":"The order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"6"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 17 Jul 2025 08:36:16 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"01981786-c482-7bae-a3da-4a756ef9d12e\",\n \"orderStatusType\": \"Placed\",\n \"currencyPair\": \"ETHBTC\",\n \"originalPrice\": \"0.0355\",\n \"remainingQuantity\": \"0.000565\",\n \"originalQuantity\": \"0.000565\",\n \"orderSide\": \"sell\",\n \"orderType\": \"post-only limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2025-07-17T08:36:04.867Z\",\n \"orderCreatedAt\": \"2025-07-17T08:36:04.866Z\",\n \"customerOrderId\": \"LimitSell\",\n \"timeInForce\": \"GTC\"\n}"},{"id":"06d12032-1f2d-4964-b4ff-52f18d00caa5","name":"Active Stop Order","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/:currencyPair/orderid/:orderId","host":["https://api.valr.com"],"path":["v1","orders",":currencyPair","orderid",":orderId"],"variable":[{"key":"currencyPair","value":"XRPZAR","description":"The currency pair"},{"key":"orderId","value":"ff72a8d6-161f-43a6-806d-68061afc3c7a","description":"The order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Thu, 18 Aug 2022 12:35:04 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"5"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"ff72a8d6-161f-43a6-806d-68061afc3c7a\",\n \"orderStatusType\": \"Active\",\n \"currencyPair\": \"XRPZAR\",\n \"originalPrice\": \"10\",\n \"remainingQuantity\": \"10\",\n \"originalQuantity\": \"10\",\n \"orderSide\": \"buy\",\n \"orderType\": \"take-profit-limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2022-08-18T12:34:56.115Z\",\n \"orderCreatedAt\": \"2022-08-18T12:34:56.112Z\",\n \"customerOrderId\": \"556789\",\n \"stopPrice\": \"12\",\n \"timeInForce\": \"GTC\"\n}"},{"id":"68ca5488-b615-4eda-b208-1d3e3c41b305","name":"Triggered Stop Order","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/:currencyPair/orderid/:orderId","host":["https://api.valr.com"],"path":["v1","orders",":currencyPair","orderid",":orderId"],"variable":[{"key":"currencyPair","value":"XRPZAR","description":"The currency pair"},{"key":"orderId","value":"b4b678f4-eae7-477d-b48f-0e27a25efadc","description":"The order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Thu, 18 Aug 2022 12:42:45 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"6"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"b4b678f4-eae7-477d-b48f-0e27a25efadc\",\n \"orderStatusType\": \"Placed\",\n \"currencyPair\": \"XRPZAR\",\n \"originalPrice\": \"10\",\n \"remainingQuantity\": \"10\",\n \"originalQuantity\": \"10\",\n \"orderSide\": \"sell\",\n \"orderType\": \"stop-loss-limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2022-08-18T12:40:07.992Z\",\n \"orderCreatedAt\": \"2022-08-17T15:13:24.732Z\",\n \"stopPrice\": \"3000\",\n \"timeInForce\": \"GTC\"\n}"}],"_postman_id":"8d9252e1-ee27-495e-86ed-57458bdafd19"},{"name":"Order Status (customerOrderId)","id":"87c78a99-c94c-4b16-a986-5957a62a66fc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"Your API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
This API returns the status of an order that was placed on the Exchange queried using customerOrderId. The customer can specify a customerOrderId while placing an order on the Exchange. Use this API to query the order status using that customerOrderId.
The currency pair
\n","type":"text/plain"},"type":"any","value":"BTCUSDT","key":"currencyPair"},{"description":{"content":"The order ID provided by the customer when creating the order.
\n","type":"text/plain"},"type":"any","value":"1234","key":"customerOrderId"}]}},"response":[{"id":"dccf4d14-2a17-4b84-80cd-a0729bb7c4cb","name":"Order Filled","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/:currencyPair/customerorderid/:customerOrderId","host":["https://api.valr.com"],"path":["v1","orders",":currencyPair","customerorderid",":customerOrderId"],"variable":[{"key":"currencyPair","value":"ETHBTC","description":"The currency pair"},{"key":"customerOrderId","value":"LimitSell","description":"The order ID provided by the customer when creating the order."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"36"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 17 Jul 2025 10:05:35 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"0198178f-a957-7684-b650-eb987183f8e5\",\n \"orderStatusType\": \"Filled\",\n \"currencyPair\": \"ETHBTC\",\n \"originalPrice\": \"0.03\",\n \"remainingQuantity\": \"0\",\n \"originalQuantity\": \"0.033333\",\n \"orderSide\": \"sell\",\n \"orderType\": \"post-only limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2025-07-17T08:53:00.620Z\",\n \"orderCreatedAt\": \"2025-07-17T08:45:47.735Z\",\n \"customerOrderId\": \"LimitSell\",\n \"timeInForce\": \"GTC\"\n}"},{"id":"ca02ac3e-fbed-4aeb-95e9-2e1f212ec1bb","name":"Order placed","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/:currencyPair/customerorderid/:customerOrderId","host":["https://api.valr.com"],"path":["v1","orders",":currencyPair","customerorderid",":customerOrderId"],"variable":[{"key":"currencyPair","value":"ETHBTC","description":"The currency pair"},{"key":"customerOrderId","value":"LimitSell","description":"The order ID provided by the customer when creating the order."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"36"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 17 Jul 2025 10:08:08 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"019817da-ed41-7e7c-b68b-2b58644d3e89\",\n \"orderStatusType\": \"Placed\",\n \"currencyPair\": \"ETHBTC\",\n \"originalPrice\": \"0.03\",\n \"remainingQuantity\": \"0.033333\",\n \"originalQuantity\": \"0.033333\",\n \"orderSide\": \"sell\",\n \"orderType\": \"post-only limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2025-07-17T10:08:00.348Z\",\n \"orderCreatedAt\": \"2025-07-17T10:08:00.321Z\",\n \"customerOrderId\": \"LimitSell\",\n \"timeInForce\": \"GTC\"\n}"},{"id":"af87d095-fab3-4a05-be61-268a41f25ae3","name":"Invalid Order","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/:currencyPair/customerorderid/:customerOrderId","host":["https://api.valr.com"],"path":["v1","orders",":currencyPair","customerorderid",":customerOrderId"],"variable":[{"key":"currencyPair","value":"ETHBTC","description":"The currency pair"},{"key":"customerOrderId","value":"invalidID","description":"The order ID provided by the customer when creating the order."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"78"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 17 Jul 2025 10:11:04 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -1,\n \"message\": \"Invalid Order. \"\n}"},{"id":"85c37a9c-dc3c-46f6-9579-1884a9b011bf","name":"Partially Filled","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/:currencyPair/customerorderid/:customerOrderId","host":["https://api.valr.com"],"path":["v1","orders",":currencyPair","customerorderid",":customerOrderId"],"variable":[{"key":"currencyPair","value":"ETHBTC","description":"The currency pair"},{"key":"customerOrderId","value":"LimitSell","description":"The order ID provided by the customer when creating the order."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"6"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 17 Jul 2025 10:09:50 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"019817da-ed41-7e7c-b68b-2b58644d3e89\",\n \"orderStatusType\": \"Partially Filled\",\n \"currencyPair\": \"ETHBTC\",\n \"originalPrice\": \"0.03\",\n \"remainingQuantity\": \"0.023333\",\n \"originalQuantity\": \"0.033333\",\n \"orderSide\": \"sell\",\n \"orderType\": \"post-only limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2025-07-17T10:09:45.204Z\",\n \"orderCreatedAt\": \"2025-07-17T10:08:00.321Z\",\n \"customerOrderId\": \"LimitSell\",\n \"timeInForce\": \"GTC\"\n}"},{"id":"d0098633-4c3e-43af-a83d-2eb681270cc2","name":"Order failed","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/:currencyPair/customerorderid/:customerOrderId","host":["https://api.valr.com"],"path":["v1","orders",":currencyPair","customerorderid",":customerOrderId"],"variable":[{"key":"currencyPair","value":"ETHBTC","description":"The currency pair"},{"key":"customerOrderId","value":"1234","description":"The order ID provided by the customer when creating the order."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"5"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 17 Jul 2025 10:14:00 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"019817df-c3a3-771f-894a-90a8e6a7824e\",\n \"orderStatusType\": \"Failed\",\n \"currencyPair\": \"ETHBTC\",\n \"originalPrice\": \"0\",\n \"remainingQuantity\": \"0.01\",\n \"originalQuantity\": \"0.01\",\n \"orderSide\": \"buy\",\n \"orderType\": \"market\",\n \"failedReason\": \"We did not execute this order since it would have matched with your own order on the Exchange\",\n \"orderUpdatedAt\": \"2025-07-17T10:13:17.348Z\",\n \"orderCreatedAt\": \"2025-07-17T10:13:17.347Z\",\n \"customerOrderId\": \"1234\",\n \"timeInForce\": \"IOC\"\n}"},{"id":"84524322-6a6a-4afa-96f9-b6daed9afcc4","name":"Active Stop Order","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/:currencyPair/customerorderid/:customerOrderId","host":["https://api.valr.com"],"path":["v1","orders",":currencyPair","customerorderid",":customerOrderId"],"variable":[{"key":"currencyPair","value":"XRPZAR","description":"The currency pair"},{"key":"customerOrderId","value":"556789","description":"The order ID provided by the customer when creating the order."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Thu, 18 Aug 2022 12:36:21 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"7"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"ff72a8d6-161f-43a6-806d-68061afc3c7a\",\n \"orderStatusType\": \"Active\",\n \"currencyPair\": \"XRPZAR\",\n \"originalPrice\": \"10\",\n \"remainingQuantity\": \"10\",\n \"originalQuantity\": \"10\",\n \"orderSide\": \"buy\",\n \"orderType\": \"take-profit-limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2022-08-18T12:34:56.115Z\",\n \"orderCreatedAt\": \"2022-08-18T12:34:56.112Z\",\n \"customerOrderId\": \"556789\",\n \"stopPrice\": \"12\",\n \"timeInForce\": \"GTC\"\n}"}],"_postman_id":"87c78a99-c94c-4b16-a986-5957a62a66fc"},{"name":"All Open Orders","id":"910bc498-b88d-48e8-b392-6cc94b8cb66d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get all open orders for your account.
\nA customerOrderId field will be returned in the response for all those orders that were created with a customerOrderId field.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get all active conditional orders for your account.
\nA customerOrderId field will be returned in the response for all those orders that were created with a customerOrderId field.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
This API returns all active and pending trigger TWAP orders.
\n","urlObject":{"path":["v1","twap","active"],"host":["https://api.valr.com"],"query":[{"description":{"content":"(Optional) Filter returned orders by this currency pair.
\n","type":"text/plain"},"key":"symbol","value":"BTCUSDT"},{"description":{"content":"(Optional) Filter by status: ACTIVE or PENDING_TRIGGER.
\n","type":"text/plain"},"key":"status","value":"ACTIVE"}],"variable":[]}},"response":[{"id":"f932295e-72c4-40ca-991e-f18b118aed37","name":"Active TWAP Orders","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/twap/active?symbol=SOLUSDT&status=ACTIVE","host":["https://api.valr.com"],"path":["v1","twap","active"],"query":[{"key":"symbol","value":"SOLUSDT","description":"(Optional) Filter returned orders by this currency pair."},{"key":"status","value":"ACTIVE","description":"(Optional) Filter by status: ACTIVE or PENDING_TRIGGER."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":":status","value":200},{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"7"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 16 Apr 2026 08:15:10 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"alt-svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"orderId\": \"019d955a-9fa2-7815-a979-548997ff6f6e\",\n \"currencyPair\": \"SOLUSDT\",\n \"side\": \"sell\",\n \"orderType\": \"market\",\n \"totalQuantity\": \"0.2\",\n \"quantityFilled\": \"0.06\",\n \"averageFilledPrice\": \"82.99\",\n \"status\": \"ACTIVE\",\n \"createdAt\": 1776327237538,\n \"durationSeconds\": 300,\n \"cadenceSeconds\": 30,\n \"executionCount\": 3,\n \"firstExecutionAt\": 1776327237,\n \"lastExecutionAt\": 1776327297,\n \"allowMargin\": false\n },\n {\n \"orderId\": \"019d955b-79e9-75f3-a23e-de10d7060120\",\n \"currencyPair\": \"SOLUSDT\",\n \"side\": \"buy\",\n \"orderType\": \"limit\",\n \"totalQuantity\": \"1.5\",\n \"quantityFilled\": \"0.15\",\n \"price\": \"83\",\n \"averageFilledPrice\": \"83\",\n \"status\": \"ACTIVE\",\n \"createdAt\": 1776327293417,\n \"durationSeconds\": 300,\n \"cadenceSeconds\": 30,\n \"executionCount\": 1,\n \"firstExecutionAt\": 1776327293,\n \"lastExecutionAt\": 1776327293,\n \"allowMargin\": false\n },\n {\n \"orderId\": \"019d955b-9b1f-7050-8f49-e649bdcb19be\",\n \"currencyPair\": \"SOLUSDT\",\n \"side\": \"sell\",\n \"orderType\": \"limit\",\n \"totalQuantity\": \"1.5\",\n \"quantityFilled\": \"0\",\n \"price\": \"83\",\n \"status\": \"ACTIVE\",\n \"createdAt\": 1776327301919,\n \"durationSeconds\": 300,\n \"cadenceSeconds\": 30,\n \"executionCount\": 1,\n \"firstExecutionAt\": 1776327302,\n \"lastExecutionAt\": 1776327302,\n \"allowMargin\": false,\n \"lastFailureReasonCode\": -11512,\n \"lastFailureAt\": 1776327302731\n },\n {\n \"orderId\": \"019d955a-7d84-7791-ab7a-a1207bc6b353\",\n \"currencyPair\": \"SOLUSDT\",\n \"side\": \"buy\",\n \"orderType\": \"market\",\n \"totalQuantity\": \"0.2\",\n \"quantityFilled\": \"0.06\",\n \"averageFilledPrice\": \"83\",\n \"status\": \"ACTIVE\",\n \"createdAt\": 1776327228804,\n \"durationSeconds\": 300,\n \"cadenceSeconds\": 30,\n \"executionCount\": 3,\n \"firstExecutionAt\": 1776327229,\n \"lastExecutionAt\": 1776327289,\n \"allowMargin\": false\n }\n\n]"}],"_postman_id":"cd2bb2e6-602c-498c-8c29-5ef749125580"},{"name":"TWAP Order History","id":"5788c1ab-577a-498f-9d0e-080defe2869e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}"}],"url":"https://api.valr.com/v1/twap/historic?symbol=BTCUSDT&status=COMPLETED&skip=0&limit=100&startTime=1776417752770&endTime=1776762856790","description":"This API returns all completed and cancelled TWAP orders.
\n","urlObject":{"path":["v1","twap","historic"],"host":["https://api.valr.com"],"query":[{"description":{"content":"(Optional) Filter by currency pair, e.g. BTCUSDT.
\n","type":"text/plain"},"key":"symbol","value":"BTCUSDT"},{"description":{"content":"(Optional) Include only TWAP orders that have this status.\nAvailable options:\n\"COMPLETED\"\n\"CANCELLED\"\n\"FAILED\".
\n","type":"text/plain"},"key":"status","value":"COMPLETED"},{"description":{"content":"(Optional) Skip this number of results. (Default 0).
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"(Optional) Limit the results to this number. (Default and Max 100).
\n","type":"text/plain"},"key":"limit","value":"100"},{"description":{"content":"(Optional, default 7 days ago) — Start of time range in Unix milliseconds, e.g. 1770417228389.
\n","type":"text/plain"},"key":"startTime","value":"1776417752770"},{"description":{"content":"(Optional, default now) — End of time range in Unix milliseconds, e.g. 1773209228389.
\n","type":"text/plain"},"key":"endTime","value":"1776762856790"}],"variable":[]}},"response":[{"id":"ae8231bc-ed7d-4137-9ebf-3a2426f8f739","name":"TWAP Order History","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}"}],"url":{"raw":"https://api.valr.com/v1/twap/historic?symbol=ETHUSDTPERP&status=COMPLETED&skip=0&limit=100&startTime=1776417752770&endTime=1776762856790","host":["https://api.valr.com"],"path":["v1","twap","historic"],"query":[{"key":"symbol","value":"ETHUSDTPERP","description":"(Optional) Filter by currency pair, e.g. BTCUSDT, ETHUSDTPERP."},{"key":"status","value":"COMPLETED","description":"(Optional) Include only TWAP orders that have this status.\nAvailable options:\n\"COMPLETED\"\n\"CANCELLED\"\n\"FAILED\"."},{"key":"skip","value":"0","description":"(Optional) Skip this number of results. (Default 0)."},{"key":"limit","value":"100","description":"(Optional) Limit the results to this number. (Default and Max 100)."},{"key":"startTime","value":"1776417752770","description":"(Optional, default 7 days ago) — Start of time range in Unix milliseconds, e.g. 1770417228389."},{"key":"endTime","value":"1776762856790","description":"(Optional, default now) — End of time range in Unix milliseconds, e.g. 1773209228389."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":":status","value":200},{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"37"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 16 Apr 2026 08:16:18 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"alt-svc","value":"h3=\":443\"; ma=2592000"}],"cookie":[],"responseTime":null,"body":" {\n \"orderId\": \"019d9558-3c21-7ea7-8264-6f13b47b27f3\",\n \"currencyPair\": \"ETHUSDTPERP\",\n \"side\": \"buy\",\n \"orderType\": \"limit-reduce-only\",\n \"totalQuantity\": \"0.003\",\n \"quantityFilled\": \"0.003\",\n \"price\": \"2337.21\",\n \"averageFilledPrice\": \"2337.21\",\n \"status\": \"COMPLETED\",\n \"createdAt\": 1776327080993,\n \"durationSeconds\": 300,\n \"cadenceSeconds\": 30,\n \"executionCount\": 7,\n \"firstExecutionAt\": 1776327081,\n \"lastExecutionAt\": 1776327261,\n \"allowMargin\": false\n }"}],"_postman_id":"5788c1ab-577a-498f-9d0e-080defe2869e"},{"name":"TWAP Sub-Order History","id":"72fda5ec-0ad0-4d36-ab36-30afb5e50294","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}"}],"url":"https://api.valr.com/v1/twap/suborder/:currencyPair/:orderId/history?startTime=2026-03-01T10:00:00.000Z&endTime=2026-04-22T10:05:05.000Z&skip=0&limit=100","description":"This API returns the execution history of individual sub-orders for a specific TWAP order. Supports pagination and time filtering.
\n","urlObject":{"path":["v1","twap","suborder",":currencyPair",":orderId","history"],"host":["https://api.valr.com"],"query":[{"description":{"content":"(Optional) Include only records after this ISO 8601 start time.
\n","type":"text/plain"},"key":"startTime","value":"2026-03-01T10:00:00.000Z"},{"description":{"content":"(Optional) Include only records before this ISO 8601 end time.
\n","type":"text/plain"},"key":"endTime","value":"2026-04-22T10:05:05.000Z"},{"description":{"content":"Skip this number of results. (Default 0).
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100).
\n","type":"text/plain"},"key":"limit","value":"100"}],"variable":[{"id":"0f98eaad-a9ff-47f9-932b-fc58fec16301","description":{"content":"The currency pair.
\n","type":"text/plain"},"type":"any","value":"BTCUSDT","key":"currencyPair"},{"id":"546e09f7-5045-48f5-b5d6-bd61ba17be2e","description":{"content":"The TWAP order ID provided by VALR.
\n","type":"text/plain"},"type":"any","value":"019daf51-a556-7264-8e87-68809ec542fc","key":"orderId"}]}},"response":[{"id":"c76cf9f7-f5af-4278-b78e-5b9f87b7c2bf","name":"TWAP Sub-Order History","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}"}],"url":{"raw":"https://api.valr.com/v1/twap/suborder/:currencyPair/:orderId/history?startTime=2026-03-01T10:00:00.000Z&endTime=2026-04-22T10:05:05.000Z&skip=0&limit=100","host":["https://api.valr.com"],"path":["v1","twap","suborder",":currencyPair",":orderId","history"],"query":[{"key":"startTime","value":"2026-03-01T10:00:00.000Z","description":"(Optional) Include only records after this ISO 8601 start time."},{"key":"endTime","value":"2026-04-22T10:05:05.000Z","description":"(Optional) Include only records before this ISO 8601 end time."},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)."},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)."}],"variable":[{"key":"currencyPair","value":"ETHUSDTPERP","description":"The currency pair."},{"key":"orderId","value":"019d9558-3c21-7ea7-8264-6f13b47b27f3","description":"The TWAP order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":":status","value":200},{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"32"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 16 Apr 2026 08:17:13 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"alt-svc","value":"h3=\":443\"; ma=2592000"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"orderId\": \"019d955a-fe1b-7d9b-8b84-a2b724eaf2ac\",\n \"customerOrderId\": \"019d9558-3c21-7ea7-8264-6f13b47b27f3\",\n \"orderStatusType\": \"Filled\",\n \"currencyPair\": \"ETHUSDTPERP\",\n \"averagePrice\": \"2337.21\",\n \"originalPrice\": \"2337.21\",\n \"remainingQuantity\": \"0\",\n \"originalQuantity\": \"0.001\",\n \"totalExecutedQuantity\": \"0.001\",\n \"total\": \"2.33721\",\n \"totalFee\": \"0.001402326\",\n \"feeCurrency\": \"USDT\",\n \"orderSide\": \"buy\",\n \"orderType\": \"limit-reduce-only\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2026-04-16T08:14:21.735Z\",\n \"orderCreatedAt\": \"2026-04-16T08:14:21.734Z\",\n \"timeInForce\": \"IOC\"\n },\n {\n \"orderId\": \"019d9559-9e8a-73bb-a4b3-1d38dc94a80a\",\n \"customerOrderId\": \"019d9558-3c21-7ea7-8264-6f13b47b27f3\",\n \"orderStatusType\": \"Filled\",\n \"currencyPair\": \"ETHUSDTPERP\",\n \"averagePrice\": \"2337.21\",\n \"originalPrice\": \"2337.21\",\n \"remainingQuantity\": \"0\",\n \"originalQuantity\": \"0.001\",\n \"totalExecutedQuantity\": \"0.001\",\n \"total\": \"2.33721\",\n \"totalFee\": \"0.001402326\",\n \"feeCurrency\": \"USDT\",\n \"orderSide\": \"buy\",\n \"orderType\": \"limit-reduce-only\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2026-04-16T08:12:51.760Z\",\n \"orderCreatedAt\": \"2026-04-16T08:12:51.759Z\",\n \"timeInForce\": \"IOC\"\n },\n {\n \"orderId\": \"019d9558-3efb-7be9-ba25-dba03969cc89\",\n \"customerOrderId\": \"019d9558-3c21-7ea7-8264-6f13b47b27f3\",\n \"orderStatusType\": \"Filled\",\n \"currencyPair\": \"ETHUSDTPERP\",\n \"averagePrice\": \"2337.21\",\n \"originalPrice\": \"2337.21\",\n \"remainingQuantity\": \"0\",\n \"originalQuantity\": \"0.001\",\n \"totalExecutedQuantity\": \"0.001\",\n \"total\": \"2.33721\",\n \"totalFee\": \"0.001402326\",\n \"feeCurrency\": \"USDT\",\n \"orderSide\": \"buy\",\n \"orderType\": \"limit-reduce-only\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2026-04-16T08:11:21.758Z\",\n \"orderCreatedAt\": \"2026-04-16T08:11:21.757Z\",\n \"timeInForce\": \"IOC\"\n }\n]"}],"_postman_id":"72fda5ec-0ad0-4d36-ab36-30afb5e50294"},{"name":"Conditional Order Status (orderId)","id":"53874e25-f88f-4dc6-9621-d3b1d2777d6d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get the conditional order status.
\nA customerOrderId field will be returned in the response for all those orders that were created with a customerOrderId field.
Specify the currency pair for which you want to query the order status.
\nExamples: BTCUSDCPERP, ETHUSDCPERP
\n","type":"text/plain"},"type":"any","value":"AVAXUSDTPERP","key":"currencyPair"},{"description":{"content":"The order ID provided by VALR.
\n","type":"text/plain"},"type":"any","value":"e281eb8e-c315-4372-a7b6-8c5e5f5eb971","key":"orderId"}]}},"response":[{"id":"66a6d6da-375c-41bb-83ed-31be8587c11d","name":"Futures Conditional Orders Status (orderId)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/conditionals/conditional/:currencyPair/orderid/:orderId","host":["https://api.valr.com"],"path":["v1","orders","conditionals","conditional",":currencyPair","orderid",":orderId"],"variable":[{"key":"currencyPair","value":"AVAXUSDTPERP","description":"Specify the currency pair for which you want to query the order status.\nExamples: BTCUSDCPERP, ETHUSDCPERP"},{"key":"orderId","value":"e281eb8e-c315-4372-a7b6-8c5e5f5eb971","description":"The order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Sat, 12 Oct 2024 19:01:58 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"9"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"e281eb8e-c315-4372-a7b6-8c5e5f5eb971\",\n \"triggerOrderSide\": \"sell\",\n \"triggerOrderType\": \"limit-reduce-only\",\n \"currencyPair\": \"AVAXUSDTPERP\",\n \"createdAt\": \"2024-10-12T03:08:19.060Z\",\n \"updatedAt\": \"2024-10-12T03:08:19.060Z\",\n \"triggerType\": \"LAST_TRADED\",\n \"conditionalType\": \"OT_OCO\",\n \"customerOrderId\": \"ConditionalByLastTraded\",\n \"orderStatusType\": \"Placed\",\n \"quantity\": \"0.2\",\n \"takeProfitTriggerPrice\": \"44.74\",\n \"takeProfitPlacePrice\": \"44.8\",\n \"stopLossTriggerPrice\": \"30.1\",\n \"stopLossPlacePrice\": \"44.8\",\n \"linkedOrderId\": \"5b5ca343-2063-40dd-9c31-840dc72a5aab\"\n}"},{"id":"9367b70b-8e93-4d69-9954-a077b26a4b0d","name":"Spot Conditional Order Status (orderId)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/conditionals/conditional/:currencyPair/orderid/:orderId","host":["https://api.valr.com"],"path":["v1","orders","conditionals","conditional",":currencyPair","orderid",":orderId"],"variable":[{"key":"currencyPair","value":"BTCUSDT","description":"Specify the currency pair for which you want to query the order status.\n\nExamples: BTCUSDCPERP, ETHUSDCPERP"},{"key":"orderId","value":"019b0c6c-7a42-7d7b-a408-8d2266c1bd57","description":"The order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"12"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 11 Dec 2025 08:18:45 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"019b0c6c-7a42-7d7b-a408-8d2266c1bd57\",\n \"triggerOrderSide\": \"buy\",\n \"triggerOrderType\": \"limit\",\n \"currencyPair\": \"BTCUSDT\",\n \"createdAt\": \"2025-12-11T07:59:54.434Z\",\n \"updatedAt\": \"2025-12-11T07:59:54.434Z\",\n \"triggerType\": \"MARK_PRICE\",\n \"conditionalType\": \"OCO\",\n \"customerOrderId\": \"testB\",\n \"orderStatusType\": \"Placed\",\n \"quantity\": \"10\",\n \"takeProfitTriggerPrice\": \"90000\",\n \"takeProfitPlacePrice\": \"-1\",\n \"stopLossTriggerPrice\": \"93000\",\n \"stopLossPlacePrice\": \"-1\"\n}"}],"_postman_id":"53874e25-f88f-4dc6-9621-d3b1d2777d6d"},{"name":"Conditional Order Status History","id":"ca67843e-4fcf-4082-bcb1-645976ac927c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get all conditional orders for your account per currency pair.
\nA customerOrderId field will be returned in the response for all those orders that were created with a customerOrderId field.
Specify the currency pair for which you want to query the order status history.\nExamples: BTCUSDCPERP, ETHUSDCPERP
\n","type":"text/plain"},"type":"any","value":"AVAXUSDTPERP","key":"currencyPair"}]}},"response":[{"id":"24f9501b-5a7f-4fd7-9e9c-a07c42c03aef","name":"Futures Conditional Order Status History","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/conditionals/:currencyPair/history","host":["https://api.valr.com"],"path":["v1","orders","conditionals",":currencyPair","history"],"variable":[{"key":"currencyPair","value":"AVAXUSDTPERP","description":"Specify the currency pair for which you want to query the order status history.\nExamples: BTCUSDCPERP, ETHUSDCPERP"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Sat, 12 Oct 2024 03:21:59 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"21"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"orderId\": \"e281eb8e-c315-4372-a7b6-8c5e5f5eb971\",\n \"triggerOrderSide\": \"sell\",\n \"triggerOrderType\": \"limit-reduce-only\",\n \"currencyPair\": \"AVAXUSDTPERP\",\n \"createdAt\": \"2024-10-12T03:08:19.060Z\",\n \"updatedAt\": \"2024-10-12T03:08:19.167Z\",\n \"triggerType\": \"LAST_TRADED\",\n \"conditionalType\": \"OT_OCO\",\n \"customerOrderId\": \"ConditionalByLastTraded\",\n \"orderStatusType\": \"Placed\",\n \"quantity\": \"0.2\",\n \"takeProfitTriggerPrice\": \"44.74\",\n \"takeProfitPlacePrice\": \"44.8\",\n \"stopLossTriggerPrice\": \"30.1\",\n \"stopLossPlacePrice\": \"30\",\n \"linkedOrderId\": \"5b5ca343-2063-40dd-9c31-840dc72a5aab\"\n }\n]"},{"id":"1b8c5af1-f916-4e5a-bf96-4edbc30ebb50","name":"Spot Conditional Order Status History","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/conditionals/:currencyPair/history","host":["https://api.valr.com"],"path":["v1","orders","conditionals",":currencyPair","history"],"variable":[{"key":"currencyPair","value":"BTCUSDT","description":"Specify the currency pair for which you want to query the order status history.\nExamples: BTCUSDCPERP, ETHUSDCPERP"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"36"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 11 Dec 2025 10:06:13 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"orderId\": \"019b0c6c-7a42-7d7b-a408-8d2266c1bd57\",\n \"triggerOrderSide\": \"buy\",\n \"triggerOrderType\": \"limit\",\n \"currencyPair\": \"BTCUSDT\",\n \"createdAt\": \"2025-12-11T07:59:54.434Z\",\n \"updatedAt\": \"2025-12-11T07:59:54.488Z\",\n \"triggerType\": \"MARK_PRICE\",\n \"conditionalType\": \"OCO\",\n \"customerOrderId\": \"testB\",\n \"orderStatusType\": \"Placed\",\n \"quantity\": \"10\",\n \"takeProfitTriggerPrice\": \"90000\",\n \"takeProfitPlacePrice\": \"-1\",\n \"stopLossTriggerPrice\": \"93000\",\n \"stopLossPlacePrice\": \"-1\"\n },\n {\n \"orderId\": \"019b0855-fd83-773f-a527-b12a48d360a0\",\n \"triggerOrderSide\": \"buy\",\n \"triggerOrderType\": \"limit\",\n \"currencyPair\": \"BTCUSDT\",\n \"createdAt\": \"2025-12-10T12:56:51.843Z\",\n \"updatedAt\": \"2025-12-10T12:56:57.239Z\",\n \"triggerType\": \"MARK_PRICE\",\n \"conditionalType\": \"OCO\",\n \"customerOrderId\": \"testB\",\n \"orderStatusType\": \"Cancelled\",\n \"removeReason\": \"CANCELLED_BY_USER\",\n \"quantity\": \"3000\",\n \"takeProfitTriggerPrice\": \"90000\",\n \"takeProfitPlacePrice\": \"-1\",\n \"stopLossTriggerPrice\": \"93000\",\n \"stopLossPlacePrice\": \"-1\"\n }\n]"}],"_postman_id":"ca67843e-4fcf-4082-bcb1-645976ac927c"},{"name":"Order History","id":"5f0ef16a-4f9d-40f3-bcdf-b1a63a0b42a4","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get historical orders placed by you.
\nstartTime or endTimeor statusesThe startTime or endTime parameters may be used to filter the returned items by the orderUpdatedAt date. The parameters will be interpreted as being in the UTC time zone and must be supplied in the ISO 8601 format (2023-10-29T22:00:00.000Z). These two parameters may be used together or separately. When startTime is used, orders that have occurred since startTime are returned. When endTime is used, orders that have occurred up to and including endTime are returned.
In addition startTime and endTime can be used in conjunction with skip and limit. When specified together you will be able to paginate the result within the time range specified.
Example:
\nstartTime specified as 2023-09-01T00:00:00.000Z
endTime specified as 2023-10-01T00:00:00.000Z
skip specified as 0 and limit 100
This will example will return the most recent 100 orders between the startTime and endTime
The statuses parameter may be used to filter the returned items by a comma-separated list of statuses from the following list of supported order statuses:
PLACED
\nFAILED
\nCANCELLED
\nFILLED
\nPARTIALLY_FILLED
\nACTIVE
\nEXPIRED
\nPARTIALLY_FILLED_DUE_TO_SLIPPAGE
\nORDER_MODIFIED
\ncurrencyPairThe currencyPair parameter may be used to filter the returned items by the currency pair symbol (Example: BTCUSDC, SOLUSDC etc.).
showZeroVolumeCancels & excludeFailuresThe showZeroVolumeCancels parameter can be used to toogle cancelled orders that did not match. The default value is false.
Setting the excludeFailures parameter to true will filter failed orders from the returned items. The default value is false.
Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"2"},{"disabled":true,"description":{"content":"(Optional) Include only records after this ISO 8601 start time
\n","type":"text/plain"},"key":"startTime","value":"2023-10-13T17:30:01.000Z"},{"disabled":true,"description":{"content":"(Optional) Include only records before this ISO 8601 end time
\n","type":"text/plain"},"key":"endTime","value":"2023-10-14T13:30:00.000Z"},{"description":{"content":"(Optional) Include only orders that have this status.\nAvailable options:\n\"PLACED\"\n\"FAILED\"\n\"CANCELLED\"\n\"FILLED\"\n\"PARTIALLY_FILLED\"\n\"EXPIRED\"\n\"PARTIALLY_FILLED_DUE_TO_SLIPPAGE\"\n\"ORDER_MODIFIED\"\n\"REPRICED_DUE_TO_SLIPPAGE\"
\n","type":"text/plain"},"key":"statuses","value":"FILLED"},{"description":{"content":"(Optional) Filter returned orders by this currency pair.
\n","type":"text/plain"},"key":"currencyPair","value":"BTCUSDC,ETHUSDC"},{"disabled":true,"description":{"content":"(Optional) TRUE or FALSE
(Optional) TRUE or FALSE
Your API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
An order is considered completed when the \"Order Status\" call returns one of the following statuses: \"Filled\", \"Cancelled\" or \"Failed\". When this happens, you can get a more detailed summary about this order using this call. Orders that are not completed are invalid for this request.
\n","urlObject":{"path":["v1","orders","history","summary","orderid",":orderId"],"host":["https://api.valr.com"],"query":[],"variable":[{"description":{"content":"The order ID provided by VALR.
\n","type":"text/plain"},"type":"any","value":"8ca691c4-9be8-4427-ae5e-905cdfc18491","key":"orderId"}]}},"response":[{"id":"3f05ab07-e3c5-465b-857c-95e9b6986aaf","name":"Order History Summary (orderId)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/history/summary/orderid/:orderId","host":["https://api.valr.com"],"path":["v1","orders","history","summary","orderid",":orderId"],"variable":[{"key":"orderId","value":"b47d36bf-adbc-4310-b904-b326a5be9079","description":"The order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Mon, 08 Feb 2021 15:11:22 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"9"},{"key":"server","value":"envoy"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"b47d36bf-adbc-4310-b904-b326a5be9079\",\n \"orderStatusType\": \"Filled\",\n \"currencyPair\": \"ETHZAR\",\n \"averagePrice\": \"8104\",\n \"originalPrice\": \"123\",\n \"remainingQuantity\": \"0\",\n \"originalQuantity\": \"0.01517769\",\n \"total\": \"122.99999976\",\n \"totalExecutedQuantity\": \"0.01517769\",\n \"totalFee\": \"0.000113832675\",\n \"feeCurrency\": \"ETH\",\n \"orderSide\": \"buy\",\n \"orderType\": \"simple\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2021-02-01T15:57:57.994Z\",\n \"orderCreatedAt\": \"2021-02-01T15:57:57.992Z\",\n \"timeInForce\": \"GTC\"\n}"},{"id":"672778d2-a308-4c51-b2fc-bc131211acce","name":"Filled Stop Order","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/history/summary/orderid/:orderId","host":["https://api.valr.com"],"path":["v1","orders","history","summary","orderid",":orderId"],"variable":[{"key":"orderId","value":"b4b678f4-eae7-477d-b48f-0e27a25efadc","description":"The order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Thu, 18 Aug 2022 12:48:16 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"5"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"b4b678f4-eae7-477d-b48f-0e27a25efadc\",\n \"orderStatusType\": \"Filled\",\n \"currencyPair\": \"XRPZAR\",\n \"averagePrice\": \"10\",\n \"originalPrice\": \"10\",\n \"remainingQuantity\": \"0\",\n \"originalQuantity\": \"10\",\n \"total\": \"100\",\n \"totalExecutedQuantity\": \"10\",\n \"totalFee\": \"0\",\n \"feeCurrency\": \"ZAR\",\n \"orderSide\": \"sell\",\n \"orderType\": \"stop-loss-limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2022-08-18T12:47:01.991Z\",\n \"orderCreatedAt\": \"2022-08-17T15:13:24.732Z\",\n \"stopPrice\": \"3000\",\n \"timeInForce\": \"GTC\"\n}"}],"_postman_id":"7f42e4d5-c853-4da2-9c7d-adb4f3385ca2"},{"name":"Order History Summary (customerOrderId)","id":"112c551e-4ee3-46a3-8fcf-0db07d3f48f2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"Your API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
An order is considered completed when the \"Order Status\" call returns one of the following statuses: \"Filled\", \"Cancelled\" or \"Failed\". When this happens, you can get a more detailed summary about this order using this call. Orders that are not completed are invalid for this request.
\n","urlObject":{"path":["v1","orders","history","summary","customerorderid",":customerOrderId"],"host":["https://api.valr.com"],"query":[],"variable":[{"description":{"content":"The order ID provided by the customer when creating the order.
\n","type":"text/plain"},"type":"any","value":"1234","key":"customerOrderId"}]}},"response":[{"id":"458b67c0-0a6c-443d-b49c-00ff9841fa4b","name":"Order History Summary (customerOrderId)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/history/summary/customerorderid/:customerOrderId","host":["https://api.valr.com"],"path":["v1","orders","history","summary","customerorderid",":customerOrderId"],"variable":[{"key":"customerOrderId","value":"LimitSell","description":"The order ID provided by the customer when creating the order."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"17"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 17 Jul 2025 10:31:37 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"0198178f-a957-7684-b650-eb987183f8e5\",\n \"customerOrderId\": \"LimitSell\",\n \"orderStatusType\": \"Filled\",\n \"currencyPair\": \"ETHBTC\",\n \"averagePrice\": \"0.03\",\n \"originalPrice\": \"0.03\",\n \"remainingQuantity\": \"0\",\n \"originalQuantity\": \"0.033333\",\n \"total\": \"0.00099999\",\n \"totalExecutedQuantity\": \"0.033333\",\n \"totalFee\": \"0.000000799992\",\n \"feeCurrency\": \"BTC\",\n \"orderSide\": \"sell\",\n \"orderType\": \"post-only limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2025-07-17T08:53:00.620Z\",\n \"orderCreatedAt\": \"2025-07-17T08:45:47.735Z\",\n \"timeInForce\": \"GTC\"\n}"},{"id":"7dc99ec0-bd3f-4553-b66d-404e7fec78a4","name":"Failed Stop Order","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/history/summary/customerorderid/:customerOrderId","host":["https://api.valr.com"],"path":["v1","orders","history","summary","customerorderid",":customerOrderId"],"variable":[{"key":"customerOrderId","value":"556789","description":"The order ID provided by the customer when creating the order."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Thu, 18 Aug 2022 12:49:31 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"8"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"b54f42ab-8228-4783-aad9-8b66f63a52d0\",\n \"customerOrderId\": \"556789\",\n \"orderStatusType\": \"Failed\",\n \"currencyPair\": \"XRPZAR\",\n \"averagePrice\": \"0\",\n \"originalPrice\": \"10\",\n \"remainingQuantity\": \"10\",\n \"originalQuantity\": \"10\",\n \"total\": \"0\",\n \"totalExecutedQuantity\": \"0\",\n \"totalFee\": \"0\",\n \"feeCurrency\": \"XRP\",\n \"orderSide\": \"buy\",\n \"orderType\": \"stop-loss-limit\",\n \"failedReason\": \"Stop order failed as it would have been triggered immediately\",\n \"orderUpdatedAt\": \"2022-08-18T12:33:23.264Z\",\n \"orderCreatedAt\": \"2022-08-18T12:33:23.260Z\",\n \"stopPrice\": \"12\",\n \"timeInForce\": \"GTC\"\n}"}],"_postman_id":"112c551e-4ee3-46a3-8fcf-0db07d3f48f2"},{"name":"Order History Detail (orderId)","id":"a5d5dbcd-e034-422c-acec-4257e3c12e2d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n","type":"text"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","type":"text"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get a detailed history of an order's statuses. This call returns an array of \"Order Status\" objects. The latest and most up-to-date status of this order is the zeroth element in the array.
\nBy default, this endpoint only returns status updates for orders that have seen activity within the last 14 days. If the order has not been updated within this window, the request may return an empty result. To retrieve the latest status of an older order without date restrictions, please use the Order History Summary (orderId) endpoint instead.
\n","urlObject":{"path":["v1","orders","history","detail","orderid",":orderId"],"host":["https://api.valr.com"],"query":[],"variable":[{"description":{"content":"The order ID provided by VALR.
\n","type":"text/plain"},"type":"any","value":"68b4e939-0f90-41ed-8525-8c9c3509ca63","key":"orderId"}]}},"response":[{"id":"0dce81fa-91d2-4f6e-ad67-474e69aa07b6","name":"Order History Detail (orderId)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/history/detail/orderid/:orderId","host":["https://api.valr.com"],"path":["v1","orders","history","detail","orderid",":orderId"],"variable":[{"key":"orderId","value":"01981766-9288-7624-a5fa-3942fdda6f70","description":"The order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"16"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Fri, 18 Jul 2025 08:15:11 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"orderId\": \"01981766-9288-7624-a5fa-3942fdda6f70\",\n \"orderStatusType\": \"Failed\",\n \"currencyPair\": \"BTCUSDT\",\n \"originalPrice\": \"0\",\n \"remainingQuantity\": \"0.00000786\",\n \"originalQuantity\": \"0.00000786\",\n \"orderSide\": \"sell\",\n \"orderType\": \"market\",\n \"failedReason\": \"Order cancelled as it would have matched outside of slippage price band\",\n \"orderUpdatedAt\": \"2025-07-17T08:00:54.927Z\",\n \"orderCreatedAt\": \"2025-07-17T08:00:54.920Z\",\n \"customerOrderId\": \"1234\",\n \"executedFee\": \"0\",\n \"executedPrice\": \"0\",\n \"executedQuantity\": \"0\",\n \"timeInForce\": \"IOC\"\n }\n]"},{"id":"cf9f415d-85f6-480b-bd07-ce403369be62","name":"Modified Order","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/history/detail/orderid/:orderId","host":["https://api.valr.com"],"path":["v1","orders","history","detail","orderid",":orderId"],"variable":[{"key":"orderId","value":"01981c9d-c31d-71de-995d-f221bfaf5112","description":"The order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"4"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Fri, 18 Jul 2025 08:20:11 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"orderId\": \"01981c9d-c31d-71de-995d-f221bfaf5112\",\n \"orderStatusType\": \"Order Modified\",\n \"currencyPair\": \"ETHBTC\",\n \"originalPrice\": \"0.03545\",\n \"remainingQuantity\": \"0.002\",\n \"originalQuantity\": \"0.002\",\n \"orderSide\": \"sell\",\n \"orderType\": \"post-only limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2025-07-18T08:20:02.997Z\",\n \"orderCreatedAt\": \"2025-07-18T08:19:17.917Z\",\n \"customerOrderId\": \"123\",\n \"executedFee\": \"0\",\n \"executedPrice\": \"0\",\n \"executedQuantity\": \"0\",\n \"timeInForce\": \"GTC\"\n },\n {\n \"orderId\": \"01981c9d-c31d-71de-995d-f221bfaf5112\",\n \"orderStatusType\": \"Placed\",\n \"currencyPair\": \"ETHBTC\",\n \"originalPrice\": \"0.0354\",\n \"remainingQuantity\": \"0.001\",\n \"originalQuantity\": \"0.001\",\n \"orderSide\": \"sell\",\n \"orderType\": \"post-only limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2025-07-18T08:19:17.918Z\",\n \"orderCreatedAt\": \"2025-07-18T08:19:17.917Z\",\n \"customerOrderId\": \"123\",\n \"executedFee\": \"0\",\n \"executedPrice\": \"0\",\n \"executedQuantity\": \"0\",\n \"timeInForce\": \"GTC\"\n }\n]"},{"id":"04e7ad32-aace-40e5-bcec-3de436d47eec","name":"Active Stop Order","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/history/detail/orderid/:orderId","host":["https://api.valr.com"],"path":["v1","orders","history","detail","orderid",":orderId"],"variable":[{"key":"orderId","value":"b4b678f4-eae7-477d-b48f-0e27a25efadc","description":"The order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Thu, 18 Aug 2022 11:58:52 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"12"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"orderId\": \"b4b678f4-eae7-477d-b48f-0e27a25efadc\",\n \"orderStatusType\": \"Active\",\n \"currencyPair\": \"XRPZAR\",\n \"originalPrice\": \"10\",\n \"remainingQuantity\": \"10\",\n \"originalQuantity\": \"10\",\n \"orderSide\": \"sell\",\n \"orderType\": \"stop-loss-limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2022-08-17T15:13:24.736Z\",\n \"orderCreatedAt\": \"2022-08-17T15:13:24.732Z\",\n \"executedFee\": \"0\",\n \"executedPrice\": \"0\",\n \"executedQuantity\": \"0\",\n \"stopPrice\": \"3000\",\n \"timeInForce\": \"GTC\"\n }\n]"}],"_postman_id":"a5d5dbcd-e034-422c-acec-4257e3c12e2d"},{"name":"Order History Detail (customerOrderId)","id":"ed7fbcb1-550f-4b73-8b48-273f5ee78cdb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"Your API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get a detailed history of an order's statuses. This call returns an array of \"Order Status\" objects. The latest and most up-to-date status of this order is the zeroth element in the array.
\n","urlObject":{"path":["v1","orders","history","detail","customerorderid",":customerOrderId"],"host":["https://api.valr.com"],"query":[],"variable":[{"description":{"content":"The order ID provided by the customer when creating the order.
\n","type":"text/plain"},"type":"any","value":"test1","key":"customerOrderId"}]}},"response":[{"id":"95ee705f-f599-443c-909a-2512eaf47708","name":"Order History Detail (customerOrderId)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/history/detail/customerorderid/:customerOrderId","host":["https://api.valr.com"],"path":["v1","orders","history","detail","customerorderid",":customerOrderId"],"variable":[{"key":"customerOrderId","value":"test1","description":"The order ID provided by the customer when creating the order."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"14"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Mon, 25 Aug 2025 11:47:12 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[]"},{"id":"acda423a-3fbf-4423-97e0-726b469f90e5","name":"Failed Stop Order","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/orders/history/detail/customerorderid/:customerOrderId","host":["https://api.valr.com"],"path":["v1","orders","history","detail","customerorderid",":customerOrderId"],"variable":[{"key":"customerOrderId","value":"556790","description":"The order ID provided by the customer when creating the order."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Thu, 18 Aug 2022 14:08:41 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"6"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"orderId\": \"54b93fcd-48bf-44e5-8ed0-4a22a23c09b8\",\n \"orderStatusType\": \"Failed\",\n \"currencyPair\": \"XRPZAR\",\n \"originalPrice\": \"10\",\n \"remainingQuantity\": \"10\",\n \"originalQuantity\": \"10\",\n \"orderSide\": \"buy\",\n \"orderType\": \"take-profit-limit\",\n \"failedReason\": \"Stop order failed as it would have been triggered immediately\",\n \"orderUpdatedAt\": \"2022-08-18T14:08:30.975Z\",\n \"orderCreatedAt\": \"2022-08-18T14:08:30.972Z\",\n \"customerOrderId\": \"556790\",\n \"executedFee\": \"0\",\n \"executedPrice\": \"0\",\n \"executedQuantity\": \"0\",\n \"stopPrice\": \"12\",\n \"timeInForce\": \"GTC\"\n }\n]"}],"_postman_id":"ed7fbcb1-550f-4b73-8b48-273f5ee78cdb"},{"name":"Modify Order V1","id":"0d31c914-0393-463b-966a-97dbc50554fd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Modify Open and Partially Filled Limit Orders
Note: This API is still in Beta phase but stable. We would love to improve the user experience with your feedback. We urge you to share any suggestions by logging a quick Feature Request on our Support Portal
\nThe following values of an open or partially filled limit order can be modified.
\nPrice
\nTotal Quantity
\nRemaining Quantity
\nEither newRemainingQuantity or newTotalQuantity can be specified in the same request, but not both
\nReducing the Total quantity or Remaining quantity will maintain the modified order’s position in the order queue.
\nIncreasing the Total quantity or Remaining quantity will move the modified order to the back of the order queue.
\nModifying the price up or down will move the modified order to the back of the order queue.
\nModified orders retain their original orderId and the audit trail can be viewed in the Detailed Order History API Call
\nWhen the response is 202 - Accepted, this means that the Modify Order request has been submitted. However, this does not always mean that the order has been modified as requested.
customerOrderId has to be unique across all open orders for a given account. If you do reuse an id value that is currently an active open order, your order will not be placed (you can check the status of an order using the order status API call).
When you retrieve All Open Orders or Order History the customerOrderId field will also be returned along with the VALR's orderId for the orders in which this field was specified in the request.
The reasons why a Modify Order request could fail are as follows:
\nInsufficient balance in your account.
\nIf you're using a non-unique customerOrderId.
Self trading: If your order matches against your own order (on the other side).
\nInsufficient liquidity: If you're placing an order and there isn't enough liquidity on the order book to fulfil the order.
\nMinimum order size is not met. In this case, the response will be accepted:false, with the failure reason.
When there is nothing to modify, i.e. you request the same values as specified in the original order.
\nYour API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Modify Open and Partially Filled Limit Orders
Note: This API is still in Beta phase but stable. We would love to improve the user experience with your feedback. We urge you to share any suggestions by logging a quick Feature Request on our Support Portal
\nThe following values of an open or partially filled limit order can be modified.
\nModified orders retain their original orderId and the audit trail can be viewed in the Detailed Order History API Call
\nWhen the response is 201 - CREATED, this means that the Modify Order request has been submitted and processed successfully.
customerOrderId has to be unique across all open orders for a given account. If you do reuse an id value that is currently an active open order, your order will not be placed (you can check the status of an order using the order status API call).All Open Orders or Order History the customerOrderId field will also be returned along with the VALR's orderId for the orders in which this field was specified in the request.The reasons why a Modify Order request could fail are as follows:
\ncustomerOrderId.accepted:false, with the failure reason.PLEASE NOTE:
\n201 Created response with an id, it means that the order has been successfully modified. You can use the Order Status REST API or use WebSocket API to receive the status of this order.modifyOrderId, orderId, code and message in the response body. See example below.{\n \"modifyOrderId\": \"d1e05e7e-7cd3-11ee-8c68-417193a135ba\",\n \"orderId\": \"d1d1130d-6c26-49a4-8637-3a6ba2463ae5\",\n \"code\": -21303,\n \"message\": \"Modify order would not have modified anything and was cancelled\"\n}\n\nYour API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Modify conditional orders.
\nThe following values of a conditional order can be modified.
\nAdding a missing Stop Loss (SL) or Take Profit (TP) trigger turns the conditional order into a one-cancel-other (OCO) conditional order. If the trigger already exists, the price will be modified.
\nModified conditional orders retain their original orderId and the audit trail can be viewed in the Detailed Order History API Call
\nNotes
\ncustomerOrderId:The reasons why a Modify Order request could fail are as follows:
\naccepted:false, with the failure reason.Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Modify a batch of open and partially filled Limit Orders in a single request.
\nNote: This API is still in Beta phase but stable. We would love to improve the user experience with your feedback. We urge you to share any suggestions by logging a quick Feature Request on our Support Portal
\nThe following values of an open or partially filled limit order can be modified.
\nPrice
\nTotal Quantity
\nRemaining Quantity
\nEither newRemainingQuantity or newTotalQuantity can be specified in the same request, but not both
\nReducing the Total quantity or Remaining quantity will maintain the modified order’s position in the order queue.
\nIncreasing the Total quantity or Remaining quantity will move the modified order to the back of the order queue.
\nModifying the price up or down will move the modified order to the back of the order queue.
\nModified orders retain their original orderId and the audit trail can be viewed in the Detailed Order History API Call
\nWhen the response is 202 - Accepted, this means that the Modify Order request has been submitted. However, this does not always mean that the order has been modified as requested.
customerOrderId has to be unique across all open orders for a given account. If you do reuse an id value that is currently an active open order, your order will not be placed (you can check the status of an order using the order status API call).All Open Orders or Order History the customerOrderId field will also be returned along with the VALR's orderId for the orders in which this field was specified in the request.The reasons why a Modify Order request could fail are as follows:
\ncustomerOrderId.accepted:false, with the failure reason.Your API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Cancel an open order.
\nA 200 OK response means the request to cancel the order was accepted. You can either use the Order Status REST API or use the WebSocket API to receive status updates about this request.
The DELETE request requires a JSON request body in the following format:
{\n \"orderId\": \"UUID\",\n \"pair\": \"BTCUSDT\"\n}\n\nAlternatively, the body can be of the following format if you specified a customerOrderId when creating your order:
{\n \"customerOrderId\": \"^[0-9a-zA-Z-]{0,50}$\",\n \"pair\": \"BTCUSDT\"\n}\n\nNOTE: When you receive this response, it does not always mean that the order has been canceled.
When the response is 200 OK, you can either use the Order Status REST API or use the WebSocket API to receive status updates about this order.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Cancel an open order.
\nA 200 OK response means the request to cancel the order was successfully completed. You can additionally use either the Order Status REST API or use the WebSocket API to receive status updates about this request.
The DELETE request requires a JSON request body in the following format:
{\n \"orderId\": \"UUID\",\n \"pair\": \"BTCUSDT\"\n}\n\nAlternatively, the body can be of the following format if you specified a customerOrderId when creating your order:
{\n \"customerOrderId\": \"^[0-9a-zA-Z-]{0,50}$\",\n \"pair\": \"BTCUSDT\"\n}\n\nThis API cancels the remaining sub-orders of an active/untriggered TWAP order.
\n","urlObject":{"path":["v1","twap",":currencyPair",":orderId"],"host":["https://api.valr.com"],"query":[],"variable":[{"id":"ab0528ff-092f-4d57-bbb2-05e810c7ff0b","description":{"content":"The currency pair.
\n","type":"text/plain"},"type":"any","value":"BTCUSDT","key":"currencyPair"},{"id":"7347ecde-3b71-40f2-a1b8-38132e74da33","description":{"content":"The order ID provided by VALR.
\n","type":"text/plain"},"type":"any","value":"019daf07-c659-74a8-81be-35e2291bce5b","key":"orderId"}]}},"response":[{"id":"3d980c8d-7f5c-4312-b719-1386505e2ce8","name":"Cancel TWAP Order","originalRequest":{"method":"DELETE","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}"},{"key":"X-VALR-TIMESTAMP","value":" {{requestTimestamp}}"}],"url":{"raw":"https://api.valr.com/v1/twap/:currencyPair/:orderId","host":["https://api.valr.com"],"path":["v1","twap",":currencyPair",":orderId"],"variable":[{"key":"currencyPair","value":"SOLUSDT","description":"The currency pair."},{"key":"orderId","value":"019d9510-d4a4-73aa-bf24-768ff2970529","description":"The order ID provided by VALR."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":":status","value":200},{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"23"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 16 Apr 2026 06:57:03 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"alt-svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"}],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"11129e1a-afbb-4f8c-905f-32b7cc73807d"},{"name":"All Conditionals","id":"ebf53840-df1c-417b-9869-793aee5dab80","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Cancel all open conditional orders for the user.
\nA 200 OK response means the request to cancel the order was accepted. You can either use the Order Status REST API or use the WebSocket API to receive status updates about this request.
NOTE: When you receive this response, it does not always mean that the order has been canceled.
When the response is 200 OK, you can either use the Order Status REST API or use the WebSocket API to receive status updates about this order.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Cancel open conditional orders for a given pair.
\nA 200 OK response means the request to cancel the order was accepted. You can either use the Order Status REST API or use the WebSocket API to receive status updates about this request.
NOTE: When you receive this response, it does not always mean that the order has been canceled.
When the response is 200 OK, you can either use the Order Status REST API or use the WebSocket API to receive status updates about this order.
Deletes only the orders associated with the specified currency pair.
\n","type":"text/plain"},"type":"any","value":"ETHUSDTPERP","key":"currencypair"}]}},"response":[{"id":"e098ce8c-a69e-4c34-9523-e0ff983b547d","name":"Deleted Conditional by Currency Pair","originalRequest":{"method":"DELETE","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.valr.com/v1/orders/conditionals/:currencypair","host":["https://api.valr.com"],"path":["v1","orders","conditionals",":currencypair"],"variable":[{"key":"currencypair","value":"ETHUSDTPERP","description":"Deletes only the orders associated with the specified currency pair."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 08 May 2024 13:59:00 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"12"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"orderId\": \"d1469f6e-774f-422b-877a-fa7ae6a03dfe\"\n }\n]"}],"_postman_id":"9c7a14d0-6265-42ec-ab06-862386b5680b"},{"name":"Conditional by ID","id":"37d3ee9c-d55a-4788-bb63-cc46981bd12b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Cancel an open conditional order.
\nA 200 OK response means the request to cancel the order was accepted. You can either use the Order Status REST API or use the WebSocket API to receive status updates about this request.
The DELETE request requires a JSON request body in the following format:
{\n \"orderId\": \"UUID\"\n}\n\nAlternatively, the body can be of the following format if you specified a customerOrderId when creating your order:
{\n \"customerOrderId\": \"^[0-9a-zA-Z-]{0,50}$\"\n}\n\nNOTE: When you receive this response, it does not always mean that the order has been canceled.
When the response is 200 OK, you can either use the Order Status REST API or use the WebSocket API to receive status updates about this order.
Your API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Cancel all open orders associated with this account.
\n","urlObject":{"path":["v1","orders"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"0ab0dfe4-8165-463d-a3f5-99804f1ca49f","name":"All Orders","originalRequest":{"method":"DELETE","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."},{"key":"Content-Type","value":"application/json"}],"url":"https://api.valr.com/v1/orders"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Thu, 18 Aug 2022 14:41:39 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"1"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"orderId\": \"c66a13ec-2ac6-4a52-9eca-608e4480194f\"\n },\n {\n \"orderId\": \"53485e46-ca8e-46c6-a784-0c175bbcd554\"\n }\n]"}],"_postman_id":"90822956-7e25-48a8-bd14-a83fb8766b46"},{"name":"All Orders for a Pair","id":"51a54c02-ee89-4710-b2cc-2a5b206df2af","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"description":"Your API Key
\n","key":"X-VALR-API-KEY","type":"text","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33"},{"description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n","key":"X-VALR-SIGNATURE","type":"text","value":"{{requestSignature}}"},{"description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Cancel all open orders for the given currency pair.
\n","urlObject":{"path":["v1","orders",":currencyPair"],"host":["https://api.valr.com"],"query":[],"variable":[{"description":{"content":"Deletes only the orders associated with the specified currency pair.
\n","type":"text/plain"},"type":"any","value":"XRPZAR","key":"currencyPair"}]}},"response":[{"id":"e6eeb080-527b-4106-bd14-4ef5e821b8b5","name":"All Orders for a Pair","originalRequest":{"method":"DELETE","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.valr.com/v1/orders/:currencyPair","host":["https://api.valr.com"],"path":["v1","orders",":currencyPair"],"variable":[{"key":"currencyPair","value":"FARTCOINUSDTPERP","description":"Deletes only the orders associated with the specified currency pair."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"14"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Tue, 26 Aug 2025 10:55:57 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"orderId\": \"0198510c-09fa-7f86-8ddb-b6b222b4e509\"\n },\n {\n \"orderId\": \"0198510c-25db-758b-9c63-fa610ac091e4\"\n },\n {\n \"orderId\": \"0198e5f9-c72f-7bc8-b763-449c067b8c33\"\n }\n]"}],"_postman_id":"51a54c02-ee89-4710-b2cc-2a5b206df2af"}],"id":"3d713155-67aa-4cda-94f7-308ecb224952","description":"Make use of our Exchange Buy/Sell APIs to place your orders on the Exchange programmatically.
\nThese APIs are protected and will require authentication. See the section on Authentication above to learn how to authenticate your API calls.
When our V1 API returns a 202 Accepted it does not guarantee that the order was placed. However, the V2 API will return 201 Created whenever the order was successfully placed/modified on the order book and200 Ok when successfully cancelled. Otherwise a 400 is returned with the reason. This allows a synchronous programming model where the response either indicates a successful placement, or a failure.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Generate a new brokerage instruction quote.
\nThis quote is not guaranteed but serves as an indicator of how the brokerage instruction will execute.
\nExample request body:
\n{\n \"payAmount\": \"100\", \n \"payCurrency\": \"ZAR\",\n \"receiveCurrency\": \"XRP\",\n \"feeRate\": \"0.01\",\n \"feeCurrency\": \"XRP\",\n \"feeAccountId\": 1315586846625202176,\n \"customerOrderId\": \"brokerage-order-01\"\n}\n\nNotes
\nThe account on which the trade is performed can be specified using the http header. Please see our Subaccounts section for more information. Not including the header will result in the order being placed against your main account.
\nfeeAccountId:
This account cannot be the same as the account in which the simple order / simple swap is placed.
customerOrderId:
Optional field for tracking orders using your internal system. It supports alphanumeric characters with a 50-character limit. Special characters are not allowed.
feeCurrency:
If the feeCurrency matches the payCurrency then the brokerage fee will be calculated from the payAmount prior the simple order being placed. If the feeCurrency matches the receiveCurrency then the brokerage fee will be calculated after the simple order / swap has completed and will be a percentage of the received amount.
feeRate:
Fees are specified as a fraction. ie: a 10% brokerage fee can be specified as 0.1
Example Response:
\n{\n \"requestPayAmount\": \"100\",\n \"actualPayAmount\": \"100\",\n \"payCurrency\": \"ZAR\",\n \"receiveCurrency\": \"XRP\",\n \"receiveAmount\": \"75\",\n \"averagePrice\": \"1.3\",\n \"leg1CurrencyPair\": \"USDTZAR\",\n \"leg2CurrencyPair\": \"XRPUSDT\",\n \"averagePriceInPayCurrency\": \"1.3\",\n \"averagePriceInReceiveCurrency\": \"0.786\",\n \"feeRate\": \"0.01\",\n \"feeAmount\": \"0.75\",\n \"feeCurrency\": \"XRP\",\n \"feeAccountId\": 1315586846625202176,\n \"customerOrderId\": \"brokerage-order-01\"\n \"leg1TradeFeeAmount\": \"0.031413\",\n \"leg1TradeFeeCurrency\": \"USDT\",\n \"leg2TradeFeeAmount\": \"0.456\",\n \"leg2TradeFeeCurrency\": \"XRP\"\n}\n\nYour API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Place a new brokerage instruction order.
\nExample request body:
\n{\n \"payAmount\": \"100\", \n \"payCurrency\": \"ZAR\",\n \"receiveCurrency\": \"XRP\",\n \"feeRate\": \"0.01\",\n \"feeCurrency\": \"XRP\",\n \"feeAccountId\": 1315586846625202176,\n \"customerOrderId\": \"brokerage-order-01\"\n}\n\nNotes
\nThe account on which the trade is performed can be specified using the http header. Please see our Subaccounts section for more information. Not including the header will result in the order being placed against your main account.
\nfeeAccountId:
This account cannot be the same as the account in which the simple order / simple swap is placed.
customerOrderId:
Optional field for tracking orders using your internal system. It supports alphanumeric characters with a 50-character limit. Special characters are not allowed.
feeCurrency:
If the feeCurrency matches the payCurrency then the brokerage fee will be calculated from the payAmount prior the simple order being placed. If the feeCurrency matches the receiveCurrency then the brokerage fee will be calculated after the simple order / swap has completed and will be a percentage of the received amount.
feeRate:
Fees are specified as a fraction. ie: a 10% brokerage fee can be specified as 0.1
Example Response:
\n{\n \"orderId\": \"de689cf3-f667-4104-905b-2fdb439618bc\"\n}\n\nYour API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get brokerage instruction history.
\nTo retrieve all instructions across all subaccounts, make this request for your main account and specify includeSubAccounts=true as a query parameter.
To retrieve all instructions for a particular subaccount, make this request using the X-VALR-SUB-ACCOUNT-ID header. Please see the Account / Subaccounts section for more information.
Example Response:
\n[\n {\n \"identifier\": \"48657a89-5ff6-483c-a8d4-e8a1d0648fb4\",\n \"orderId\": \"de689cf3-f667-4104-905b-2fdb439618bc\",\n \"transferId\": \"377573\",\n \"accountId\": 0,\n \"feeAccountId\": 1311349150067826688,\n \"requestedPayAmount\": \"100\",\n \"actualPayAmount\": \"99.99857355\",\n \"payCurrency\": \"ZAR\",\n \"receiveCurrency\": \"XRP\",\n \"receiveAmount\": \"75.544\",\n \"feeRate\": \"0.01\",\n \"feeCurrency\": \"XRP\",\n \"feeAmount\": \"0.75544\",\n \"customerOrderId\": \"brokerage-order-01\",\n \"createdAt\": 1739378546678,\n \"status\": \"COMPLETED\",\n \"leg1TradeFeeAmount\": \"0.0314130\",\n \"leg1TradeFeeCurrency\": \"USDT\",\n \"leg2TradeFeeAmount\": \"0.456\",\n \"leg2TradeFeeCurrency\": \"XRP\"\n }\n]\n\nSkip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"100"}],"variable":[]}},"response":[{"id":"1c8904b0-5fa5-4bd9-9f08-668a8311b474","name":"Brokerage instruction history for all subaccounts","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"payAmount\": \"100\", \n \"payCurrency\": \"ZAR\",\n \"receiveCurrency\": \"XRP\",\n \"feeRate\": \"0.01\",\n \"feeCurrency\": \"XRP\",\n \"feeAccountId\": 1315586846625202176,\n \"customerOrderId\": \"brokerage-order-01\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v2/brokerage/history?includeSubAccounts=true","protocol":"https","host":["api","valr","com"],"path":["v2","brokerage","history"],"query":[{"key":"includeSubAccounts","value":"true"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 14 Aug 2020 13:58:49 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"2"},{"key":"server","value":"envoy"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"identifier\": \"48657a89-5ff6-483c-a8d4-e8a1d0648fb4\",\n \"orderId\": \"de689cf3-f667-4104-905b-2fdb439618bc\",\n \"transferId\": \"377573\",\n \"accountId\": 0,\n \"feeAccountId\": 1311349150067826688,\n \"requestedPayAmount\": \"100\",\n \"actualPayAmount\": \"99.99857355\",\n \"payCurrency\": \"ZAR\",\n \"receiveCurrency\": \"XRP\",\n \"receiveAmount\": \"75.544\",\n \"feeRate\": \"0.01\",\n \"feeCurrency\": \"XRP\",\n \"feeAmount\": \"0.75544\",\n \"customerOrderId\": \"brokerage-order-01\",\n \"createdAt\": 1739378546678,\n \"status\": \"COMPLETED\",\n \"leg1TradeFeeAmount\": \"0.0314130\",\n \"leg1TradeFeeCurrency\": \"USDT\",\n \"leg2TradeFeeAmount\": \"0.456\",\n \"leg2TradeFeeCurrency\": \"XRP\"\n }\n]"}],"_postman_id":"3e8bb4c0-6f0b-4ef3-9619-dae819b9e0e3"},{"name":"Single Brokerage Instruction using OrderId","id":"d4467411-a0e9-49b3-8b2a-9cabb6ffa7ec","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Get a single brokerage instruction record using the orderId of the simple order / simple swap.
Example Response:
\n {\n \"identifier\": \"48657a89-5ff6-483c-a8d4-e8a1d0648fb4\",\n \"orderId\": \"de689cf3-f667-4104-905b-2fdb439618bc\",\n \"transferId\": \"377573\",\n \"accountId\": 0,\n \"feeAccountId\": 1311349150067826688,\n \"requestedPayAmount\": \"100\",\n \"actualPayAmount\": \"99.99857355\",\n \"payCurrency\": \"ZAR\",\n \"receiveCurrency\": \"XRP\",\n \"receiveAmount\": \"75.544\",\n \"feeRate\": \"0.01\",\n \"feeCurrency\": \"XRP\",\n \"feeAmount\": \"0.75544\",\n \"customerOrderId\": \"brokerage-order-01\",\n \"createdAt\": 1739378546678,\n \"status\": \"COMPLETED\",\n \"leg1TradeFeeAmount\": \"0.0314130\",\n \"leg1TradeFeeCurrency\": \"USDT\",\n \"leg2TradeFeeAmount\": \"0.456\",\n \"leg2TradeFeeCurrency\": \"XRP\"\n }\n\nThe unique id of the simple order or simple swap
\n","type":"text/plain"},"type":"any","value":"de689cf3-f667-4104-905b-2fdb439618bc","key":"orderId"}]}},"response":[{"id":"0e171bdf-ccbd-4111-96d2-bfd83dc26b21","name":"Single Brokerage Instruction using OrderId","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"payAmount\": \"100\", \n \"payCurrency\": \"ZAR\",\n \"receiveCurrency\": \"XRP\",\n \"feeRate\": \"0.01\",\n \"feeCurrency\": \"XRP\",\n \"feeAccountId\": 1315586846625202176,\n \"customerOrderId\": \"brokerage-order-01\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v2/brokerage/history/:orderId","protocol":"https","host":["api","valr","com"],"path":["v2","brokerage","history",":orderId"],"variable":[{"key":"orderId","value":"de689cf3-f667-4104-905b-2fdb439618bc","description":"The unique id of the simple order or simple swap"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 14 Aug 2020 13:58:49 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"2"},{"key":"server","value":"envoy"},{"key":"transfer-encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"identifier\": \"48657a89-5ff6-483c-a8d4-e8a1d0648fb4\",\n \"orderId\": \"de689cf3-f667-4104-905b-2fdb439618bc\",\n \"transferId\": \"377573\",\n \"accountId\": 0,\n \"feeAccountId\": 1311349150067826688,\n \"requestedPayAmount\": \"100\",\n \"actualPayAmount\": \"99.99857355\",\n \"payCurrency\": \"ZAR\",\n \"receiveCurrency\": \"XRP\",\n \"receiveAmount\": \"75.544\",\n \"feeRate\": \"0.01\",\n \"feeCurrency\": \"XRP\",\n \"feeAmount\": \"0.75544\",\n \"customerOrderId\": \"brokerage-order-01\",\n \"createdAt\": 1739378546678,\n \"status\": \"COMPLETED\",\n \"leg1TradeFeeAmount\": \"0.0314130\",\n \"leg1TradeFeeCurrency\": \"USDT\",\n \"leg2TradeFeeAmount\": \"0.456\",\n \"leg2TradeFeeCurrency\": \"XRP\"\n }\n]"}],"_postman_id":"d4467411-a0e9-49b3-8b2a-9cabb6ffa7ec"}],"id":"5c821b60-c92d-4e9d-ba80-b61990b720a0","description":"Brokerage instructions define a simple order or simple swap. This instruction includes the brokerage fee rate that will be levied against the order and the account identifier to which the fee is swept.
\nBrokerage Instructions trigger a 2 part process. The first part places a simple swap or a simple order depending on the pairs available for the trade. Once the trade completes an internal transfer is performed to move the fee from the account where the trade occurred to another account.
\nThis can be a simple order or a simple swap. Please see our fees for clarity on how simple orders and simple swaps are billed.
\nThis API is protected and will require authentication. See the section on Authentication to learn how to authenticate your API calls.
The API key used to get brokerage quotes and place brokerage instructions will require Trade and Internal Transfer permissions. This is due to the brokerage instructions being a two part process with a simple order / simple swap followed by an internal transfer of the brokerage fee into the fee account.
Account WebSocket)Here is a list of events you can subscribe to on the Account WebSocket connection:
In order to subscribe to the MARGIN_INFO event, you must send the following message on the Account WebSocket connection once it is opened:
{ \n \"type\": \"SUBSCRIBE\", \n \"subscriptions\": [\n { \n \"event\":\"MARGIN_INFO\" \n }\n ] \n}\n\nOn subscription the latest update is sent immediately.
\nYou can unsubscribe from MARGIN_INFO, BALANCE_UPDATE and OPEN_ORDERS_UPDATE events. To unsubscribe, send an UNSUBSCRIBE message listing the event types to unsubscribe from.
For example, to unsubscribe from all three supported events, send this message:
\n{\n \"type\": \"UNSUBSCRIBE\",\n \"requests\": [\n {\n \"event\": \"MARGIN_INFO\"\n },\n {\n \"event\": \"BALANCE_UPDATE\"\n },\n {\n \"event\": \"OPEN_ORDERS_UPDATE\"\n }\n ]\n}\n\nAccount WebSocket)As soon as the connection is established, the client is automatically subscribed to all events on the Account WebSocket connection. If needed, the client can unsubscribe from any events as described below.
On connection and authentication to the Account WebSocket we will now send all account balances, open orders and positions associated with the user account. We will send one BALANCE_UPDATE message for each asset held and one OPEN_ORDERS_UPDATE message containing all open orders by the account, across all order books.
Users can also unsubscribe from these by following the example provided above.
Here is a list of events that occur on the Account WebSocket and the corresponding sample message feed:
Sample message feed:
\n {\n \"type\": \"NEW_ACCOUNT_HISTORY_RECORD\",\n \"data\": {\n \"transactionType\": {\n \"type\": \"MARKET_BUY\",\n \"description\": \"Market Buy\"\n },\n \"debitCurrency\": {\n \"symbol\": \"R\",\n \"decimalPlaces\": 2,\n \"isActive\": true,\n \"shortName\": \"ZAR\",\n \"longName\": \"Rand\",\n \"supportedWithdrawDecimalPlaces\": 2,\n \"collateral\": true,\n \"collateralWeight\": \"1\"\n },\n \"debitValue\": \"3725371.384\",\n \"creditCurrency\": {\n \"symbol\": \"BTC\",\n \"decimalPlaces\": 8,\n \"isActive\": true,\n \"shortName\": \"BTC\",\n \"longName\": \"Bitcoin\",\n \"supportedWithdrawDecimalPlaces\": 8,\n \"collateral\": true,\n \"collateralWeight\": \"0.975\"\n },\n \"creditValue\": \"4.65205751577\",\n \"feeCurrency\": {\n \"symbol\": \"BTC\",\n \"decimalPlaces\": 8,\n \"isActive\": true,\n \"shortName\": \"BTC\",\n \"longName\": \"Bitcoin\",\n \"supportedWithdrawDecimalPlaces\": 8,\n \"collateral\": true,\n \"collateralWeight\": \"0.975\"\n },\n \"feeValue\": \"0.00465671423\",\n \"eventAt\": \"2022-11-14T20:00:58.263Z\",\n \"additionalInfo\": {\n \"costPerCoin\": 800000,\n \"costPerCoinSymbol\": \"R\",\n \"currencyPairSymbol\": \"BTCZAR\",\n \"orderId\": \"3904a62e-756c-4b02-aa15-ec9c3d19bd7d\"\n },\n \"id\": \"a3c85807-34ed-4515-84a2-6f9b863947ed\"\n }\n}\n{\n \"type\": \"NEW_ACCOUNT_HISTORY_RECORD\",\n \"data\": {\n \"transactionType\": {\n \"type\": \"SIMPLE_BUY\",\n \"description\": \"Simple Buy\"\n },\n \"debitCurrency\": {\n \"symbol\": \"R\",\n \"decimalPlaces\": 2,\n \"isActive\": true,\n \"shortName\": \"ZAR\",\n \"longName\": \"Rand\",\n \"supportedWithdrawDecimalPlaces\": 2,\n \"collateral\": true,\n \"collateralWeight\": \"1\"\n },\n \"debitValue\": \"11.999995\",\n \"creditCurrency\": {\n \"symbol\": \"ETH\",\n \"decimalPlaces\": 18,\n \"isActive\": true,\n \"shortName\": \"ETH\",\n \"longName\": \"Ethereum\",\n \"supportedWithdrawDecimalPlaces\": 8,\n \"collateral\": false,\n \"collateralWeight\": \"0.0\"\n },\n \"creditValue\": \"0.003402855725\",\n \"feeCurrency\": {\n \"symbol\": \"ETH\",\n \"decimalPlaces\": 18,\n \"isActive\": true,\n \"shortName\": \"ETH\",\n \"longName\": \"Ethereum\",\n \"supportedWithdrawDecimalPlaces\": 8,\n \"collateral\": false,\n \"collateralWeight\": \"0.0\"\n },\n \"feeValue\": \"0.000025714275\",\n \"eventAt\": \"2022-11-21T13:09:11.339Z\",\n \"additionalInfo\": {\n \"costPerCoin\": 3500,\n \"costPerCoinSymbol\": \"R\",\n \"currencyPairSymbol\": \"ETHZAR\",\n \"orderId\": \"4ecbcdf1-1f12-42fa-b8a5-ecc2719abf39\"\n },\n \"id\": \"68b103e4-fe07-4794-9015-f77beaa625e5\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"BALANCE_UPDATE\",\n \"data\": {\n \"currency\": {\n \"symbol\": \"BTC\",\n \"decimalPlaces\": 8,\n \"isActive\": true,\n \"shortName\": \"BTC\",\n \"longName\": \"Bitcoin\",\n \"supportedWithdrawDecimalPlaces\": 8,\n \"collateral\": true,\n \"collateralWeight\": \"0.95\"\n },\n \"available\": \"0.00002887\",\n \"reserved\": \"0\",\n \"total\": \"0.00002887\",\n \"updatedAt\": \"2023-03-12T03:28:36.600Z\",\n \"lendReserved\": \"0\",\n \"borrowCollateralReserved\": \"0\",\n \"borrowedAmount\": \"0\",\n \"totalInReference\": \"14.84599332\",\n \"totalInReferenceWeighted\": \"14.103693654\",\n \"referenceCurrency\": \"ZAR\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"NEW_ACCOUNT_TRADE\",\n \"currencyPairSymbol\": \"BTCUSDT\",\n \"data\": {\n \"price\": \"114,953\",\n \"quantity\": \"0.0001\",\n \"currencyPair\": \"BTCUSDT\",\n \"tradedAt\": \"2025-10-28T07:13:21.635Z\",\n \"side\": \"buy\",\n \"orderId\": \"019a29aa-0cd9-75d6-813c-994bab34c642\",\n \"id\": \"019a29aa-0ce3-75db-bfc2-dd543aa745db\",\n \"fee\": \"0.0000001\",\n \"feeCurrency\": \"BTC\",\n \"customerOrderId\": \"marketWS\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"INSTANT_ORDER_COMPLETED\",\n \"data\": {\n \"orderId\": \"247dc157-bb5b-49af-b476-2f613b780697\",\n \"success\": true,\n \"paidAmount\": \"10\",\n \"paidCurrency\": \"R\",\n \"receivedAmount\": \"0.00104473\",\n \"receivedCurrency\": \"BTC\",\n \"feeAmount\": \"0.00000789\",\n \"feeCurrency\": \"BTC\",\n \"orderExecutedAt\": \"2019-04-25T20:36:53.445\"\n }\n}\n\nSample message feed (all open orders are returned):
\n{\n \"type\": \"OPEN_ORDERS_UPDATE\",\n \"data\": [\n {\n \"orderId\": \"01972090-c325-7c8d-beed-203ff3630ba6\",\n \"side\": \"sell\",\n \"quantity\": \"0.0001\",\n \"price\": \"2100000\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"createdAt\": \"2025-05-30T09:40:47.525Z\",\n \"originalQuantity\": \"0.0001\",\n \"filledPercentage\": \"0.00\",\n \"customerOrderId\": \"MyLimit123\",\n \"type\": \"post-only limit\",\n \"status\": \"Placed\",\n \"updatedAt\": \"2025-05-30T09:40:47.526Z\",\n \"timeInForce\": \"GTC\",\n \"allowMargin\": false\n },\n {\n \"orderId\": \"01972090-dcc2-7f16-9343-fa3749aa4f9d\",\n \"side\": \"sell\",\n \"quantity\": \"0.0001\",\n \"price\": \"2200000\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"createdAt\": \"2025-05-30T09:40:54.082Z\",\n \"originalQuantity\": \"0.0001\",\n \"filledPercentage\": \"0.00\",\n \"type\": \"post-only limit\",\n \"status\": \"Placed\",\n \"updatedAt\": \"2025-05-30T09:40:54.084Z\",\n \"timeInForce\": \"GTC\",\n \"allowMargin\": false\n }\n ]\n}\n\nSample message feed (all open orders are returned) :
\n{\n \"type\": \"ORDER_STATUS_UPDATE\",\n \"data\": {\n \"orderId\": \"019a29d0-4362-7dc9-a51d-3533a4bdcf2d\",\n \"orderStatusType\": \"Order Modified\",\n \"currencyPair\": \"BTCUSDT\",\n \"originalPrice\": \"114920\",\n \"remainingQuantity\": \"0.0002\",\n \"originalQuantity\": \"0.0002\",\n \"orderSide\": \"buy\",\n \"orderType\": \"post-only limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2025-10-28T07:56:21.483Z\",\n \"orderCreatedAt\": \"2025-10-28T07:55:05.955Z\",\n \"customerOrderId\": \"testWS\",\n \"executedPrice\": \"0\",\n \"executedQuantity\": \"0\",\n \"executedFee\": \"0\",\n \"timeInForce\": \"GTC\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"OPEN_POSITION_UPDATE\",\n \"data\": {\n \"pair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0003\",\n \"realisedPnl\": \"0.08067945\",\n \"totalSessionEntryQuantity\": \"0.0003\",\n \"totalSessionValue\": \"10.9272\",\n \"sessionAverageEntryPrice\": \"36424\",\n \"averageEntryPrice\": \"36137\",\n \"unrealisedPnl\": \"-0.0567\",\n \"updatedAt\": \"2023-11-16T18:57:38.013Z\",\n \"createdAt\": \"2023-11-15T11:34:38.186Z\",\n \"positionId\": \"08dea401-ba23-ded0-28a9-03d6d59c32a4\"\n \"leverageTier\": 27\n }\n}\n\nThe REDUCE_POSITION message is emitted whenever a futures position is reduced — either partially or fully — due to a trade, liquidation, or automatic deleveraging (ADL). It provides detailed information about the amount by which the position was reduced and related metrics such as realized PnL and fees.
\n\nImportant Behavior:
\n
Partial Close: You will receive both a REDUCE_POSITION and an OPEN_POSITION_UPDATE message.
Full Close: You will receive a REDUCE_POSITION followed by a POSITION_CLOSED message.
Position Flip: If a trade closes the existing position and opens a new one in the opposite direction, you will receive:
\nREDUCE_POSITION
POSITION_CLOSED (for the original position)
OPEN_POSITION_UPDATE (for the new position)
quantity represents how much the position was reduced by — not the remaining position.
You can expect a separate REDUCE_POSITION message for each match. Each message will include the matched quantity.
For each reduction, an OPEN_POSITION_UPDATE is sent to reflect the new state of the position. You should use it to update your in-memory position.
unrealisedPnl is not included in REDUCE_POSITION but can be derived separately:
Formula:
\nunrealisedPnl = (currentMarketPrice - sessionAverageEntryPrice) \\\\* positionQuantity
Sample message feed:
\n{\n \"type\": \"REDUCE_POSITION\",\n \"data\": {\n \"currencyPair\": \"USDTZARPERP\",\n \"orderSide\": \"buy\",\n \"quantity\": \"140.576\",\n \"averageEntryPrice\": \"18.0002\",\n \"closePrice\": \"18\",\n \"realisedPnl\": \"-3.5706498\",\n \"closeType\": \"Trade\",\n \"createdAt\": \"2025-05-30T11:13:08.898Z\",\n \"fees\": \"3.5425346\",\n \"positionId\": \"27b1f2f1-a500-8dea-28a9-03190309a944\",\n \"initialMarginFractionAtClose\": \"0.1\"\n }\n}\n\nThe POSITION_CLOSED event is triggered only when a position is fully closed. If you manually close a position, you will receive both REDUCE_POSITION and POSITION_CLOSED. If a trade closes an existing position and flips it to the opposite side, you will first receive REDUCE_POSITION and POSITION_CLOSED for the original position, followed by a POSITION_UPDATE for the new position.
Sample message feed:
\n{\n \"type\": \"POSITION_CLOSED\",\n \"data\": {\n \"pair\": \"BTCUSDTPERP\",\n \"positionId\": \"08dea401-ba23-ded0-28a9-03d6d59c32a4\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"ADD_CONDITIONAL_ORDER\",\n \"data\": {\n \"orderId\": \"019a29f4-489e-7f1e-87dc-c5ef7439a755\",\n \"triggerOrderSide\": \"sell\",\n \"triggerOrderType\": \"limit-reduce-only\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"createdAt\": \"2025-10-28T08:34:26.590Z\",\n \"updatedAt\": \"2025-10-28T08:34:26.590Z\",\n \"triggerType\": \"LAST_TRADED\",\n \"conditionalType\": \"TAKE_PROFIT\",\n \"customerOrderId\": \"testWS\",\n \"positionSide\": \"buy\",\n \"positionId\": \"008dea13-85f4-69d5-28a9-03714f849984\",\n \"quantity\": \"0.0003\",\n \"takeProfitTriggerPrice\": \"117000\",\n \"takeProfitPlacePrice\": \"113000\",\n \"allowMargin\": false\n }\n}\n\ntriggerType can be one of the following valid values: MARK_PRICE, LAST_TRADED
conditionalType can be one of the following valid values: TAKE_PROFIT, STOP_LOSS
Sample message feed:
\n{\n \"type\": \"REMOVE_CONDITIONAL_ORDER\",\n \"data\": {\n \"orderId\": \"019a29f4-489e-7f1e-87dc-c5ef7439a755\",\n \"pair\": \"BTCUSDTPERP\",\n \"reason\": \"CANCELLED_BY_USER\",\n \"customerOrderId\": \"testWS\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"MODIFY_ORDER_OUTCOME\",\n \"data\": {\n \"success\": true,\n \"orderId\": \"019a29d0-4362-7dc9-a51d-3533a4bdcf2d\",\n \"customerOrderId\": \"testWS\",\n \"modifyRequestId\": \"019a2a0f-1216-737b-9065-8138dae1e874\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"ORDER_PROCESSED\",\n \"data\": {\n \"orderId\": \"019a2a2c-8c45-7ffa-815a-e7272a8216c9\",\n \"success\": true,\n \"failureReason\": \"\",\n \"customerOrderId\": \"testWS\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"ORDER_STATUS_UPDATE\",\n \"data\": {\n \"orderId\": \"019a2a46-5730-7081-bfa2-7c6fc7e2d5db\",\n \"orderStatusType\": \"Partially Filled\",\n \"currencyPair\": \"BTCUSDT\",\n \"originalPrice\": \"114950\",\n \"remainingQuantity\": \"0.0002\",\n \"originalQuantity\": \"0.0003\",\n \"orderSide\": \"sell\",\n \"orderType\": \"post-only limit\",\n \"failedReason\": \"\",\n \"orderUpdatedAt\": \"2025-10-28T10:04:40.566Z\",\n \"orderCreatedAt\": \"2025-10-28T10:04:04.272Z\",\n \"customerOrderId\": \"testWS\",\n \"executedPrice\": \"114950\",\n \"executedQuantity\": \"0.0001\",\n \"executedFee\": \"0.009196\",\n \"timeInForce\": \"GTC\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"FAILED_CANCEL_ORDER\",\n \"data\": {\n \"orderId\": \"247dc157-bb5b-49af-b476-2f613b780697\",\n \"message\": \"An error occurred while cancelling your order.\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"NEW_PENDING_RECEIVE\",\n \"data\": {\n \"currency\": {\n \"id\": 3,\n \"symbol\": \"ETH\",\n \"decimalPlaces\": 8,\n \"_isActive\": true,\n \"shortName\": \"ETH\",\n \"longName\": \"Ethereum\",\n \"currencyDecimalPlaces\": 18,\n \"supportedWithdrawDecimalPlaces\": 8,\n \"_allowBorrow\": true,\n \"_borrowWeight\": 0.925,\n \"_borrowWeightOne\": false\n },\n \"receiveAddress\": \"0xcfb6fdfc030ec1b51eb1a03689f19735fdebe3b0\",\n \"transactionHash\": \"0xd97ca2ce13707cce6ce2b211499e14d04ce104250dbeb0b59359563c05a0577d\",\n \"networkType\": \"Ethereum\",\n \"amount\": 0.0005,\n \"createdAt\": \"2025-06-05T08:40:48Z\",\n \"confirmations\": 1,\n \"confirmed\": false,\n \"indexInTx\": 51\n }\n}\n\nThis message feed is sent through every time there is an update to the number of confirmations to this pending deposit.
\nSample message feed:
\n{\n \"type\": \"SEND_STATUS_UPDATE\",\n \"data\": {\n \"uniqueId\": \"269bd37b-7328-459a-bd9a-6be4becd6a4f\",\n \"status\": \"SEND_BROADCASTED\",\n \"transactionHash\": \"0xc109b766a24276f9dd1237fd25958706dcf526045d021b535118b9d9803bd511\",\n \"confirmations\": 0\n }\n}\n\nSample message feed:
\n{\n \"type\": \"MARGIN_INFO\",\n \"data\": {\n \"marginFraction\": \"1.90363696\",\n \"collateralizedMarginFraction\": \"0.09883855\",\n \"initialMarginFraction\": \"0.098837526\",\n \"totalLeveragedExposureInReference\": \"478.041761878\",\n \"collateralizedBalancesInReference\": \"151.809292840675\",\n \"referenceCurrency\": \"USDC\",\n \"initialRequiredInReference\": \"151.808803678845\",\n \"availableInReference\": \"862.76900859039\",\n \"maintenanceMarginFraction\": \"0.047995245\",\n \"autoCloseMarginFraction\": \"0.017056799\",\n \"leverageMultiple\": 0.53,\n \"totalPositionsAtEntryInReference\": \"373.48142334\",\n \"totalUnrealisedFuturesPnlInReference\": \"-26.45828977\",\n \"totalBorrowedInReference\": \"78.102048768\",\n \"tradeReservedInReference\": \"0\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"LEVERAGE_UPDATED\",\n \"data\": {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 25,\n \"initialMarginFraction\": 0.04,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimit\": 250000,\n \"riskLimitCurrency\": \"USDT\"\n }\n}\n\nWhen you are no longer interested in receiving messages for certain events on the Account WebSocket connection, you can send a synthetic \"unsubscribe\" message. For example, if you want to unsubscribe from BALANCE_UPDATE event, you would send a message as follows:
{\n \"type\": \"UNSUBSCRIBE\",\n \"requests\": [\n {\n \"event\": \"BALANCE_UPDATE\"\n }\n ]\n}\n\nYou can now place, modify and cancel orders on the account WebSocket.
Valid types are PLACE_LIMIT_ORDER, PLACE_MARKET_ORDER, MODIFY_ORDER, BATCH_ORDERS and CANCEL_LIMIT_ORDER.
Please note that price and quantity should be provided as strings as shown in the sample requests below.
The \"payload\" portion of the JSON body supports all the same fields as the HTTP request body for the relevant order type.
\nTo maintain a clear link between requests and responses, embed a clientMsgId within your request data. This ID will be present in the returned responses that are associated with WebSocket requests as seen below.
Sample WS request:
\n{\n \"type\": \"PLACE_LIMIT_ORDER\",\n \"clientMsgId\": \"123456789abcd\",\n \"payload\": {\n \"side\": \"BUY\",\n \"quantity\": \"0.0001\",\n \"price\": \"300000\",\n \"pair\": \"BTCUSDT\",\n \"postOnly\": true,\n \"reduceOnly\": false,\n \"customerOrderId\": \"WS-JSON-2933586967831375\",\n \"timeInForce\": \"GTC\",\n \"allowMargin\": false,\n \"postOnlyReprice\": false\n }\n}\n//Sample message feed for a successful response:\n{\n \"type\": \"PLACE_LIMIT_WS_RESPONSE\",\n \"data\": {\n \"orderId\": \"22e5aa28-f52b-46ba-811e-5052fd2c7289\",\n \"customerOrderId\": \"WS-JSON-2933586967831375\"\n },\n \"clientMsgId\": \"123456789abcd\"\n}\n// Sample message feed when request exceeds rate limit\n{\n \"type\": \"RATE_LIMIT_EXCEEDED\",\n \"data\": {\n \"requestType\": \"PLACE_LIMIT_ORDER\"\n },\n \"clientMsgId\": \"123456789abcd\"\n}\n\nSample WS request:
\n{\n \"type\": \"PLACE_MARKET_ORDER\",\n \"clientMsgId\": \"123456789abcd\",\n \"payload\": {\n \"side\": \"BUY\",\n \"baseAmount\": \"0.0001\",\n \"pair\": \"BTCUSDT\",\n \"customerOrderId\": \"WS-JSON-2933586967831375\",\n \"allowMargin\": false\n }\n}\n//Sample message feed for a successful response:\n{\n \"type\": \"PLACE_MARKET_WS_RESPONSE\",\n \"data\": {\n \"orderId\": \"22e5aa28-f52b-46ba-811e-5052fd2c7289\",\n \"customerOrderId\": \"WS-JSON-2933586967831375\"\n }\n \"clientMsgId\": \"123456789abcd\"\n}\n// Sample message feed when request exceeds rate limit\n{\n \"type\": \"RATE_LIMIT_EXCEEDED\",\n \"data\": {\n \"requestType\": \"PLACE_MARKET_ORDER\"\n }\n \"clientMsgId\": \"123456789abcd\"\n}\n\nPlease note that when sending a Batch Order the type field may contain the following: PLACE_LIMIT, PLACE_MARKET, MODIFY_ORDER, and CANCEL_ORDER.
Sample WS request:
\n{\n \"type\": \"BATCH_ORDERS\",\n \"clientMsgId\": \"123456789abcd\",\n \"payload\": {\n \"requests\": [\n {\n \"type\": \"PLACE_LIMIT\",\n \"data\": {\n \"pair\": \"BTCUSDC\",\n \"side\": \"SELL\",\n \"quantity\": \"0.0021\",\n \"price\": \"60000\",\n \"timeInForce\": \"GTC\"\n }\n },\n {\n \"type\": \"PLACE_MARKET\",\n \"data\": {\n \"pair\": \"BTCUSDT\",\n \"side\": \"SELL\",\n \"quoteAmount\": \"10\",\n \"timeInForce\": \"GTC\"\n }\n },\n {\n \"type\": \"PLACE_MARKET\",\n \"data\": {\n \"pair\": \"BTCUSDT\",\n \"side\": \"SELL\",\n \"baseAmount\": \"0.0001\",\n \"timeInForce\": \"GTC\"\n }\n },\n {\n \"type\": \"MODIFY_ORDER\",\n \"data\": {\n \"customerOrderId\": \"WS-JSON-2938586967831375\",\n \"pair\": \"BTCUSDT\",\n \"newRemainingQuantity\": \"0.0001\",\n \"newPrice\": \"1870000\",\n \"modifyMatchStrategy\": \"RETAIN_ORIGINAL\"\n }\n },\n {\n \"type\": \"CANCEL_ORDER\",\n \"data\": {\n \"customerOrderId\": \"WS-JSON-2938586967831375\",\n \"pair\": \"BTCUSDT\"\n }\n }\n ]\n }\n}\n// Sample message feed when request exceeds rate limit\n{\n \"type\": \"RATE_LIMIT_EXCEEDED\",\n \"data\": {\n \"requestType\": \"BATCH_ORDERS\"\n }\n \"clientMsgId\": \"123456789abcd\"\n}\n\nSample WS request:
\n{\n \"type\": \"MODIFY_ORDER\",\n \"clientMsgId\": \"123456789abcd\",\n \"payload\": {\n \"orderId\": \"68b4e939-0f90-41ed-8525-8c9c3509ca63\",\n \"pair\": \"BTCUSDT\",\n \"newRemainingQuantity\": \"0.00034\",\n \"newPrice\": \"550000\",\n \"modifyMatchStrategy\": \"RETAIN_ORIGINAL\"\n }\n}\n//Sample message feed for a successful response:\n{\n \"type\": \"MODIFY_ORDER_WS_RESPONSE\",\n \"data\": {\n \"modifyRequestId\": \"d561fc3a-0bb1-11ef-9dcd-5fe8909be0f6\",\n \"requested\": true,\n \"orderId\": \"881c43a7-234e-4ce9-80bd-9e6085efa48c\",\n \"customerOrderId\": \"test-123\"\n }\n \"clientMsgId\": \"123456789abcd\"\n}\n// Sample message feed when request exceeds rate limit\n{\n \"type\": \"RATE_LIMIT_EXCEEDED\",\n \"data\": {\n \"requestType\": \"MODIFY_ORDER\"\n }\n \"clientMsgId\": \"123456789abcd\"\n}\n\nSample WS request:
\n{\n \"type\": \"CANCEL_LIMIT_ORDER\",\n \"clientMsgId\": \"123456789abcd\",\n \"payload\": {\n \"orderId\": \"68b4e939-0f90-41ed-8525-8c9c3509ca63\",\n \"pair\": \"BTCUSDT\"\n }\n}\n//Sample message feed for a successful response:\n{\n \"type\": \"CANCEL_ORDER_WS_RESPONSE\",\n \"data\": {\n \"requested\": true,\n \"orderId\": \"68b4e939-0f90-41ed-8525-8c9c3509ca63\",\n \"customerOrderId\": \"test-123\"\n }\n \"clientMsgId\": \"123456789abcd\"\n}\n// Sample message feed when request exceeds rate limit\n{\n \"type\": \"RATE_LIMIT_EXCEEDED\",\n \"data\": {\n \"requestType\": \"CANCEL_LIMIT_ORDER\"\n }\n \"clientMsgId\": \"123456789abcd\"\n}\n\nWhen this is flag is enabled , all open orders for the account will be cancelled when the WebSocket disconnects. This is still experimental and it is the user's responsibility to reconnect after the cancellation. Note that this request must be sent on the /account WebSocket.
Sample WS request:
\n{\n \"type\": \"CANCEL_ON_DISCONNECT\",\n \"payload\": {\n \"cancelOnDisconnect\": true\n }\n}\n//Sample message feed for a successful response:\n{\n \"type\": \"CANCEL_ON_DISCONNECT_UPDATE\",\n \"data\": {\n \"cancelOnDisconnect\": \"true\"\n }\n}\n\nIn order to receive streaming updates about Trade data, you would open up a WebSocket connection to: wss://api.valr.com/ws/account
\nOnce you open a connection to Account, you are automatically subscribed to all messages for all events on the Account WebSocket connection, except for the MARGIN_INFO event and messages. You will start receiving message feeds pertaining to your VALR account. For example, you will receive messages when your balance is updated or when a new trade is executed on your account.
In order to receive streaming updates about Trade data, you would open up a WebSocket connection to: wss://api.valr.com/ws/trade
\nWhen you open a connection to Trade, in order to receive message feeds about trading data, you must subscribe to events you are interested in on the Trade WebSocket connection.
Trade WebSocket)Here is a list of events you can subscribe to on the Trade WebSocket connection:
In order to subscribe to AGGREGATED_ORDERBOOK_UPDATE for ETHUSDT and BTCUSDT, you must send the following message on the Trade WebSocket connection once it is opened:
{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"AGGREGATED_ORDERBOOK_UPDATE\",\n \"pairs\": [\n \"ETHUSDT\",\n \"BTCUSDT\"\n ]\n }\n ]\n}\n\nOn subscription the latest update is sent immediately.
\nTo unsubscribe, send the following message:
\n{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"AGGREGATED_ORDERBOOK_UPDATE\",\n \"pairs\": []\n }\n ]\n}\n\nIn order to subscribe to FULL_ORDERBOOK_UPDATE for SOLZAR and BTCUSDC, you must send the following message on the Trade WebSocket connection once it is opened:
{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"FULL_ORDERBOOK_UPDATE\",\n \"pairs\": [\n \"SOLZAR\",\n \"BTCUSDC\"\n ]\n }\n ]\n}\n\nOn subscription the current order book snapshot is sent immediately in a message of type FULL_ORDERBOOK_SNAPSHOT. Updates are subsequently sent in FULL_ORDERBOOK_UPDATE messages.
\nTo unsubscribe, send the following message:
\n{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"FULL_ORDERBOOK_UPDATE\",\n \"pairs\": []\n }\n ]\n}\n\nIn order to subscribe to level 1 order book diffs, subscribe to event OB_L1_DIFF with the list of pairs to subscribe to. In this instance, to subscribe to SOLZAR and BTCUSDC, you must send the following message on the Trade WebSocket connection once it is opened:
{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"OB_L1_DIFF\",\n \"pairs\": [\n \"SOLZAR\",\n \"BTCUSDC\"\n ]\n }\n ]\n}\n\nOn subscription the current order book snapshot is sent immediately in a message of type OB_L1_SNAPSHOT. Updates are subsequently sent in OB_L1_DIFF messages.
\nTo unsubscribe, send the following message:
\n{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"OB_L1_DIFF\",\n \"pairs\": []\n }\n ]\n}\n\nIn order to subscribe to OB_L1_D1_SNAPSHOT or any of the supported depths (1, 5, 10, 20, 40, 80) for SOLZAR and BTCUSDC, you must send the following message on the Trade WebSocket connection once it is opened:
{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"OB_L1_D1_SNAPSHOT\",\n \"pairs\": [\n \"SOLZAR\",\n \"BTCUSDC\"\n ]\n }\n ]\n}\n\nReplace D1 with the desired price level depth. Supported: D1, D5, D10, D20, D40, D80.
\nIn order to subscribe to MARKET_SUMMARY_UPDATE for just BTCUSDT, you must send the following message on the Trade WebSocket connection once it is opened:
{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"MARKET_SUMMARY_UPDATE\",\n \"pairs\": [\n \"BTCUSDT\"\n ]\n }\n ]\n}\n\nOn subscription the latest update is sent immediately.
\nTo unsubscribe, send the following message:
\n{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"MARKET_SUMMARY_UPDATE\",\n \"pairs\": []\n }\n ]\n}\n\nIn order to subscribe to NEW_TRADE_BUCKET for ETHUSDT as well as BTCUSDT, you must send the following message on the Trade WebSocket connection once it is opened:
{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"NEW_TRADE_BUCKET\",\n \"pairs\": [\n \"ETHUSDT\",\n \"BTCUSDT\"\n ]\n }\n ]\n}\n\nTo unsubscribe, send the following message:
\n{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"NEW_TRADE_BUCKET\",\n \"pairs\": []\n }\n ]\n}\n\nIn order to subscribe to NEW_TRADE just for BTCUSDT, you must send the following message on the Trade WebSocket connection once it is opened:
{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"NEW_TRADE\",\n \"pairs\": [\n \"BTCUSDT\"\n ]\n }\n ]\n}\n\nTo unsubscribe, send the following message:
\n{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"NEW_TRADE\",\n \"pairs\": []\n }\n ]\n}\n\nIn order to subscribe to PNL_RUN_COMPLETED for ETHUSDT and BTCUSDT, you must send the following message on the Trade WebSocket connection once it is opened:
{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"PNL_RUN_COMPLETED\",\n \"pairs\": [\n \"ETHUSDT\",\n \"BTCUSDT\"\n ]\n }\n ]\n}\n\nUpon subscription, the WebSocket will listen for updates related to PNL runs for the subscribed trading pairs.
\nTo unsubscribe, send the following message:
\n{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"PNL_RUN_COMPLETED\",\n \"pairs\": []\n }\n ]\n}\n\nIn order to subscribe to FUNDING_RUN_COMPLETED for ETHUSDT and BTCUSDT, you must send the following message on the Trade WebSocket connection once it is opened:
{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"FUNDING_RUN_COMPLETED\",\n \"pairs\": [\n \"ETHUSDT\",\n \"BTCUSDT\"\n ]\n }\n ]\n}\n\nUpon subscription, the WebSocket will listen for updates related to Funding runs for the subscribed trading pairs.
\nTo unsubscribe, send the following message:
\n{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"FUNDING_RUN_COMPLETED\",\n \"pairs\": []\n }\n ]\n}\n\nTrade WebSocket)As and when events occur, the message feeds come through to the Trade WebSocket connection for the events the client has subscribed to. Below you will find an example message feed for each event specified above.
Sample message feed:
\n{\n \"type\": \"AGGREGATED_ORDERBOOK_UPDATE\",\n \"currencyPairSymbol\": \"BTCUSDT\",\n \"data\": {\n \"Asks\": [\n {\n \"side\": \"sell\",\n \"quantity\": \"0.005\",\n \"price\": \"9500\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"sell\",\n \"quantity\": \"0.01\",\n \"price\": \"9750\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"sell\",\n \"quantity\": \"0.643689\",\n \"price\": \"10000\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 3\n },\n {\n \"side\": \"sell\",\n \"quantity\": \"0.2\",\n \"price\": \"11606\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 2\n },\n {\n \"side\": \"sell\",\n \"quantity\": \"0.67713484\",\n \"price\": \"14000\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"sell\",\n \"quantity\": \"1\",\n \"price\": \"15000\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"sell\",\n \"quantity\": \"1\",\n \"price\": \"16000\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"sell\",\n \"quantity\": \"1\",\n \"price\": \"17000\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"sell\",\n \"quantity\": \"1\",\n \"price\": \"18000\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"sell\",\n \"quantity\": \"1\",\n \"price\": \"19000\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n }\n ],\n \"Bids\": [\n {\n \"side\": \"buy\",\n \"quantity\": \"0.038\",\n \"price\": \"9000\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.1\",\n \"price\": \"8802\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.2\",\n \"price\": \"8801\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.1\",\n \"price\": \"8800\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.1\",\n \"price\": \"8700\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.1\",\n \"price\": \"8600\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.1\",\n \"price\": \"8500\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.1\",\n \"price\": \"8400\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.3\",\n \"price\": \"8200\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.1\",\n \"price\": \"8100\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"0.1\",\n \"price\": \"8000\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 1\n },\n {\n \"side\": \"buy\",\n \"quantity\": \"1.08027437\",\n \"price\": \"1\",\n \"currencyPair\": \"BTCUSDT\",\n \"orderCount\": 3\n }\n ],\n \"LastChange\": \"2020-06-01T11:54:51.634Z\",\n \"SequenceNumber\": 452998\n }\n}\n\nAfter subscribing to FULL_ORDERBOOK_UPDATE for a currency pair, one snapshot of the full order book for the currency pair will be sent.
\nSample message feed:
\n{\n \"type\": \"FULL_ORDERBOOK_SNAPSHOT\",\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"data\": {\n \"LastChange\": 1644301604645,\n \"Asks\": [\n {\n \"Price\": \"45363\",\n \"Orders\": [\n {\n \"orderId\": \"1d2e7745-5020-4d48-a77e-afc787ad048d\",\n \"quantity\": \"0.0019\"\n },\n {\n \"orderId\": \"0aa53615-3ea9-42bd-a12a-16c3070b0ad3\",\n \"quantity\": \"0.00912078\"\n }\n ]\n },\n {\n \"Price\": \"45662\",\n \"Orders\": [\n {\n \"orderId\": \"9e413a52-8c03-4ddf-ab45-0943c8c3d16b\",\n \"quantity\": \"0.0018\"\n }\n ]\n },\n {\n \"Price\": \"45891\",\n \"Orders\": [\n {\n \"orderId\": \"94678c01-30da-42ec-914d-e36bfc6fe0ef\",\n \"quantity\": \"0.0019\"\n },\n {\n \"orderId\": \"2fbbc963-20b9-43be-bbc5-291a3e0203aa\",\n \"quantity\": \"0.0017\"\n }\n ]\n },\n {\n \"Price\": \"46584\",\n \"Orders\": [\n {\n \"orderId\": \"69078cb2-4dc7-4159-a25a-e5f955ef8eef\",\n \"quantity\": \"0.0018\"\n }\n ]\n },\n {\n \"Price\": \"46613\",\n \"Orders\": [\n {\n \"orderId\": \"5afa902c-3964-4d22-9964-6d5e2828f40b\",\n \"quantity\": \"0.0418\"\n },\n {\n \"orderId\": \"5324263b-0f0b-49d0-be97-4cbe33de2b80\",\n \"quantity\": \"0.0019\"\n }\n ]\n },\n {\n \"Price\": \"47052\",\n \"Orders\": [\n {\n \"orderId\": \"aae82c87-78d8-4662-88f8-6f0868797539\",\n \"quantity\": \"0.002\"\n }\n ]\n },\n {\n \"Price\": \"47288\",\n \"Orders\": [\n {\n \"orderId\": \"658bf816-2dcf-4921-a451-6ab02a45742b\",\n \"quantity\": \"0.0019\"\n }\n ]\n },\n {\n \"Price\": \"49998\",\n \"Orders\": [\n {\n \"orderId\": \"cf08ae47-3bee-4551-a92d-35e74d632f77\",\n \"quantity\": \"0.0009\"\n },\n {\n \"orderId\": \"2828ec26-e214-4eda-8ddb-b5db8cde86fa\",\n \"quantity\": \"0.0635\"\n }\n ]\n },\n {\n \"Price\": \"54000\",\n \"Orders\": [\n {\n \"orderId\": \"fd2a08af-0d33-4ddf-ba2e-e4cdd13bbd49\",\n \"quantity\": \"0.0019\"\n }\n ]\n }\n // Orders omitted for brevity\n ],\n \"Bids\": [\n {\n \"Price\": \"45147\",\n \"Orders\": [\n {\n \"orderId\": \"763080a8-9154-4c41-98de-ae09a0cf48cd\",\n \"quantity\": \"0.00014782\"\n },\n {\n \"orderId\": \"33ceace1-d1e8-4d41-af96-9b13b655f0e8\",\n \"quantity\": \"0.011\"\n }\n ]\n },\n {\n \"Price\": \"45121\",\n \"Orders\": [\n {\n \"orderId\": \"05ee59dc-a07a-42d4-ab78-a0678ce9c9f5\",\n \"quantity\": \"0.00169\"\n }\n ]\n },\n {\n \"Price\": \"44809\",\n \"Orders\": [\n {\n \"orderId\": \"da50f29f-972b-4bf2-b68d-aae8d0f3c646\",\n \"quantity\": \"0.0474\"\n },\n {\n \"orderId\": \"e42777dc-bd9c-4dfa-8573-4eac68e7d89e\",\n \"quantity\": \"0.011\"\n },\n {\n \"orderId\": \"b30f11cb-694f-46fa-9497-827a415c8ca0\",\n \"quantity\": \"0.011\"\n }\n ]\n },\n {\n \"Price\": \"44756\",\n \"Orders\": [\n {\n \"orderId\": \"3e01baa3-4b30-4c6c-9d86-31ea0f2f09d5\",\n \"quantity\": \"0.0018\"\n }\n ]\n },\n {\n \"Price\": \"44667\",\n \"Orders\": [\n {\n \"orderId\": \"f2aaedf8-30ff-4dce-8e9a-33fc47408696\",\n \"quantity\": \"0.0506\"\n }\n ]\n },\n {\n \"Price\": \"42719\",\n \"Orders\": [\n {\n \"orderId\": \"3b7123fd-653f-43af-8d6e-ea8806e0530c\",\n \"quantity\": \"0.125\"\n }\n ]\n },\n {\n \"Price\": \"42500\",\n \"Orders\": [\n {\n \"orderId\": \"e4b5ba62-b4bc-4c9f-9987-50b13d276e21\",\n \"quantity\": \"0.0002\"\n }\n ]\n },\n {\n \"Price\": \"40552\",\n \"Orders\": [\n {\n \"orderId\": \"f253ed4f-d9d5-48d5-97dc-6d38971cadf7\",\n \"quantity\": \"0.0043\"\n },\n {\n \"orderId\": \"8aa5c9b6-531f-4330-b36e-038b3648448c\",\n \"quantity\": \"0.011\"\n },\n {\n \"orderId\": \"250e5f0a-1950-48ac-9f7d-3304ff31c266\",\n \"quantity\": \"0.011\"\n }\n ]\n }\n // Orders omitted for brevity\n ],\n \"SequenceNumber\": 589628037,\n \"Checksum\": 1074477335\n }\n}\n\nAfter receiving the FULL_ORDERBOOK_SNAPSHOT, updates to the order book will be sent in FULL_ORDERBOOK_UPDATE messages.
\nSample message feed:
\n{\n \"type\": \"FULL_ORDERBOOK_UPDATE\",\n \"currencyPairSymbol\": \"BTCUSDC\",\n \"data\": {\n \"LastChange\": 1644303209930,\n \"Asks\": [\n {\n \"Price\": \"45363\",\n \"Orders\": [\n {\n \"orderId\": \"1d2e7745-5020-4d48-a77e-afc787ad048d\",\n \"quantity\": \"0\"\n },\n {\n \"orderId\": \"0aa53615-3ea9-42bd-a12a-16c3070b0ad3\",\n \"quantity\": \"0,00102078\"\n }\n ]\n },\n {\n \"Price\": \"46125\",\n \"Orders\": [\n {\n \"orderId\": \"91e730fc-7888-4c24-b977-f5329bf28790\",\n \"quantity\": \"0.0418\"\n }\n ]\n }\n ],\n \"Bids\": [],\n \"SequenceNumber\": 589628042,\n \"Checksum\": 453615100\n }\n}\n\nIn this update, following a market buy of 0.01 BTC at 45363 USDC, the first order was fully matched, and is removed, and the second order's quantity is reduced by 0.0081 BTC. At the same time a new order was placed at 46125 USDC selling 0.0418 BTC. There was no change to the Bids.
\nStart with the full order book snapshot
\nWhen an update is received, for each included order:
\nIf the order quantity is \"0\", remove the order with the given \"orderId\" from the order book if it exists
Else, update the order quantity if it already exists, or add the new order to the price level indicated by the \"Price\" field
Calculating the Checksum value
\nTo confirm the integrity of the order book data, an unsigned crc32 checksum is sent in each FULL_ORDERBOOK_UPDATE message.
\nThe Checksum is verified by taking the 25 best bids and the 25 best asks and concatenating a string with the best bid order ID, followed by the quantity, followed by the same for the best ask, then the next best bid, etc. Separate each value by a colon (:) and calculate the unsigned CRC32 hash.
Here is an example implementation:
\nconst CRC = require(\"crc/crc32\");\nconst calculateCRC32 = (orderBook) => {\n const selectBestOrders = (side) => {\n const list = [];\n for (const priceLevel of side) {\n for (const order of priceLevel.Orders) {\n if (list.length === 25) return list;\n list.push(`${order.orderId}:${order.quantity}`);\n }\n }\n return list;\n };\n const bids = selectBestOrders(orderBook.Bids);\n const asks = selectBestOrders(orderBook.Asks);\n const orders = [];\n for (let i = 0; i < 25; i++) {\n if (bids[i]) orders.push(bids[i]);\n if (asks[i]) orders.push(asks[i]);\n }\n return CRC.unsigned(orders.join(\":\"));\n};\n\nCalculating the next expected sequence number
\nTo confirm that no FULL_ORDERBOOK_UPDATE message was missed, the next expected sequence number can be calculated by adding the number of orders in an update (including \"0\" quantity updates, which removes orders) to the previous sequence number and comparing it to the number in the current message. Because an order may be partially matched one or more times before being filled or cancelled, the update message may include multiple updates of the same order.
\nAfter subscribing to OB_L1_DIFF for a currency pair, one snapshot of the order book for the currency pair will be sent.
\nSample message feed:
\n{\n \"type\": \"OB_L1_SNAPSHOT\",\n \"ps\": \"BTCUSDC\", // Currency pair symbol\n \"d\": { // Data\n \"lc\": 1644301604645, // Last Change\n \"a\": [ // Asks\n [\n \"45363\", // Price\n \"0.01102078\" // Total quantity at price level\n ],\n [\"45662\",\"0.0018\"],\n [\"45891\",\"0.0038\"],\n [\"46584\",\"0.0018\"],\n [\"46613\",\"0.0437\"],\n [\"47052\",\"0.002\"],\n [\"47288\",\"0.0019\"],\n [\"49998\",\"0.0644\"],\n [\"54000\",\"0.0019\"],\n // Orders omitted for brevity\n ],\n \"b\": [ // Bids\n [\"45147\",\"0.011\"],\n [\"45121\",\"0.00169\"],\n [\"44809\",\"0.0694\"],\n [\"44756\",\"0.0018\"],\n [\"44667\",\"0.0506\"],\n [\"42719\",\"0.125\"],\n [\"42500\",\"0.0002\"],\n [\"40552\",\"0.0263\"]\n // Price levels omitted for brevity\n ],\n \"sq\": 589628102, // Sequence number\n \"cs\": 4146165992 // Checksum\n }\n}\n\nAfter receiving the OB_L1_SNAPSHOT, updates to the order book will be sent in OB_L1_DIFF messages.
\nSample message feed:
\n{\n \"type\": \"OB_L1_DIFF\",\n \"ps\": \"BTCUSDC\", // Currency pair symbol\n \"d\": { // Data\n \"lc\": 1644303209930, // Last Change\n \"a\": [ // Asks\n [\n \"45363\", // Price\n \"0.00102078\" // Total current quantity at price level\n ],\n [\"46125\",\"0.0418\"],\n [\"46126\",\"0\"], // Quantity of 0 indicates price level can be removed\n ],\n \"b\": [], // Bids\n \"sq\": 589628111, // Sequence number\n \"cs\": 604745093 // Checksum\n }\n}\n\nIn this update, the total quantity of orders at price level 45363 and 46125 were updated and all orders at price level 46126 were removed.
Start with the order book snapshot
\nWhen an update is received, for each included price level:
\nIf the quantity is \"0\", remove the price level
Else, update the price level quantity if it already exists, or add the new price level with the specified quantity
\nSequence numbers and message ordering
On initial subscription, you will receive a sequence number with the snapshot that indicates the current ordering of the update messages that have been broadcasted. When a diff is received, the sequence number is expected to be exactly 1 higher than the previous message. If messages are received out of order then please resubscribe.
Calculating the Checksum value
\nTo confirm the integrity of the order book data, an unsigned crc32 checksum is sent in each OB_L1_DIFF message.
\nThe aggregated Checksum is verified by taking the 25 best price levels per side and concatenating a string with the best bid price level followed by the quantity, followed by the same for the best ask price level, then the next best bid, etc. Separate each value by a colon (:) and calculate the unsigned CRC32 hash.
Here is an example implementation:
\nconst CRC = require(\"crc/crc32\");\nconst calculateCRC32Checksum = (asks, bids) => {\n const orders = []\n for (let i = 0; i < 25; i++) {\n if (bids[i]) orders.push(`${bids[i][0]}:${bids[i][1]}`)\n if (asks[i]) orders.push(`${asks[i][0]}:${asks[i][1]}`)\n }\n return CRC.unsigned(orders.join(\":\"))\n}\n\nAfter subscribing to OB_L1_D1_SNAPSHOT for a currency pair, one snapshot of the order book for the currency pair will be sent. Thereafter, new snapshots will only be sent when there are updates to the given order book.
\nReplace D1 with the desired price level depth. Supported: D1, D5, D10, D20, D40, D80.
\nSample message feed:
\n{\n \"type\": \"OB_L1_D1_SNAPSHOT\",\n \"ps\": \"BTCUSDC\", // Currency pair symbol\n \"d\": { // Data\n \"lc\": 1644301604645, // Last Change\n \"a\": [ // Asks\n [\n \"45363\", // Price\n \"0.01102078\" // Total quantity at price level\n ],\n // Order book side will be truncated to specified depth\n ],\n \"b\": [ // Bids\n [\"45147\",\"0.011\"],\n ],\n }\n}\n\nSample message feed:
\n{\n \"type\": \"MARKET_SUMMARY_UPDATE\",\n \"currencyPairSymbol\": \"BTCUSDT\",\n \"data\": { \n \"currencyPair\": \"BTCUSDT\",\n \"askPrice\": \"297357\",\n \"bidPrice\": \"297205\",\n \"lastTradedPrice\": \"297161\",\n \"previousClosePrice\": \"296596\",\n \"baseVolume\": \"244.33584689486\",\n \"highPrice\": \"300180\",\n \"lowPrice\": \"281930\",\n \"created\": \"2022-11-14T08:30:26.037Z\",\n \"changeFromPrevious\": \"0.19\",\n \"markPrice\": \"297205\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"NEW_TRADE_BUCKET\",\n \"currencyPairSymbol\": \"BTCUSDT\",\n \"data\": {\n \"currencyPairSymbol\": \"BTCUSDT\",\n \"bucketPeriodInSeconds\": 60,\n \"startTime\": \"2019-04-25T19:41:00Z\",\n \"open\": \"9500\",\n \"high\": \"9500\",\n \"low\": \"9500\",\n \"close\": \"9500\",\n \"volume\": \"0\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"NEW_TRADE\",\n \"currencyPairSymbol\": \"BTCUSDT\",\n \"data\": {\n \"price\": \"9500\",\n \"quantity\": \"0.001\",\n \"currencyPair\": \"BTCUSDT\",\n \"tradedAt\": \"2019-04-25T19:51:55.393Z\",\n \"takerSide\": \"buy\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"MARK_PRICE_UPDATE\",\n \"currencyPairSymbol\": \"BTCUSDTPERP\",\n \"data\": {\n \"price\": \"33000\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"PNL_RUN_COMPLETED\",\n \"currencyPairSymbol\": \"BTCUSDTPERP\",\n \"data\": {\n \"price\": \"116048\"\n }\n}\n\nSample message feed:
\n{\n \"type\": \"FUNDING_RUN_COMPLETED\",\n \"currencyPairSymbol\": \"BTCUSDTPERP\"\n}\n\nSample message feed:
\n{\n \"type\": \"ALLOWED_ORDER_TYPES_UPDATED\",\n \"currencyPairSymbol\": \"BTCUSDT\",\n \"data\": [\n \"STOP_LOSS_LIMIT\",\n \"TAKE_PROFIT_LIMIT\",\n \"LIMIT\",\n \"LIMIT_POST_ONLY\",\n \"SIMPLE\",\n \"MARKET\"\n ]\n}\n\nWhen you are no longer interested in receiving messages for certain events on the Trade WebSocket connection, you can send a synthetic \"unsubscribe\" message. For example, if you want to unsubscribe from MARKET_SUMMARY_UPDATE event, you would send a message as follows:
{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"MARKET_SUMMARY_UPDATE\",\n \"pairs\": []\n }\n ]\n}\n\nHere, since the pairs array is empty, you will be unsubscribed from any existing subscriptions you might have had to any currency pair market updates.
\nThe WebSocket API is an advanced technology that makes it possible to open a two-way interactive communication session between a client and a server. With this API, you can send messages to a server and receive event-driven responses without having to poll the server for a reply.
\nPlease note that all unauthenticated WebSocket connections are automatically closed after 15 minutes regardless of activity.
\nYou can read more about WebSockets here.
\nImportant: All WebSocket rate limits are applied strictly per IP address. Using different API keys for multiple subaccounts or bots will not increase your throughput if they are connecting from the same IP address.\nMore details here: Rate Limiting
\nOur WebSocket API is accessible on the following address:
\n\nAccount WebSocket connection: In order to receive streaming updates about your VALR account, you would open up a WebSocket connection to
\n\nTrade WebSocket connection: In order to receive streaming updates about Trade data, you would open up a WebSocket connection to
\n\nThere are various WebSocket libraries that one can use to interact with our WebSocket API, depending on your choice of programming language and development framework. In NodeJS, you can use a popular library called ws for authentication, establishing a connection and to receive live updates.
\nYou can use the following command to install the ws package to your NodeJS project:
npm install ws
Once ws is installed, you can authenticate and establish a connection to our API with the following code:
const WebSocket = require('ws')\nvar headers = getAuthHeaders('/ws/account')\n// Authenticate and establish a connection\nconst ws = new WebSocket('wss://api.valr.com/ws/account', { headers })\nws.on('open', () => {\n // you can now start working with the connection\n})\nws.on('message', data => {\n // work with data\n})\nws.on('error', err => {\n // handle error\n})\nws.on('close', () => {\n // reconnect if needed\n})\n\nOnce authenticated, and the connection is established, the code above listens to the open, message, error and close events emitted from the server. The relevant payload will be available for each of these events. The one that is most interesting is the data payload on the message event. You will make use of this payload when receiving and working with live message updates.
Our WebSocket API requires authentication. To authenticate, add the following headers to the first call that establishes the WebSocket connection.
\nX-VALR-API-KEY: Your API Key
\nX-VALR-SIGNATURE: Generated signature. The signature is generated using the following parameters:
\nApi Secret
\nTimestamp of request
\nHTTP verb 'GET'
\nPath (either /ws/account or /ws/trade)
Request Body should be empty
\nX-VALR-TIMESTAMP: Timestamp of the request
\nLike this for Account WebSocket (in NodeJS):
const ws = new WebSocket('wss://api.valr.com/ws/account', { headers })
Or, if you want to connect to the Trade WebSocket, you would use the appropriate path:
const ws = new WebSocket('wss://api.valr.com/ws/trade', { headers })
The headers that are passed to establish the connection are the same 3 headers you pass to any authenticated call to the REST API. Here's how you would populate these headers:
\nfunction getAuthHeaders(path) {\n var headers = new Object()\n var timestamp = (new Date()).getTime()\n var signature = signRequest(apiKeySecret, timestamp, 'GET', path, '')\n headers['X-VALR-API-KEY'] = apiKey\n headers[\"X-VALR-SIGNATURE\"] = signature\n headers['X-VALR-TIMESTAMP'] = timestamp\n return headers\n}\n\nThe signRequest method is repeated below for your convenience:
const crypto = require(\"crypto\")\nfunction signRequest(apiKeySecret, timestamp, verb, path, body = \"\") {\n return crypto\n .createHmac(\"sha512\", apiKeySecret)\n .update(timestamp.toString())\n .update(verb.toUpperCase())\n .update(path)\n .update(body)\n .digest(\"hex\")\n}\n\nThe signRequest method requires the crypto package. You can use the following command to install the crypto package to your NodeJS project:
npm install crypto
In NodeJS, your code to establish an authenticated connection to our WebSocket API and start listening to message feeds would look like this:
\nconst crypto = require(\"crypto\")\nconst WebSocket = require(\"ws\")\nconst apiKey = \"yourapikey\"\nconst apiKeySecret = \"yourapikeysecret\"\nfunction signRequest(apiKeySecret, timestamp, verb, path, body = \"\") {\n return crypto\n .createHmac(\"sha512\", apiKeySecret)\n .update(timestamp.toString())\n .update(verb.toUpperCase())\n .update(path)\n .update(body)\n .digest(\"hex\")\n}\nfunction getAuthHeaders(path) {\n var headers = new Object()\n var timestamp = new Date().getTime()\n var signature = signRequest(apiKeySecret, timestamp, \"GET\", path, \"\")\n headers[\"X-VALR-API-KEY\"] = apiKey\n headers[\"X-VALR-SIGNATURE\"] = signature\n headers[\"X-VALR-TIMESTAMP\"] = timestamp\n return headers\n}\n// Account WebSocket connection\nfunction connectToAccount() {\n var headers = getAuthHeaders('/ws/account')\n const wsAccount = new WebSocket('wss://api.valr.com/ws/account', { headers })\n wsAccount.on(\"open\", () => {\n // you can now start working with the connection\n console.log(\"Account WS connected\");\n })\n wsAccount.on(\"message\", data => {\n // work with data\n })\n wsAccount.on(\"error\", err => {\n // handle error\n })\n wsAccount.on(\"close\", () => {\n // reconnect if needed\n })\n}\n// Trade WebSocket connection\nfunction connectToTrade() {\n var headers = getAuthHeaders(\"/ws/trade\")\n const wsTrade = new WebSocket('wss://api.valr.com/ws/trade', { headers })\n wsTrade.on(\"open\", () => {\n // you can now start working with the connection\n console.log('Trade WS connected')\n })\n wsTrade.on(\"message\", data => {\n // work with data\n })\n wsTrade.on(\"error\", err => {\n // handle error\n })\n wsTrade.on(\"close\", () => {\n // reconnect if needed\n })\n}\nconnectToAccount()\nconnectToTrade()\n\nOnce you open a connection to Account, you are automatically subscribed to all messages for all events on the Account WebSocket connection. You will start receiving message feeds pertaining to your VALR account. For example, you will receive messages when your balance is updated or when a new trade is executed on your account.
On the other hand, when you open a connection to Trade, in order to receive message feeds about trading data, you must subscribe to events you are interested in on the Trade WebSocket connection. For example, if you want to receive messages when markets fluctuate, you must send a message on the connection with the following payload:
var message = {\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"MARKET_SUMMARY_UPDATE\",\n \"pairs\": [\n \"BTCUSDT\"\n ]\n }\n ]\n} \nws.on('open', ()) => {\n // Once the connection is open, you subscribe to an event here\n ws.send(JSON.stringify(message))\n})\n\nHere, the event you are subscribing to is called MARKET_SUMMARY_UPDATE and the currency pairs you are subscribing to is an array.
\nWhen you are no longer interested in receiving messages for certain events on the Trade WebSocket connection, you can send a synthetic \"unsubscribe\" message. For example, if you want to unsubscribe from MARKET_SUMMARY_UPDATE event, you would send a message as follows:
{\n \"type\": \"SUBSCRIBE\",\n \"subscriptions\": [\n {\n \"event\": \"MARKET_SUMMARY_UPDATE\",\n \"pairs\": []\n }\n ]\n}\n\nHere, since the pairs array is empty, you will be unsubscribed from any existing subscriptions you might have had to any currency pair market updates.
\nTo ensure that you stay connected to either the Account or Trade WebSocket you must send a \"PING\" message every 30 seconds on the WebSocket you wish to monitor. VALR will respond with a PONG event. The message must be as follows:
{\n \"type\": \"PING\"\n}\n\nOn the Trade WebSocket the PONG message body will be \"NO_SUBSCRIPTIONS\" if you are not subscribed to any message types.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
This endpoint returns the APR rates for all available staking currencies.
\n","urlObject":{"path":["v1","staking","rates"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Set to “STAKE” to use Staking.
\n","type":"text/plain"},"key":"earnType","value":"STAKE"}],"variable":[]}},"response":[{"id":"78e95136-1e99-41bb-a046-618881d5a1d5","name":"Staking (Steady Returns) Rates","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v1/staking/rates"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"34"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 23 Oct 2025 09:03:15 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencySymbol\": \"AVAX\",\n \"rate\": \"0.000001106846\",\n \"apy\": \"0.0096\",\n \"periodIntervalMinutes\": 60,\n \"minimumStakeAmount\": \"0\",\n \"earnType\": \"STAKE\"\n },\n {\n \"currencySymbol\": \"SOL\",\n \"rate\": \"0.000000728722\",\n \"apy\": \"0.0063\",\n \"periodIntervalMinutes\": 60,\n \"minimumStakeAmount\": \"0\",\n \"earnType\": \"STAKE\"\n },\n {\n \"currencySymbol\": \"TRX\",\n \"rate\": \"0.000003424658\",\n \"apy\": \"0.03\",\n \"periodIntervalMinutes\": 60,\n \"minimumStakeAmount\": \"0\",\n \"earnType\": \"STAKE\"\n }\n]"}],"_postman_id":"3a89611f-722e-4f5c-863e-b653210d965b"},{"name":"Lock Amount","id":"d0c879cf-3886-4e77-8857-73bb04cb0f36","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Lock the specified currency to start earning yield.\nSubsequent calls to this endpoint for the same currency will increase the total locked amount by the provided value.
\nAn example is shown below.
\n{\n \"currencySymbol\": \"AVAX\",\n \"amount\": \"1\",\n \"earnType\": \"STAKE\"\n}\n\nYour API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Unlock the specified currency.
\nAn example is shown below.
\n{\n \"currencySymbol\": \"USDC\",\n \"amount\": \"1\",\n \"earnType\": \"STAKE\"\n}\n\nYour API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
This endpoint returns all currencies and their staked balances for the account making the request.
\n","urlObject":{"path":["v1","staking","balances"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Set to “STAKE” to use Staking.
\n","type":"text/plain"},"key":"earnType","value":"STAKE"}],"variable":[]}},"response":[{"id":"8773ff14-d355-46d0-a1a0-9a43c0405ef7","name":"Staking (Steady Returns) Balances","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v1/staking/balances"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"47"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 23 Oct 2025 08:37:13 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.00071\",\n \"earnType\": \"Stake\",\n \"lastUpdated\": \"2025-10-23T08:14:48.618Z\"\n }\n]"}],"_postman_id":"0f33eb13-1ec9-4326-92cb-b3736f509bed"},{"name":"Staking (Steady Returns) Balances for All Accounts","id":"af49575d-fc4c-4928-9eb7-05aed45be6b4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
This endpoint returns an array containing all staked amounts for all accounts. If an account has no staked funds, it will return an empty array for that account.
\n","urlObject":{"path":["v1","staking","balances","all"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Set to “STAKE” to use Staking.
\n","type":"text/plain"},"key":"earnType","value":"STAKE"}],"variable":[]}},"response":[{"id":"ecda7025-4edb-486e-9d96-0a1d43697c32","name":"Staking (Steady Returns) Balances for All Accounts","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v1/staking/balances/all"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"11"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 23 Oct 2025 08:58:53 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"accountLabel\": \"Primary\",\n \"accountPublicId\": \"0\",\n \"balances\": [\n {\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0\",\n \"earnType\": \"Stake\",\n \"lastUpdated\": \"2025-08-14T09:54:59.477Z\"\n }\n ]\n },\n {\n \"accountLabel\": \"Account A\",\n \"accountPublicId\": \"1430172985718059008\",\n \"balances\": []\n },\n {\n \"accountLabel\": \"Account B\",\n \"accountPublicId\": \"1422584982617878528\",\n \"balances\": []\n },\n {\n \"accountLabel\": \"Account C\",\n \"accountPublicId\": \"1422580726659538944\",\n \"balances\": []\n },\n {\n \"accountLabel\": \"Account D\",\n \"accountPublicId\": \"1394598136541048832\",\n \"balances\": [\n {\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0\",\n \"earnType\": \"Stake\",\n \"lastUpdated\": \"2025-08-14T10:30:01.560Z\"\n }\n ]\n },\n {\n \"accountLabel\": \"Account E\",\n \"accountPublicId\": \"1390305666164170752\",\n \"balances\": []\n },\n {\n \"accountLabel\": \"Account F\",\n \"accountPublicId\": \"1385226517613019136\",\n \"balances\": []\n },\n {\n \"accountLabel\": \"Account G\",\n \"accountPublicId\": \"1375033651151663104\",\n \"balances\": []\n },\n {\n \"accountLabel\": \"Account H\",\n \"accountPublicId\": \"1367068060819238912\",\n \"balances\": []\n },\n {\n \"accountLabel\": \"Account I\",\n \"accountPublicId\": \"1326908343235948544\",\n \"balances\": [\n {\n \"currencySymbol\": \"AVAX\",\n \"amount\": \"0\",\n \"earnType\": \"Stake\",\n \"lastUpdated\": \"2025-06-12T09:18:12.638Z\"\n }\n ]\n },\n {\n \"accountLabel\": \"Account J\",\n \"accountPublicId\": \"1306231494450782208\",\n \"balances\": [\n {\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.00071\",\n \"earnType\": \"Stake\",\n \"lastUpdated\": \"2025-10-23T08:14:48.618Z\"\n }\n ]\n }\n]"}],"_postman_id":"af49575d-fc4c-4928-9eb7-05aed45be6b4"},{"name":"Staking (Steady Returns) Rewards","id":"d0e67289-22ea-4c9d-a4ae-6df753e48604","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the latest reward items, up to a maximum of 100.
\n","urlObject":{"path":["v1","staking","rewards"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Fetch rewards for this currency.
\n","type":"text/plain"},"key":"currencySymbol","value":"SOL"},{"description":{"content":"Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"100"},{"description":{"content":"Set to “STAKE” to use Staking.
\n","type":"text/plain"},"key":"earnType","value":"STAKE"}],"variable":[]}},"response":[{"id":"15083150-b231-45d1-93f3-5cea62279607","name":"Staking (Steady Returns) Rewards","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/staking/rewards?currencySymbol=SOL&skip=0&limit=100","host":["https://api.valr.com"],"path":["v1","staking","rewards"],"query":[{"key":"currencySymbol","value":"SOL","description":"Fetch rewards for this currency."},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"18"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 23 Oct 2025 09:23:24 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"period\": \"2025-10-23T09:00:00Z\",\n \"rewardAmount\": \"0.00000000051739262\",\n \"rate\": \"0.000000728722\",\n \"ratePerYear\": \"0.638360648\",\n \"currencySymbol\": \"SOL\",\n \"earnType\": \"Stake\"\n }\n]"}],"_postman_id":"d0e67289-22ea-4c9d-a4ae-6df753e48604"},{"name":"Staking (Steady Returns) History","id":"5463281c-64e1-4a7c-95ac-e1e11430af7c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the latest history events, including locking and unlocking, up to a maximum of 100 entries.
\n","urlObject":{"path":["v1","staking","history"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Fetch the history for this currency.
\n","type":"text/plain"},"key":"currencySymbol","value":"SOL"},{"description":{"content":"Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"100"},{"description":{"content":"Set to “STAKE” to use Staking.
\n","type":"text/plain"},"key":"earnType","value":"STAKE"}],"variable":[]}},"response":[{"id":"473b03dc-f912-4460-a545-312905f5e7b3","name":"Staking (Steady Returns) History","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/staking/history?currencySymbol=SOL&skip=0&limit=100","host":["https://api.valr.com"],"path":["v1","staking","history"],"query":[{"key":"currencySymbol","value":"SOL","description":"Fetch the history for this currency."},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"43"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 23 Oct 2025 09:31:22 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"type\": \"UNSTAKE\",\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.00001\",\n \"earnType\": \"Stake\",\n \"completedAt\": \"2025-10-23T08:14:48.624467Z\"\n },\n {\n \"type\": \"UNSTAKE\",\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.00001\",\n \"earnType\": \"Stake\",\n \"completedAt\": \"2025-10-23T08:14:15.031285Z\"\n },\n {\n \"type\": \"UNSTAKE\",\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.00001\",\n \"earnType\": \"Stake\",\n \"completedAt\": \"2025-10-23T08:14:07.853665Z\"\n },\n {\n \"type\": \"STAKE\",\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.0001\",\n \"earnType\": \"Stake\",\n \"completedAt\": \"2025-10-23T08:12:14.046702Z\"\n },\n {\n \"type\": \"STAKE\",\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.0001\",\n \"earnType\": \"Stake\",\n \"completedAt\": \"2025-10-23T08:11:58.744128Z\"\n },\n {\n \"type\": \"STAKE\",\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.0001\",\n \"earnType\": \"Stake\",\n \"completedAt\": \"2025-10-23T08:11:07.838307Z\"\n },\n {\n \"type\": \"STAKE\",\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.0001\",\n \"earnType\": \"Stake\",\n \"completedAt\": \"2025-10-23T08:11:06.305754Z\"\n },\n {\n \"type\": \"STAKE\",\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.0001\",\n \"earnType\": \"Stake\",\n \"completedAt\": \"2025-10-23T08:11:05.014124Z\"\n },\n {\n \"type\": \"STAKE\",\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.0001\",\n \"earnType\": \"Stake\",\n \"completedAt\": \"2025-10-23T08:11:04.133787Z\"\n },\n {\n \"type\": \"STAKE\",\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.0001\",\n \"earnType\": \"Stake\",\n \"completedAt\": \"2025-10-23T08:11:02.039386Z\"\n },\n {\n \"type\": \"STAKE\",\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.00001\",\n \"earnType\": \"Stake\",\n \"completedAt\": \"2025-10-23T08:09:52.627271Z\"\n },\n {\n \"type\": \"STAKE\",\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.00001\",\n \"earnType\": \"Stake\",\n \"completedAt\": \"2025-10-23T08:09:49.622349Z\"\n },\n {\n \"type\": \"STAKE\",\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.00001\",\n \"earnType\": \"Stake\",\n \"completedAt\": \"2025-10-23T08:09:48.146141Z\"\n },\n {\n \"type\": \"STAKE\",\n \"currencySymbol\": \"SOL\",\n \"amount\": \"0.00001\",\n \"earnType\": \"Stake\",\n \"completedAt\": \"2025-10-23T08:09:43.167763Z\"\n }\n]"}],"_postman_id":"5463281c-64e1-4a7c-95ac-e1e11430af7c"}],"id":"dc9154df-16b9-43dd-ab22-54bffcc3ff09","description":"Make use of our Staking API to stake assets and manage your staking operations programmatically.
\nThese APIs are protected and will require authentication. See the section on Authentication above to learn how to authenticate your API calls. Managing staking activities require the Trade API key permission.
\nUsing the POST Lock Amount endpoint allows a user to stake a specified amount of currency to earn yield. The locked amount is deducted from the user’s available balance (not reserved) and moved into staking.
Using the POST Unlock Amount endpoint allows a user to reclaim previously staked funds, either partially or in full. Once unlocked, the amount is added back to the user’s available balance. Unlocking is typically immediate but may be delayed in rare cases.
The GET Staking Balances endpoint returns the user’s currently staked balances. This represents the amounts still locked in staking and eligible for unlocking. It does not provide a transaction history.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
This endpoint returns the rates for all available loan currencies.
\n","urlObject":{"path":["v1","staking","rates"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Set to \"LEND\" to use DeFi-Lending.
\n","type":"text/plain"},"key":"earnType","value":"LEND"}],"variable":[]}},"response":[{"id":"d75ca8e2-73c9-4078-a024-cecaffdb0f3b","name":"DeFi Rates","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/staking/rates?earnType=LEND","host":["https://api.valr.com"],"path":["v1","staking","rates"],"query":[{"key":"earnType","value":"LEND","description":"Set to \"LEND\" to use DeFi-Lending."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"10"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 23 Oct 2025 09:03:50 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencySymbol\": \"ETH\",\n \"rate\": \"0.000001712329\",\n \"apy\": \"0.015\",\n \"periodIntervalMinutes\": 60,\n \"minimumStakeAmount\": \"0\",\n \"earnType\": \"LEND\"\n },\n {\n \"currencySymbol\": \"USDT\",\n \"rate\": \"0.000089893914\",\n \"apy\": \"0.7874\",\n \"periodIntervalMinutes\": 60,\n \"minimumStakeAmount\": \"0\",\n \"earnType\": \"LEND\"\n }\n]"}],"_postman_id":"57f39080-6f40-46ba-b7c0-35b1e3734b2f"},{"name":"Lock Amount","id":"b8c4b541-0bc0-407b-a543-40eecace8af2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Lock the specified currency to start earning yield.
Subsequent calls to this endpoint for the same currency will increase the total locked amount by the provided value.
An example is shown below.
\n{\n \"currencySymbol\": \"AVAX\",\n \"amount\": \"1\",\n \"earnType\": \"LEND\"\n}\n\nYour API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Unlock the specified currency.
\nAn example is shown below.
\n{\n \"currencySymbol\": \"USDC\",\n \"amount\": \"1\",\n \"earnType\": \"LEND\"\n}\n\nYour API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
This endpoint returns all currencies and their loaned amounts for the account making the request.
\n","urlObject":{"path":["v1","staking","balances"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Set to \"LEND\" to use DeFi-Lending.
\n","type":"text/plain"},"key":"earnType","value":"LEND"}],"variable":[]}},"response":[{"id":"1c8551af-4d34-49ec-97e7-b79e81a2985f","name":"DeFi Balances","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/staking/balances?earnType=LEND","host":["https://api.valr.com"],"path":["v1","staking","balances"],"query":[{"key":"earnType","value":"LEND","description":"Set to \"LEND\" to use DeFi-Lending."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"7"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 23 Oct 2025 08:38:37 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencySymbol\": \"USDT\",\n \"amount\": \"10\",\n \"earnType\": \"Lend\",\n \"lastUpdated\": \"2025-10-23T08:27:09.265Z\"\n }\n]"}],"_postman_id":"063ad4cc-a532-4b30-adbb-13348108cfc8"},{"name":"DeFi Balances for All Accounts","id":"2aa37167-3fe4-41f7-8049-f1bccfaf8454","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
This endpoint returns an array of all loaned amounts for all accounts. Accounts with no loans will have an empty array.
\n","urlObject":{"path":["v1","staking","balances","all"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Set to \"LEND\" to use DeFi-Lending.
\n","type":"text/plain"},"key":"earnType","value":"LEND"}],"variable":[]}},"response":[{"id":"16a5244f-4142-4794-b740-f853b11bf0cf","name":"DeFi Balances for All Accounts","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/staking/balances/all?earnType=LEND","host":["https://api.valr.com"],"path":["v1","staking","balances","all"],"query":[{"key":"earnType","value":"LEND","description":"Set to \"LEND\" to use DeFi-Lending."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"32"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 23 Oct 2025 08:58:13 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"accountLabel\": \"Primary\",\n \"accountPublicId\": \"0\",\n \"balances\": [\n {\n \"currencySymbol\": \"ETH\",\n \"amount\": \"0\",\n \"earnType\": \"Lend\",\n \"lastUpdated\": \"2025-08-14T12:23:57.942Z\"\n },\n {\n \"currencySymbol\": \"USDT\",\n \"amount\": \"0\",\n \"earnType\": \"Lend\",\n \"lastUpdated\": \"2025-08-15T07:12:18.244Z\"\n }\n ]\n },\n {\n \"accountLabel\": \"Account A\",\n \"accountPublicId\": \"1430172985718059008\",\n \"balances\": []\n },\n {\n \"accountLabel\": \"Account B\",\n \"accountPublicId\": \"1422584982617878528\",\n \"balances\": []\n },\n {\n \"accountLabel\": \"Account C\",\n \"accountPublicId\": \"1422580726659538944\",\n \"balances\": []\n },\n {\n \"accountLabel\": \"Account D\",\n \"accountPublicId\": \"1394598136541048832\",\n \"balances\": [\n {\n \"currencySymbol\": \"ETH\",\n \"amount\": \"3.5\",\n \"earnType\": \"Lend\",\n \"lastUpdated\": \"2025-08-14T12:51:01.771Z\"\n },\n {\n \"currencySymbol\": \"USDT\",\n \"amount\": \"0\",\n \"earnType\": \"Lend\",\n \"lastUpdated\": \"2025-08-14T09:59:21.217Z\"\n }\n ]\n },\n {\n \"accountLabel\": \"Account E\",\n \"accountPublicId\": \"1390305666164170752\",\n \"balances\": []\n },\n {\n \"accountLabel\": \"Account F\",\n \"accountPublicId\": \"1385226517613019136\",\n \"balances\": []\n },\n {\n \"accountLabel\": \"Account G\",\n \"accountPublicId\": \"1375033651151663104\",\n \"balances\": []\n },\n {\n \"accountLabel\": \"Account H\",\n \"accountPublicId\": \"1367068060819238912\",\n \"balances\": []\n },\n {\n \"accountLabel\": \"Account I\",\n \"accountPublicId\": \"1326908343235948544\",\n \"balances\": [\n {\n \"currencySymbol\": \"USDT\",\n \"amount\": \"0\",\n \"earnType\": \"Lend\",\n \"lastUpdated\": \"2025-06-12T09:18:25.338Z\"\n }\n ]\n },\n {\n \"accountLabel\": \"Account J\",\n \"accountPublicId\": \"1306231494450782208\",\n \"balances\": [\n {\n \"currencySymbol\": \"USDT\",\n \"amount\": \"10\",\n \"earnType\": \"Lend\",\n \"lastUpdated\": \"2025-10-23T08:27:09.265Z\"\n }\n ]\n }\n]"}],"_postman_id":"2aa37167-3fe4-41f7-8049-f1bccfaf8454"},{"name":"DeFi Rewards","id":"f59a544d-e09c-4e15-ab8b-daf50387880f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the latest reward items, up to a maximum of 100.
\n","urlObject":{"path":["v1","staking","rewards"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Fetch the rewards for this currency.
\n","type":"text/plain"},"key":"currencySymbol","value":"ETH"},{"description":{"content":"Set to \"LEND\" to use DeFi-Lending.
\n","type":"text/plain"},"key":"earnType","value":"LEND"},{"description":{"content":"Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"100"}],"variable":[]}},"response":[{"id":"247bf13a-4c04-42c6-8b03-a1e16019fe08","name":"DeFi Rewards","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/staking/rewards?currencySymbol=ETH&earnType=LEND&skip=0&limit=100","host":["https://api.valr.com"],"path":["v1","staking","rewards"],"query":[{"key":"currencySymbol","value":"ETH","description":"Fetch the rewards for this currency."},{"key":"earnType","value":"LEND","description":"Set to \"LEND\" to use DeFi-Lending."},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"21"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 23 Oct 2025 09:24:33 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"period\": \"2025-08-14T09:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-14T08:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-14T07:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-14T06:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-14T05:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-14T04:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-14T03:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-14T02:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-14T01:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-14T00:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-13T23:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-13T22:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-13T21:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-13T20:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-13T19:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-13T18:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-13T17:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-13T16:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-13T15:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-13T14:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n },\n {\n \"period\": \"2025-08-13T13:00:00Z\",\n \"rewardAmount\": \"0.0000119929810831\",\n \"rate\": \"0.000001712329\",\n \"ratePerYear\": \"1.5\",\n \"currencySymbol\": \"ETH\",\n \"earnType\": \"Lend\"\n }\n]"}],"_postman_id":"f59a544d-e09c-4e15-ab8b-daf50387880f"},{"name":"DeFi History","id":"f029a648-07e9-4852-8553-4c2e178e0058","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the latest history events, including locking and unlocking, up to a maximum of 100 entries.
\n","urlObject":{"path":["v1","staking","history"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Fetch the latest history for this currency.
\n","type":"text/plain"},"key":"currencySymbol","value":"USDT"},{"description":{"content":"Set to \"LEND\" to use DeFi-Lending.
\n","type":"text/plain"},"key":"earnType","value":"LEND"},{"description":{"content":"Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"100"}],"variable":[]}},"response":[{"id":"f1fe94a2-735e-4f5a-878b-edad64578bc2","name":"DeFi History","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/staking/history?currencySymbol=USDT&earnType=LEND&skip=0&limit=100","host":["https://api.valr.com"],"path":["v1","staking","history"],"query":[{"key":"currencySymbol","value":"USDT","description":"Fetch the latest history for this currency."},{"key":"earnType","value":"LEND","description":"Set to \"LEND\" to use DeFi-Lending."},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"12"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 23 Oct 2025 09:31:56 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"type\": \"UNSTAKE\",\n \"currencySymbol\": \"USDT\",\n \"amount\": \"10\",\n \"earnType\": \"Lend\",\n \"completedAt\": \"2025-10-23T08:27:09.272242Z\"\n },\n {\n \"type\": \"STAKE\",\n \"currencySymbol\": \"USDT\",\n \"amount\": \"10\",\n \"earnType\": \"Lend\",\n \"completedAt\": \"2025-10-23T08:25:35.740674Z\"\n },\n {\n \"type\": \"STAKE\",\n \"currencySymbol\": \"USDT\",\n \"amount\": \"10\",\n \"earnType\": \"Lend\",\n \"completedAt\": \"2025-08-13T11:21:14.893037Z\"\n },\n {\n \"type\": \"UNSTAKE\",\n \"currencySymbol\": \"USDT\",\n \"amount\": \"11\",\n \"earnType\": \"Lend\",\n \"completedAt\": \"2025-08-13T11:21:08.027604Z\"\n },\n {\n \"type\": \"STAKE\",\n \"currencySymbol\": \"USDT\",\n \"amount\": \"11\",\n \"earnType\": \"Lend\",\n \"completedAt\": \"2025-08-13T11:18:10.199343Z\"\n }\n]"}],"_postman_id":"f029a648-07e9-4852-8553-4c2e178e0058"}],"id":"2b8c7fa6-8502-4fcb-b906-2db7f8023f84","description":"Make use of our DeFi-Lending API to supply liquidity, borrow assets, and manage your decentralized lending positions programmatically.
\nThese APIs are protected and will require authentication. See the section on Authentication above to learn how to authenticate your API calls. Managing DeFi lending activities require the Trade API key permission.
\nUsing the POST Lock Amount endpoint allows a user to lend a specified amount of currency to earn yield. The locked amount is deducted from the user’s available balance (not reserved) and moved into the DeFi-Lending section.
Using the POST Unlock Amount endpoint allows a user to reclaim previously loaned funds, either partially or in full. Once unlocked, the amount is added back to the user’s available balance. Unlocking is typically immediate but may be delayed in rare cases.
The GET DeFi Balances endpoint returns the user’s currently lent out balances. This represents the amounts still locked in lending and eligible for unlocking. It does not provide a transaction history.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the history of interest entries:
\nInterest Auction
\nAt the start of every hour, our interest engine calculates the total borrow demand for each coin across all users. It then runs an auction by sorting lending offers by minimum rate and selecting the marginal rate that satisfies the total borrowing demand. All lenders receive the same lending rate, which is the highest rate among the loan offers utilised to meet the full borrow demand.
\n","urlObject":{"path":["v1","loans","rates"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"f80b6eb8-6899-478e-adcf-583c191c80e6","name":"Previous and Next Rates","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v1/loans/rates"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 08 Mar 2024 06:47:24 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"96"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"n/a"},{"key":"Via","value":"1.1 google"},{"key":"Cache-Control","value":"max-age=60,public"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currency\": \"ZAR\",\n \"previousFundingRate\": 0.00001256,\n \"estimatedNextRate\": 0.00001427,\n \"estimatedNextBorrowRate\": \"0.000017124\"\n },\n {\n \"currency\": \"BTC\",\n \"previousFundingRate\": 0.00000571,\n \"estimatedNextRate\": 0.00000685,\n \"estimatedNextBorrowRate\": \"0.00000822\"\n },\n {\n \"currency\": \"ETH\",\n \"previousFundingRate\": 0.00000761,\n \"estimatedNextRate\": 0.00000761,\n \"estimatedNextBorrowRate\": \"0.000009132\"\n },\n {\n \"currency\": \"USDT\",\n \"previousFundingRate\": 0.00001027,\n \"estimatedNextRate\": 0.00001027,\n \"estimatedNextBorrowRate\": \"0.000012324\"\n },\n {\n \"currency\": \"USDC\",\n \"previousFundingRate\": 0.00000571,\n \"estimatedNextRate\": 0.00000571,\n \"estimatedNextBorrowRate\": \"0.000006852\"\n }\n]"}],"_postman_id":"f32d3008-f7cb-463a-a16c-2a8d8973fed1"},{"name":"Lending Rates History","id":"052442bb-21ca-4b44-a40e-1aa4ef36cee9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns rate history and loan book utilisation from previous auctions:
\n","urlObject":{"path":["v1","loans","rates","history"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Fetch the loan history for the currency.
\n","type":"text/plain"},"key":"currencySymbol","value":"ZAR"},{"disabled":true,"description":{"content":"(Optional) - Include only transactions after this ISO 8601 start time. Date range should not exceed 31 days. Defaults to 31 days.
\n","type":"text/plain"},"key":"startTime","value":"2025-05-01T01:02:23.000Z"},{"disabled":true,"description":{"content":"(Optional) - Include only transactions before this ISO 8601 end time. Date range should not exceed 31 days. Defaults to 31 days.
\n","type":"text/plain"},"key":"endTime","value":"2025-05-06T21:59:59.999Z"},{"disabled":true,"description":{"content":"Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"disabled":true,"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"10"}],"variable":[]}},"response":[{"id":"9d05f80b-3000-431a-8604-0a34aeacd237","name":"Lending Rates History","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/loans/rates/history?currencySymbol=ZAR","host":["https://api.valr.com"],"path":["v1","loans","rates","history"],"query":[{"key":"currencySymbol","value":"ZAR","description":"Fetch the loan history for the currency."},{"key":"startTime","value":"2025-05-01T01:02:23.000Z","description":"(Optional) - Include only transactions after this ISO 8601 start time. Date range should not exceed 31 days. Defaults to 31 days.","disabled":true},{"key":"endTime","value":"2025-05-06T21:59:59.999Z","description":"(Optional) - Include only transactions before this ISO 8601 end time. Date range should not exceed 31 days. Defaults to 31 days.","disabled":true},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)","disabled":true},{"key":"limit","value":"10","description":"Limit the results to this number. (Default and Max 100)","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 09 May 2025 10:51:56 GMT"},{"key":"cache-control","value":"max-age=60,public"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"4"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currency\": \"ZAR\",\n \"lendingRate\": \"0.0000114\",\n \"createdAt\": 1746784800002,\n \"utilization\": \"6.7\",\n \"borrowerRate\": \"0.00001368\"\n },\n {\n \"currency\": \"ZAR\",\n \"lendingRate\": \"0.0000114\",\n \"createdAt\": 1746781200001,\n \"utilization\": \"6.7\",\n \"borrowerRate\": \"0.00001368\"\n },\n {\n \"currency\": \"ZAR\",\n \"lendingRate\": \"0.0000114\",\n \"createdAt\": 1746777600001,\n \"utilization\": \"6.9\",\n \"borrowerRate\": \"0.00001368\"\n },\n {\n \"currency\": \"ZAR\",\n \"lendingRate\": \"0.0000114\",\n \"createdAt\": 1746774000001,\n \"utilization\": \"6.9\",\n \"borrowerRate\": \"0.00001368\"\n },\n {\n \"currency\": \"ZAR\",\n \"lendingRate\": \"0.0000114\",\n \"createdAt\": 1746770400001,\n \"utilization\": \"6.9\",\n \"borrowerRate\": \"0.00001368\"\n }\n]"},{"id":"fcb25d7b-869f-4cce-80e7-86c61f5785ff","name":"currencySymbol not specified","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/loans/rates/history","host":["https://api.valr.com"],"path":["v1","loans","rates","history"],"query":[{"key":"currencySymbol","value":"ZAR","description":"The symbol of the currency whose loan history you want to view.","disabled":true},{"key":"startTime","value":"2025-05-01T01:02:23.000Z","description":"(Optional) - Include only transactions after this ISO 8601 start time. Date range should not exceed 31 days. Defaults to 31 days.","disabled":true},{"key":"endTime","value":"2025-05-06T21:59:59.999Z","description":"(Optional) - Include only transactions before this ISO 8601 end time. Date range should not exceed 31 days. Defaults to 31 days.","disabled":true},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)","disabled":true},{"key":"limit","value":"10","description":"Limit the results to this number. (Default and Max 100)","disabled":true}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 09 May 2025 10:52:23 GMT"},{"key":"cache-control","value":"no-cache"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"1"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -11,\n \"message\": \"Invalid Request, please check your request and try again\",\n \"validationErrors\": {\n \"errors\": [\n {\n \"field\": \"currencySymbol\",\n \"message\": \"currencySymbol must be specified\"\n }\n ]\n }\n}"}],"_postman_id":"052442bb-21ca-4b44-a40e-1aa4ef36cee9"},{"name":"New Loan","id":"100e3d1e-9990-4933-83d8-84c085bcb956","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Create a new loan offer for an account:
\nLoan offers are prioritised from the lowest to highest interest rate, with FIFO applied for offers at the same rate.
\nIf your loan offer is utilised, you will earn the prevailing hourly rate, which is the higher of your specified hourlyRate and the marginal highest hourlyRate determined by the loan auction each hour.
\n","urlObject":{"path":["v1","loans"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"c786b4b0-7c25-4107-8794-2af13c902a69","name":"New Loan","originalRequest":{"method":"POST","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"currencySymbol\": \"USDC\",\n \"hourlyRate\": \"0.00001255\",\n \"amount\": \"100\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.valr.com/v1/loans"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 27 Sep 2024 02:47:34 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"20"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"1289055810346737664\"\n}"}],"_postman_id":"100e3d1e-9990-4933-83d8-84c085bcb956"},{"name":"Adjust Loan Amount","id":"9f52aa95-955a-4d80-954d-60476b46109b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Amends a specific loan offer by increasing the amount:
\nThis endpoint requires specifying the additional amount to be offered. Note that the increaseLoanAmountBy field does not represent the total amount to which a user wishes to increase the loan.
The decimal places in increaseLoanAmountBy are limited to the withdrawalDecimalPlaces of the offered currency, up to a maximum of four.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Updates a loan by modifying its minimum interest rate:
\n","urlObject":{"path":["v1","loans","rate"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"659ce116-2d7a-4105-b47e-768779b1a31f","name":"Edit Loan Rate","originalRequest":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"currencySymbol\": \"USDC\",\n \"hourlyRate\": \"0.0000126\",\n \"loanId\": \"1289055810346737664\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.valr.com/v1/loans/rate"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 27 Sep 2024 02:51:01 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"12"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"27a1a97c-29f1-48d0-92d5-462c8aba6005"},{"name":"Request Loan Unlock","id":"41bdd85c-7463-437b-a68b-f278f950cc33","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Removes a loan offer or reduces its amount:
\nLoan offer unlocking may take at least one hour, depending on current fund usage and availability to replace the requested offer.
\n","urlObject":{"path":["v1","loans","unlock"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"fc833e5c-39b7-4c39-b716-bfd83de222e6","name":"Request Loan Unlock","originalRequest":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"currencySymbol\": \"USDC\",\n \"unlockAmount\": \"50\",\n \"loanId\": \"1289055810346737664\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.valr.com/v1/loans/unlock"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 27 Sep 2024 02:51:49 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"28"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"41bdd85c-7463-437b-a68b-f278f950cc33"},{"name":"Remove Unlock Request","id":"05c319b4-72b1-44e4-90dd-fa0adfa38637","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Cancels a pending unlock request for a loan:
\n","urlObject":{"path":["v1","loans","unlock"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"a701e0eb-8100-40f7-aaf0-99b896c6d3ac","name":"Remove Unlock Request (Bad Request)","originalRequest":{"method":"DELETE","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"currencySymbol\": \"USDC\",\n \"loanId\": \"1289055810346737664\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.valr.com/v1/loans/unlock"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 27 Sep 2024 02:52:17 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"8"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -19236,\n \"message\": \"Cancel Loan unlock request not processed, no existing unlock requested\"\n}"}],"_postman_id":"05c319b4-72b1-44e4-90dd-fa0adfa38637"},{"name":"Open Loans","id":"a017a93e-ebab-485b-861b-9a0254b4cc78","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Retrieves all loans offered by the account:
\n","urlObject":{"path":["v1","loans","open"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"89baf8e2-d61d-4c18-878c-0bf94e273da5","name":"Open Loans","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v1/loans/open"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 27 Sep 2024 02:48:48 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"11"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"loanId\": \"1289055810346737664\",\n \"currency\": \"USDC\",\n \"totalAmount\": \"100\",\n \"usedAmount\": \"0\",\n \"hourlyRate\": \"0.00001255\",\n \"createdAt\": \"2024-09-27T02:47:34.671Z\",\n \"updatedAt\": \"2024-09-27T02:47:34.671Z\"\n }\n]"}],"_postman_id":"a017a93e-ebab-485b-861b-9a0254b4cc78"},{"name":"Interest Earned","id":"f4078c47-50e2-4ea2-bf07-9e91c4fec9db","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns history of interest entries:
\n","urlObject":{"path":["v1","loans","credit-history"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Fetch interest entries for the currency.
\n","type":"text/plain"},"key":"currencySymbol","value":"USDC"},{"disabled":true,"description":{"content":"Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"disabled":true,"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"100"},{"disabled":true,"description":{"content":"(Optional) - Include only transactions after this ISO 8601 start time. Date range should not exceed 31 days. Defaults to 31 days.
\n","type":"text/plain"},"key":"startTime","value":"2024-09-20T01:02:23.000Z"},{"disabled":true,"description":{"content":"(Optional) - Include only transactions before this ISO 8601 end time. Date range should not exceed 31 days. Defaults to 31 days.
\n","type":"text/plain"},"key":"endTime","value":"2024-10-01T21:59:59.999Z"}],"variable":[]}},"response":[{"id":"399ef634-354e-413b-81e6-f1ec55b6faf3","name":"Interest Earned","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/loans/credit-history?currencySymbol=USDC","host":["https://api.valr.com"],"path":["v1","loans","credit-history"],"query":[{"key":"currencySymbol","value":"USDC","description":"Fetch interest entries for the currency."},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)","disabled":true},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)","disabled":true},{"key":"startTime","value":"2024-09-20T01:02:23.000Z","description":"Include only transactions after this ISO 8601 start time","disabled":true},{"key":"endTime","value":"2024-10-01T21:59:59.999Z","description":"Include only transactions before this ISO 8601 end time","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 16 Oct 2024 11:55:56 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"21"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00004567\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-14T14:00:00.322193Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-09T13:00:00.322054Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-09T12:00:00.324052Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-09T11:00:00.322889Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-09T10:00:00.321991Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-09T09:00:00.321771Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-09T08:00:00.322223Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-09T07:00:00.321873Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-09T06:00:00.321909Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-09T05:00:00.321887Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-09T04:00:00.321789Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-09T03:00:00.321734Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-09T02:00:00.322063Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-09T01:00:00.321779Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-09T00:00:00.321956Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T23:00:00.321784Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T22:00:00.322585Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T21:00:00.321824Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T20:00:00.322027Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T19:00:00.321799Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T18:00:00.321844Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T17:00:00.321762Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T16:00:00.322220Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T15:00:00.322051Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T14:00:00.322015Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T13:00:00.321854Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T12:00:00.322105Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T11:00:00.322048Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T10:00:00.321876Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T09:00:00.322071Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T08:00:00.323504Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T07:00:00.321900Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T06:00:00.322685Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T05:00:00.323035Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T04:00:00.321759Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T03:00:00.321788Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T02:00:00.321824Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T01:00:00.321683Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-08T00:00:00.321780Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T23:00:00.321713Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T22:00:00.321785Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T21:00:00.321636Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T20:00:00.322045Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T19:00:00.322037Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T18:00:00.321951Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T17:00:00.322135Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T16:00:00.321760Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T15:00:00.324037Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T14:00:00.322061Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T13:00:00.321757Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T12:00:00.325485Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T11:00:00.321835Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T10:00:00.321771Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T09:00:00.321839Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T08:00:00.321778Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T07:00:00.321737Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T06:00:00.327626Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T05:00:00.321837Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T04:00:00.322253Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T03:00:00.323806Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T02:00:00.321904Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T01:00:00.321668Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-07T00:00:00.322547Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T23:00:00.321745Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T22:00:00.321687Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T21:00:00.322453Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T20:00:00.322046Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T19:00:00.321709Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T18:00:00.321775Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T17:00:00.321756Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T16:00:00.322897Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T15:00:00.322228Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T14:00:00.321858Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T13:00:00.321779Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T12:00:00.322266Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T11:00:00.321889Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T10:00:00.322309Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T09:00:00.321778Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T08:00:00.321693Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T07:00:00.321674Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T06:00:00.321729Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T05:00:00.321696Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T04:00:00.321924Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T03:00:00.321688Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T02:00:00.321800Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T01:00:00.322003Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-06T00:00:00.321990Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-05T23:00:00.321697Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-05T22:00:00.322234Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-05T21:00:00.322910Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-05T20:00:00.321714Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-05T19:00:00.321961Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-05T18:00:00.322049Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-05T17:00:00.322112Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-05T16:00:00.321793Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-05T15:00:00.321764Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-05T14:00:00.321940Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-05T13:00:00.321674Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-05T12:00:00.321721Z\"\n },\n {\n \"currency\": \"USDC\",\n \"interestAmount\": \"0.00001142\",\n \"quantity\": \"10\",\n \"createdAt\": \"2024-10-05T11:00:00.321803Z\"\n }\n]"}],"_postman_id":"f4078c47-50e2-4ea2-bf07-9e91c4fec9db"},{"name":"Loan Update History","id":"70f2ca80-660c-47fd-9be5-35022da2d495","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns historical updates to loan offers, including creations and changes to rates or amounts.
\n","urlObject":{"path":["v1","loans","update-history"],"host":["https://api.valr.com"],"query":[{"description":{"content":"Fetch the historical updates for the currency.
\n","type":"text/plain"},"key":"currencySymbol","value":"USDC"},{"disabled":true,"description":{"content":"Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"disabled":true,"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"100"},{"disabled":true,"description":{"content":"(Optional) - Include only transactions after this ISO 8601 start time. Date range should not exceed 31 days. Defaults to 31 days.
\n","type":"text/plain"},"key":"startTime","value":"2024-09-27T01:02:23.000Z"},{"disabled":true,"description":{"content":"(Optional) - Include only transactions before this ISO 8601 end time. Date range should not exceed 31 days. Defaults to 31 days.
\n","type":"text/plain"},"key":"endTime","value":"2024-10-08T00:00:00.000Z"}],"variable":[]}},"response":[{"id":"dbb0b40e-84f2-4b85-b1dd-a9e08803e224","name":"Loan Update History","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/loans/update-history?currencySymbol=USDC","host":["https://api.valr.com"],"path":["v1","loans","update-history"],"query":[{"key":"currencySymbol","value":"USDC","description":"Fetch the historical updates for the currency."},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)","disabled":true},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)","disabled":true},{"key":"startTime","value":"2024-09-20T01:02:23.000Z","description":"Include only transactions after this ISO 8601 start time","disabled":true},{"key":"endTime","value":"2024-10-01T21:59:59.999Z","description":"Include only transactions before this ISO 8601 end time","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Mon, 30 Sep 2024 07:40:34 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"150"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"loanId\": \"1289055810346737664\",\n \"currency\": \"USDC\",\n \"totalAmount\": \"70\",\n \"availableAmount\": \"70\",\n \"usedAmount\": \"0\",\n \"hourlyRate\": \"0.0000126\",\n \"createdAt\": 1727405254671,\n \"updatedAt\": 1727405509168,\n \"loanHistoryUpdateType\": \"REDUCE\"\n },\n {\n \"loanId\": \"1289055810346737664\",\n \"currency\": \"USDC\",\n \"totalAmount\": \"120\",\n \"availableAmount\": \"120\",\n \"usedAmount\": \"0\",\n \"hourlyRate\": \"0.0000126\",\n \"createdAt\": 1727405254671,\n \"updatedAt\": 1727405379325,\n \"loanHistoryUpdateType\": \"RATE_CHANGE\"\n },\n {\n \"loanId\": \"1289055810346737664\",\n \"currency\": \"USDC\",\n \"totalAmount\": \"120\",\n \"availableAmount\": \"120\",\n \"usedAmount\": \"0\",\n \"hourlyRate\": \"0.00001255\",\n \"createdAt\": 1727405254671,\n \"updatedAt\": 1727405379325,\n \"loanHistoryUpdateType\": \"INCREASE\"\n },\n {\n \"loanId\": \"1289055810346737664\",\n \"currency\": \"USDC\",\n \"totalAmount\": \"100\",\n \"availableAmount\": \"100\",\n \"usedAmount\": \"0\",\n \"hourlyRate\": \"0.00001255\",\n \"createdAt\": 1727405254671,\n \"updatedAt\": 1727405254671,\n \"loanHistoryUpdateType\": \"NEW\"\n }\n]"}],"_postman_id":"70f2ca80-660c-47fd-9be5-35022da2d495"}],"id":"8795b188-acb7-4fec-95a4-089a3f4acf89","description":"Make use of our Lending API to lend and manage your loans programmatically.
\nThese APIs are protected and will require authentication. See the section on Authentication above to learn how to authenticate your API calls. Managing your loans require the Trade API key permission.
\nUsing the POST New Loan endpoint allows a user to lend a specified amount of currency to earn yield. Available balances remain unchanged upon placement of a lending offer. Funds are deducted from the available balance and classified as reserved only when they are borrowed by another user.
Using the PUT Request Loan Unlock endpoint allows a user to reclaim previously loaned funds, either partially or in full. Once unlocked, the amount is moved back to the available balance section.
Unlocking is immediate only if the loaned amount has not been utilised by another user. If the loaned amount is in use, the unlock request will be processed at the next hourly auction cycle.
The GET Open Loans endpoint returns the user’s currently lent-out balances. This represents the amounts still locked in lending and eligible for unlocking. It does not provide a transaction history.
Introduction to Lending - VALR Support
\n","_postman_id":"8795b188-acb7-4fec-95a4-089a3f4acf89"}],"id":"5f3143b5-3a30-4a74-bf11-be3a2347579a","description":"Make use of our Earn APIs to earn yield on VALR.
\nVALR offers three ways to earn crypto/fiat: Staking, DeFi Lending, and Lending.
\nRewards are distributed hourly, and balances can be locked or unlocked at any time, provided there is sufficient liquidity to allow unlocking.
\nThese APIs are protected and will require authentication. See the section on Authentication above to learn how to authenticate your API calls. Managing Earn activities require the Trade API key permission.
\n","_postman_id":"5f3143b5-3a30-4a74-bf11-be3a2347579a"},{"name":"Margin","item":[{"name":"Account Margin Information V1","id":"6d3c8fcd-7e7f-42b0-bb49-3aca91e77f76","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the following margining information for an account:
\n","urlObject":{"path":["v1","margin","status"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"d1b9ad9b-4126-455c-aa90-fe6101db61d7","name":"Account Margin Information (No Leveraged Positions)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v1/margin/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Mon, 13 Nov 2023 11:05:09 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"7"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"initialMarginFraction\": \"0.2\",\n \"totalBorrowedInReference\": \"0\",\n \"collateralisedBalancesInReference\": \"0\",\n \"referenceCurrency\": \"USDC\",\n \"initialRequiredInReference\": \"0\",\n \"availableInReference\": \"0\",\n \"maintenanceMarginFraction\": \"0.1\",\n \"autoCloseMarginFraction\": \"0.033333333\",\n \"totalPositionsAtEntryInReference\": \"0\",\n \"totalUnrealisedFuturesPnlInReference\": \"0\"\n}"},{"id":"b56cbeea-0231-49ee-9916-9a36a057d3a0","name":"Account Margin Information (With Leveraged Positions)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v1/margin/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 08 May 2024 11:31:54 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"4"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"marginFraction\": \"0.10710575\",\n \"collateralisedMarginFraction\": \"0.10398192\",\n \"initialMarginFraction\": \"0.10032321\",\n \"totalBorrowedInReference\": \"20065.42292\",\n \"collateralisedBalancesInReference\": \"2013.1832234925416\",\n \"referenceCurrency\": \"USDC\",\n \"initialRequiredInReference\": \"2013.027732\",\n \"availableInReference\": \"62.6810773874584\",\n \"maintenanceMarginFraction\": \"0.050161607\",\n \"autoCloseMarginFraction\": \"0.010075417\",\n \"leverageMultiple\": 9.34,\n \"totalPositionsAtEntryInReference\": \"20065.42292\",\n \"totalUnrealisedFuturesPnlInReference\": \"73.2578\",\n \"defaultInitialMarginFraction\": \"0.2\",\n \"defaultMaintenanceMarginFraction\": \"0.1\",\n \"defaultAutoCloseMarginFraction\": \"0.033333333\"\n}"}],"_postman_id":"6d3c8fcd-7e7f-42b0-bb49-3aca91e77f76"},{"name":"Account Margin Information V2","id":"42a124a5-8846-4d78-bd81-ebf0095602b6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the following margining information for an account:
\n","urlObject":{"path":["v2","margin","status"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"fcccbf1a-d74f-4e5f-87c5-3c1a03db1583","name":"Account Margin Information for account with no margin trades","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v2/margin/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 08 Nov 2023 13:19:24 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"1"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"initialMarginFraction\": \"0.2\",\n \"totalLeveragedExposureInReference\": \"0\",\n \"collateralizedBalancesInReference\": \"0\",\n \"referenceCurrency\": \"USDC\",\n \"initialRequiredInReference\": \"0\",\n \"availableInReference\": \"0\",\n \"maintenanceMarginFraction\": \"0.1\",\n \"autoCloseMarginFraction\": \"0.033333333\",\n \"totalPositionsAtEntryInReference\": \"0\",\n \"totalUnrealisedFuturesPnlInReference\": \"0\",\n \"totalBorrowedInReference\": \"0\",\n \"tradeReservedInReference\": \"4.1838351786\"\n}"},{"id":"07a0e3ff-7d28-4010-a700-a2198ea53b84","name":"Account Margin Information for account with futures positions","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v2/margin/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"9"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"date","value":"Mon, 04 Dec 2023 14:57:54 GMT"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"marginFraction\": \"60.20150659\",\n \"collateralizedMarginFraction\": \"0.3958049\",\n \"initialMarginFraction\": \"0.2\",\n \"totalLeveragedExposureInReference\": \"40.87818421\",\n \"collateralizedBalancesInReference\": \"0\",\n \"referenceCurrency\": \"USDC\",\n \"initialRequiredInReference\": \"8.175636842\",\n \"availableInReference\": \"2444.74849043828165\",\n \"maintenanceMarginFraction\": \"0.1\",\n \"autoCloseMarginFraction\": \"0.033333333\",\n \"leverageMultiple\": 0.02,\n \"totalPositionsAtEntryInReference\": \"40.87818421\",\n \"totalUnrealisedFuturesPnlInReference\": \"0\",\n \"totalBorrowedInReference\": \"0\",\n \"tradeReservedInReference\": \"16.1797854537\"\n}"}],"_postman_id":"42a124a5-8846-4d78-bd81-ebf0095602b6"},{"name":"Account Margin Status","id":"e874f37e-02d4-4ccd-a5f4-3751f06bf6b1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns whether the account has margin trading enabled or not; and if it's currently in Liquidation state.
Liquidation
When an account falls below its maintenance margin, the value of its equity has dropped far enough that the risk that assets in the account won’t cover all of the debt is beyond acceptable limits.
VALR aims to liquidate accounts well before there is a risk of permanent loss. We achieve this by gradually selling off assets when the account falls below maintenance margin.
\nThe Liquidation process is set up in distinct stages that aim to keep an account above maintenance margin for as long as possible, reducing the impact of liquidation orders on order books and allowing customers the opportunity to take action to repay debt.
\nAll liquidation orders placed during the first stage (i.e. below maintenance but above auto-close, and whether matcher or not) will be visible as orders of the type \"liquidation limit order\" on the particular account in question.
\nSimilarly, for auto-close, the transfer of debt and assets out of the account will be visible on transaction history records as \"liquidation takeover debt transfer\" and \"liquidation takeover asset transfer\" respectively.
\n","urlObject":{"path":["v1","margin","account","status"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"2bf44cc4-3c56-478a-ba69-55de20ec0873","name":"Account Margin Status","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v1/margin/account/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 08 Nov 2023 13:19:24 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"1"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"marginEnabled\": true,\n \"inLiquidation\": false,\n \"futuresEnabled\": true\n}"}],"_postman_id":"e874f37e-02d4-4ccd-a5f4-3751f06bf6b1"},{"name":"Leverage Information","id":"34cc9bed-473c-4f99-8fbd-f2833e6fe01a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Specify the currency pair for which you would like to query the leverage information for a subaccount.\nExamples: BTCZARPERP, ETHUSDTPERP
\n","type":"text/plain"},"type":"any","value":"","key":"currencypair"}]}},"response":[{"id":"bd13e439-7cf0-42b7-8ded-8d908388fae9","name":"Leverage Information (Valid Currency Pair)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/margin/leverage/:currencypair","host":["https://api.valr.com"],"path":["v1","margin","leverage",":currencypair"],"variable":[{"key":"currencypair","value":"ETHUSDTPERP","description":"Specify the currency pair for which you would like to query the leverage information.\nExamples: BTCZARPERP, ETHUSDTPERP"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 26 Mar 2025 13:49:01 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"2"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"pairSymbol\": \"ETHUSDTPERP\",\n \"leverageMultiple\": 10,\n \"initialMarginFraction\": 0.1,\n \"maintenanceMarginFraction\": 0.05,\n \"autoCloseMarginFraction\": 0.03,\n \"riskLimit\": 400000,\n \"riskLimitCurrency\": \"USDT\"\n}"},{"id":"3c630633-fe72-4d6d-afa4-0cfde1d20b00","name":"Leverage Information (Invalid Currency Pair)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/margin/leverage/:currencypair","host":["https://api.valr.com"],"path":["v1","margin","leverage",":currencypair"],"variable":[{"key":"currencypair","value":"BTCZAR","description":"Specify the currency pair for which you would like to query the leverage information.\nExamples: BTCZARPERP, ETHUSDTPERP"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 26 Mar 2025 13:52:11 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"3"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -21,\n \"message\": \"Unsupported Currency Pair\"\n}"},{"id":"f36fee55-7001-4a57-a3af-1de21944ab6b","name":"Leverage Information (Leverage unset)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/margin/leverage/:currencypair","host":["https://api.valr.com"],"path":["v1","margin","leverage",":currencypair"],"variable":[{"key":"currencypair","value":"","description":"Specify the currency pair for which you would like to query the leverage information.\nExamples: BTCZARPERP, ETHUSDTPERP"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 26 Mar 2025 13:52:11 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"3"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"34cc9bed-473c-4f99-8fbd-f2833e6fe01a"},{"name":"Enable Margin Trading For Account","id":"0a404733-10c8-4622-b60a-5404f6421cdc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Enable an account to trade with margin.
\n","urlObject":{"path":["v1","margin","account","status"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"4b183348-17f3-4a39-999e-139990813ef9","name":"Enable Margin Trading For Account","originalRequest":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n accountStatusFieldName: \"MARGIN_ENABLED\", \n enabled: true\n}"},"url":"https://api.valr.com/v1/margin/account/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 08 Nov 2023 13:20:45 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"12"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"0a404733-10c8-4622-b60a-5404f6421cdc"},{"name":"Update Leverage","id":"5c5c795b-9a9c-48ca-8e62-ecbaf1a44f8e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Allows the user to update their Leverage for a specified currencyPair, to one of the available leverage options.
Specify the currency pair for which you would like to update maximum leverage for a subaccount.\nExamples: BTCZARPERP, ETHUSDTPERP
\n","type":"text/plain"},"type":"any","value":"","key":"currencypair"}]}},"response":[{"id":"a1f7ce1d-d472-4512-b7ec-ad6985c2fd52","name":"Update Leverage (Valid Currency Pair)","originalRequest":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"leverageMultiple\": 10\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/margin/leverage/:currencypair","protocol":"https","host":["api","valr","com"],"path":["v1","margin","leverage",":currencypair"],"variable":[{"key":"currencypair","value":"BTCZARPERP","description":"Specify the currency pair for which you would like to update the leverage.\nExamples: BTCZARPERP, ETHUSDTPERP"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 26 Mar 2025 14:06:28 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"416"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":null},{"id":"d7149452-916f-4dc5-aa2f-2df44e4fd267","name":"Update Leverage (Invalid Currency Pair)","originalRequest":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"leverageMultiple\": 10\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/margin/leverage/:currencypair","host":["https://api.valr.com"],"path":["v1","margin","leverage",":currencypair"],"variable":[{"key":"currencypair","value":"BTCZAR","description":"Specify the currency pair for which you would like to update the leverage.\nExamples: BTCZARPERP, ETHUSDTPERP"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 26 Mar 2025 14:09:39 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"2"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -21,\n \"message\": \"Unsupported Currency Pair\"\n}"}],"_postman_id":"5c5c795b-9a9c-48ca-8e62-ecbaf1a44f8e"}],"id":"a4be39ec-cd28-4836-8729-e11e3737cb88","description":"Make use of our Margin API to view vital information for accounts with leverage positions.
\nThese APIs are protected and will require authentication. See the section on Authentication to learn how to authenticate your API calls.
Specify the currency pair for which you would like to view the available leverage options.\nExample: ETHUSDTPERP
\n","type":"text/plain"},"type":"any","value":"","key":"currencypair"}]}},"response":[{"id":"d4cf7fab-1c6c-424a-aec8-9cba5e07311b","name":"Available Leverage Options (Valid Currency Pair)","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.valr.com/v1/public/risklimit/:currencypair","host":["https://api.valr.com"],"path":["v1","public","risklimit",":currencypair"],"variable":[{"key":"currencypair","value":"BTCUSDTPERP","description":"Specify the currency pair for which you would like to view the available leverage options.\nExample: ETHUSDTPERP"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"cache-control","value":"max-age=120,public"},{"key":"x-valr-upstream-service-time","value":"4"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Mon, 21 Jul 2025 07:23:52 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 1,\n \"initialMarginFraction\": 1,\n \"maintenanceMarginFraction\": 0.25,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 1500000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 2,\n \"initialMarginFraction\": 0.5,\n \"maintenanceMarginFraction\": 0.25,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 1500000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 3,\n \"initialMarginFraction\": 0.3333,\n \"maintenanceMarginFraction\": 0.1,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 1000000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 4,\n \"initialMarginFraction\": 0.25,\n \"maintenanceMarginFraction\": 0.1,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 1000000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 5,\n \"initialMarginFraction\": 0.2,\n \"maintenanceMarginFraction\": 0.1,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 1000000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 6,\n \"initialMarginFraction\": 0.1666,\n \"maintenanceMarginFraction\": 0.05,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 750000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 7,\n \"initialMarginFraction\": 0.1428,\n \"maintenanceMarginFraction\": 0.05,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 750000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 8,\n \"initialMarginFraction\": 0.125,\n \"maintenanceMarginFraction\": 0.05,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 750000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 9,\n \"initialMarginFraction\": 0.1111,\n \"maintenanceMarginFraction\": 0.05,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 750000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 10,\n \"initialMarginFraction\": 0.1,\n \"maintenanceMarginFraction\": 0.05,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 750000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": true\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 11,\n \"initialMarginFraction\": 0.0909,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 12,\n \"initialMarginFraction\": 0.0833,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 13,\n \"initialMarginFraction\": 0.0769,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 14,\n \"initialMarginFraction\": 0.0714,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 15,\n \"initialMarginFraction\": 0.0666,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 16,\n \"initialMarginFraction\": 0.0625,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 17,\n \"initialMarginFraction\": 0.0588,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 18,\n \"initialMarginFraction\": 0.0555,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 19,\n \"initialMarginFraction\": 0.0526,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 20,\n \"initialMarginFraction\": 0.05,\n \"maintenanceMarginFraction\": 0.025,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 400000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 21,\n \"initialMarginFraction\": 0.0476,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 22,\n \"initialMarginFraction\": 0.0454,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 23,\n \"initialMarginFraction\": 0.0434,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 24,\n \"initialMarginFraction\": 0.0416,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 25,\n \"initialMarginFraction\": 0.04,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 26,\n \"initialMarginFraction\": 0.0384,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 27,\n \"initialMarginFraction\": 0.037,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 28,\n \"initialMarginFraction\": 0.0357,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 29,\n \"initialMarginFraction\": 0.0344,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 30,\n \"initialMarginFraction\": 0.0333,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 31,\n \"initialMarginFraction\": 0.0322,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 32,\n \"initialMarginFraction\": 0.0312,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 33,\n \"initialMarginFraction\": 0.0303,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 34,\n \"initialMarginFraction\": 0.0294,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 35,\n \"initialMarginFraction\": 0.0285,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 36,\n \"initialMarginFraction\": 0.0277,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 37,\n \"initialMarginFraction\": 0.027,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 38,\n \"initialMarginFraction\": 0.0263,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 39,\n \"initialMarginFraction\": 0.0256,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 40,\n \"initialMarginFraction\": 0.025,\n \"maintenanceMarginFraction\": 0.0125,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 250000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 41,\n \"initialMarginFraction\": 0.0243,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 42,\n \"initialMarginFraction\": 0.0238,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 43,\n \"initialMarginFraction\": 0.0232,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 44,\n \"initialMarginFraction\": 0.0227,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 45,\n \"initialMarginFraction\": 0.0222,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 46,\n \"initialMarginFraction\": 0.0217,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 47,\n \"initialMarginFraction\": 0.0212,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 48,\n \"initialMarginFraction\": 0.0208,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 49,\n \"initialMarginFraction\": 0.0204,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 50,\n \"initialMarginFraction\": 0.02,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 51,\n \"initialMarginFraction\": 0.0196,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 52,\n \"initialMarginFraction\": 0.0192,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 53,\n \"initialMarginFraction\": 0.0188,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 54,\n \"initialMarginFraction\": 0.0185,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 55,\n \"initialMarginFraction\": 0.0181,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 56,\n \"initialMarginFraction\": 0.0178,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 57,\n \"initialMarginFraction\": 0.0175,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 58,\n \"initialMarginFraction\": 0.0172,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 59,\n \"initialMarginFraction\": 0.0169,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n },\n {\n \"pairSymbol\": \"BTCUSDTPERP\",\n \"leverageMultiple\": 60,\n \"initialMarginFraction\": 0.0166,\n \"maintenanceMarginFraction\": 0.0083,\n \"autoCloseMarginFraction\": 0.0083,\n \"riskLimitValue\": 200000,\n \"riskLimitCurrency\": \"USDT\",\n \"isDefault\": false\n }\n]"},{"id":"3c40dce7-ac95-48d7-b125-59c5660c2134","name":"Available Leverage Options (Invalid Currency Pair)","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.valr.com/v1/public/risklimit/:currencypair","host":["https://api.valr.com"],"path":["v1","public","risklimit",":currencypair"],"variable":[{"key":"currencypair","value":"BTCETHPERP","description":"Specify the currency pair for which you would like to view the available leverage options.\nExample: ETHUSDTPERP"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 26 Mar 2025 15:07:03 GMT"},{"key":"cache-control","value":"max-age=120,public"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"1"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -21,\n \"message\": \"Unsupported Currency Pair\"\n}"}],"_postman_id":"4b435f25-71a1-48f1-84b6-e0ad48f39f5c"},{"name":"Futures Contracts Information","id":"d96d0f40-e294-4758-832a-381bd97dc613","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the futures contracts information which includes the following fields:
\nFunding Rate
\nEvery hour, each perpetual contract has a funding payment where longs pay shorts if the contract is trading at a premium to the index, and shorts pay longs if the contract is trading at a discount to the index.
\nFunding payments are made in the quote currency of perpetual pairs and are added to/deducted from the account's balance each hour.
\nPositive funding rates denote cases where longs are expected to pay shorts, while negative funding rates denote cases where shorts are expected to pay longs.
\n","urlObject":{"path":["v1","public","futures","info"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"9bbec46b-7f16-47cb-80a6-e0ff155d4eb6","name":"Futures Information","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v1/public/futures/info"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 14 Nov 2023 19:25:52 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"138"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"n/a"},{"key":"Via","value":"1.1 google"},{"key":"Cache-Control","value":"max-age=60,public"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencyPair\": \"BTCUSDTPERP\",\n \"estimatedFundingRate\": \"-0.00088\",\n \"openInterest\": \"0.0002\",\n \"nextFundingRun\": 1699992000000,\n \"nextPnlRun\": 1699992000000\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"estimatedFundingRate\": \"-0.000563\",\n \"openInterest\": \"15\",\n \"nextFundingRun\": 1699992000000,\n \"nextPnlRun\": 1699992000000\n }\n]"}],"_postman_id":"d96d0f40-e294-4758-832a-381bd97dc613"},{"name":"Futures Information For Account","id":"e40e476c-1f86-47d0-97f4-d5442c2cc049","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the following futures information for an account:
\n","urlObject":{"path":["v1","margin","status"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"046821ca-bb5b-4445-b908-db1553df2b2b","name":"Futures Information For Account (With Futures Positions)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v1/margin/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Fri, 03 May 2024 10:37:06 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"4"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"marginFraction\": \"55693.27431339\",\n \"collateralisedMarginFraction\": \"2.2974809\",\n \"initialMarginFraction\": \"0.13417938\",\n \"totalBorrowedInReference\": \"8.991339448\",\n \"collateralisedBalancesInReference\": \"0\",\n \"referenceCurrency\": \"USDC\",\n \"initialRequiredInReference\": \"1.2194531628\",\n \"availableInReference\": \"500736.476891650739\",\n \"maintenanceMarginFraction\": \"0.067089692\",\n \"autoCloseMarginFraction\": \"0.017975189\",\n \"leverageMultiple\": 0.01,\n \"totalPositionsAtEntryInReference\": \"8.978338668\",\n \"totalUnrealisedFuturesPnlInReference\": \"-0.01300078\",\n \"defaultInitialMarginFraction\": \"0.2\",\n \"defaultMaintenanceMarginFraction\": \"0.1\",\n \"defaultAutoCloseMarginFraction\": \"0.033333333\"\n}"},{"id":"9dd116c5-c53f-4825-a85b-628682ac7c88","name":"Futures Information For Account (With No Futures Positions)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v1/margin/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 14 Nov 2023 22:09:22 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"1"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"n/a"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"initialMarginFraction\": \"0.2\",\n \"totalBorrowedInReference\": \"0\",\n \"collateralisedBalancesInReference\": \"0\",\n \"referenceCurrency\": \"USDC\",\n \"initialRequiredInReference\": \"0\",\n \"availableInReference\": \"0\",\n \"maintenanceMarginFraction\": \"0.1\",\n \"autoCloseMarginFraction\": \"0.033333333\"\n}"}],"_postman_id":"e40e476c-1f86-47d0-97f4-d5442c2cc049"},{"name":"Open Futures Positions","id":"abd358c0-3a84-40ce-a372-a5c2dcaf6a39","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns the open futures positions for an account, including the following information:
\nNotes on PnL
\nPnL runs are based on changes in mark price, and additional collateral may be locked for unrealised loss also based on changes in mark price.
\nThe final PnL for a position is related to the actual price at which a position is closed, which is a price on the VALR order book and might differ from the mark price.
\n","urlObject":{"path":["v1","positions","open"],"host":["https://api.valr.com"],"query":[{"disabled":true,"description":{"content":"The name of the perpetual futures contract expressed as base, quote, PERP e.g. BTCUSDTPERP
\n","type":"text/plain"},"key":"currencyPair","value":"BTCUSDTPERP"},{"disabled":true,"description":{"content":"Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"disabled":true,"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"10"}],"variable":[]}},"response":[{"id":"ad0e339e-df92-46c3-989a-faf74f672c0d","name":"Open Futures Positions","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/positions/open","host":["https://api.valr.com"],"path":["v1","positions","open"],"query":[{"key":"currencyPair","value":"BTCUSDTPERP","description":"The name of the perpetual futures contract expressed as base, quote, PERP e.g. BTCUSDTPERP","disabled":true},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)","disabled":true},{"key":"limit","value":"10","description":"Limit the results to this number. (Default and Max 100)","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"12"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Thu, 24 Jul 2025 08:41:15 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"pair\": \"DOGEUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"10\",\n \"realisedPnl\": \"0.58111\",\n \"totalSessionEntryQuantity\": \"10\",\n \"totalSessionValue\": \"2.2823\",\n \"sessionAverageEntryPrice\": \"0.22823\",\n \"averageEntryPrice\": \"0.17\",\n \"unrealisedPnl\": \"0.0283\",\n \"updatedAt\": \"2025-07-24T08:00:00.021Z\",\n \"createdAt\": \"2025-07-23T13:55:24.308Z\",\n \"positionId\": \"a86fb764-cda4-0237-28a9-0361bc8a2334\",\n \"leverageTier\": 13\n },\n {\n \"pair\": \"AVAXUSDTPERP\",\n \"side\": \"sell\",\n \"quantity\": \"14.61\",\n \"realisedPnl\": \"-80.6776855\",\n \"totalSessionEntryQuantity\": \"14.61\",\n \"totalSessionValue\": \"350.87376\",\n \"sessionAverageEntryPrice\": \"24.016\",\n \"averageEntryPrice\": \"18.5\",\n \"unrealisedPnl\": \"0.1168\",\n \"updatedAt\": \"2025-07-24T08:00:00.028Z\",\n \"createdAt\": \"2025-06-20T13:55:09.359Z\",\n \"positionId\": \"bd44a0a5-52b1-a011-28a9-031c6cf96eec\",\n \"leverageTier\": 3\n },\n {\n \"pair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0003\",\n \"realisedPnl\": \"0.45927159\",\n \"totalSessionEntryQuantity\": \"0.0003\",\n \"totalSessionValue\": \"34.8096\",\n \"sessionAverageEntryPrice\": \"116032\",\n \"averageEntryPrice\": \"114421\",\n \"unrealisedPnl\": \"0.0909\",\n \"updatedAt\": \"2025-07-24T08:00:00.008Z\",\n \"createdAt\": \"2025-07-23T12:15:56.679Z\",\n \"positionId\": \"11bd437d-301e-1820-28a9-0361b9b1abac\",\n \"leverageTier\": 27\n }\n]"}],"_postman_id":"abd358c0-3a84-40ce-a372-a5c2dcaf6a39"},{"name":"Closed Futures Positions Summary","id":"d6114ce9-c886-42a0-81b3-9572424c6a92","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns a summary of the Closed Futures Positions for an account.
\n","urlObject":{"path":["v1","positions","closed","summary"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"0933c5f9-1b6e-4cb6-9e83-6200531ddf10","name":"Closed Futures Positions Summary","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":"https://api.valr.com/v1/positions/closed/summary"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 05 Dec 2023 14:20:08 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"44"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"buy\",\n \"quantity\": \"44\",\n \"averageEntryPrice\": \"19.01\",\n \"averageClosePrice\": \"19\",\n \"realisedPnl\": \"-1.27622\",\n \"fees\": \"0.83622\",\n \"positionCreatedAt\": \"2023-11-14T19:49:09.317Z\",\n \"positionId\": \"046f52a0-758c-6ec8-28a9-03fe7b0b51bc\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"quantity\": \"400\",\n \"averageEntryPrice\": \"19\",\n \"averageClosePrice\": \"19.01\",\n \"realisedPnl\": \"-11.602\",\n \"fees\": \"7.602\",\n \"positionCreatedAt\": \"2023-11-14T19:43:46.081Z\",\n \"positionId\": \"8046f52a-0724-e524-28a9-03fe7ae3de9c\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"quantity\": \"26.315\",\n \"averageEntryPrice\": \"19\",\n \"averageClosePrice\": \"19.01\",\n \"realisedPnl\": \"-0.763266575\",\n \"fees\": \"0.500116575\",\n \"positionCreatedAt\": \"2023-11-14T19:38:15.962Z\",\n \"positionId\": \"540e67ec-a500-8dea-28a9-03fe7abb9344\"\n },\n {\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0003\",\n \"averageEntryPrice\": \"30001\",\n \"averageClosePrice\": \"30000\",\n \"realisedPnl\": \"-0.00930015\",\n \"fees\": \"0.00900015\",\n \"positionCreatedAt\": \"2023-11-14T19:35:59.457Z\",\n \"positionId\": \"8046f52a-077e-a3ac-28a9-03fe7aaac49c\"\n }\n]"}],"_postman_id":"d6114ce9-c886-42a0-81b3-9572424c6a92"},{"name":"Closed Futures Positions Full (currencyPair)","id":"60ce31a1-2be1-4790-b3b0-dbcdd390f67d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns a detailed view of the Closed Futures Positions for an account.
\n","urlObject":{"path":["v1","positions","closed"],"host":["https://api.valr.com"],"query":[{"disabled":true,"description":{"content":"Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip ","value":"0"},{"disabled":true,"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"100"},{"description":{"content":"The name of the perpetual futures contract expressed as base, quote, PERP e.g. BTCUSDTPERP|
\n","type":"text/plain"},"key":"currencyPair","value":"BTCUSDTPERP"}],"variable":[]}},"response":[{"id":"9d9624af-c9f6-42d8-8d31-fbc560e8be23","name":"Closed Futures Positions Full (currencyPair)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/positions/closed?currencyPair=USDTZARPERP","host":["https://api.valr.com"],"path":["v1","positions","closed"],"query":[{"key":"currencyPair","value":"USDTZARPERP","description":"The name of the perpetual futures contract expressed as base, quote, PERPe.g. `BTCUSDTPERP`|"},{"key":"skip ","value":"0","description":"Skip this number of results. (Default 0)","disabled":true},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 05 Dec 2023 14:21:26 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"11"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"orderSide\": \"buy\",\n \"quantity\": \"40\",\n \"averageEntryPrice\": \"19.01\",\n \"closePrice\": \"19\",\n \"realisedPnl\": \"-1.160201\",\n \"closeType\": \"Trade\",\n \"createdAt\": \"2023-11-14T19:51:49.988Z\",\n \"fees\": \"0.760201\",\n \"positionId\": \"046f52a0-758c-6ec8-28a9-03fe7b0b51bc\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"orderSide\": \"buy\",\n \"quantity\": \"4\",\n \"averageEntryPrice\": \"19.01\",\n \"closePrice\": \"19\",\n \"realisedPnl\": \"-0.116019\",\n \"closeType\": \"Trade\",\n \"createdAt\": \"2023-11-14T19:50:49.556Z\",\n \"fees\": \"0.076019\",\n \"positionId\": \"046f52a0-758c-6ec8-28a9-03fe7b0b51bc\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"orderSide\": \"sell\",\n \"quantity\": \"400\",\n \"averageEntryPrice\": \"19\",\n \"closePrice\": \"19.01\",\n \"realisedPnl\": \"-11.602\",\n \"closeType\": \"Trade\",\n \"createdAt\": \"2023-11-14T19:48:48.265Z\",\n \"fees\": \"7.602\",\n \"positionId\": \"8046f52a-0724-e524-28a9-03fe7ae3de9c\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"orderSide\": \"sell\",\n \"quantity\": \"26.315\",\n \"averageEntryPrice\": \"19\",\n \"closePrice\": \"19.01\",\n \"realisedPnl\": \"-0.763266575\",\n \"closeType\": \"Trade\",\n \"createdAt\": \"2023-11-14T19:40:23.691Z\",\n \"fees\": \"0.500116575\",\n \"positionId\": \"540e67ec-a500-8dea-28a9-03fe7abb9344\"\n }\n]"}],"_postman_id":"60ce31a1-2be1-4790-b3b0-dbcdd390f67d"},{"name":"Futures Positions History","id":"a18a174d-4b3a-4734-9982-d5c5074978c5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns a history of futures positions for an account.
\n","urlObject":{"path":["v1","positions","history"],"host":["https://api.valr.com"],"query":[{"description":{"content":"The name of the perpetual futures contract expressed as base, quote, PERP e.g. BTCUSDCPERP|
\n","type":"text/plain"},"key":"currencyPair","value":"BTCUSDTPERP"}],"variable":[]}},"response":[{"id":"3d9bc3f5-a9c5-4ea4-a672-49dadfd7b3f1","name":"Futures Positions History","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/positions/history?currencyPair=BTCUSDTPERP","host":["https://api.valr.com"],"path":["v1","positions","history"],"query":[{"key":"currencyPair","value":"BTCUSDTPERP"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 05 Dec 2023 14:22:18 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"15"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"15.22299935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"54.2438\",\n \"sessionAverageEntryPrice\": \"41726\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-05T12:00:00.317Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"14.94999935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"53.9708\",\n \"sessionAverageEntryPrice\": \"41516\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-05T08:00:00.055Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"-39.02080065\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"0\",\n \"sessionAverageEntryPrice\": \"0\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-05T04:00:00.026Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"-39.02080065\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"0\",\n \"sessionAverageEntryPrice\": \"0\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-05T00:00:00.029Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"-39.02080065\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"0\",\n \"sessionAverageEntryPrice\": \"0\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-04T20:00:00.026Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"-39.02080065\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"0\",\n \"sessionAverageEntryPrice\": \"0\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-04T16:00:00.028Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"-39.02080065\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"0\",\n \"sessionAverageEntryPrice\": \"0\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-04T12:00:00.039Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"14.82389935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"53.8447\",\n \"sessionAverageEntryPrice\": \"41419\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-04T08:00:00.032Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"13.91909935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"52.9399\",\n \"sessionAverageEntryPrice\": \"40723\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-04T04:00:00.034Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"12.94279935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"51.9636\",\n \"sessionAverageEntryPrice\": \"39972\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-04T00:00:00.027Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"12.38769935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"51.4085\",\n \"sessionAverageEntryPrice\": \"39545\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-03T20:00:00.026Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"12.66589935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"51.6867\",\n \"sessionAverageEntryPrice\": \"39759\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-03T16:00:00.029Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"12.29929935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"51.3201\",\n \"sessionAverageEntryPrice\": \"39477\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-03T12:00:00.026Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"12.30189935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"51.3227\",\n \"sessionAverageEntryPrice\": \"39479\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-03T08:00:00.030Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"12.16539935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"51.1862\",\n \"sessionAverageEntryPrice\": \"39374\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-03T04:00:00.030Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"12.27199935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"51.2928\",\n \"sessionAverageEntryPrice\": \"39456\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-03T00:00:00.026Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"12.18749935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"51.2083\",\n \"sessionAverageEntryPrice\": \"39391\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-02T20:00:00.031Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"11.43609935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"50.4569\",\n \"sessionAverageEntryPrice\": \"38813\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-02T16:00:00.031Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"11.35289935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"50.3737\",\n \"sessionAverageEntryPrice\": \"38749\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-02T12:00:00.031Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"11.30219935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"50.323\",\n \"sessionAverageEntryPrice\": \"38710\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-02T08:00:00.030Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"11.38799935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"50.4088\",\n \"sessionAverageEntryPrice\": \"38776\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-02T04:00:00.026Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"11.26579935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"50.2866\",\n \"sessionAverageEntryPrice\": \"38682\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-02T00:00:00.029Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"11.38279935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"50.4036\",\n \"sessionAverageEntryPrice\": \"38772\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-01T20:00:00.030Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.91869935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.9395\",\n \"sessionAverageEntryPrice\": \"38415\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-01T16:00:00.031Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"11.13709935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"50.1579\",\n \"sessionAverageEntryPrice\": \"38583\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-01T12:00:00.029Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.71719935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.738\",\n \"sessionAverageEntryPrice\": \"38260\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-01T08:00:00.030Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.43769935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.4585\",\n \"sessionAverageEntryPrice\": \"38045\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-01T04:00:00.029Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.99829935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.0191\",\n \"sessionAverageEntryPrice\": \"37707\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-12-01T00:00:00.027Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.05809935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.0789\",\n \"sessionAverageEntryPrice\": \"37753\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-30T20:00:00.029Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.84749935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.8683\",\n \"sessionAverageEntryPrice\": \"37591\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-30T16:00:00.028Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.23619935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.257\",\n \"sessionAverageEntryPrice\": \"37890\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-30T12:00:00.030Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.09839935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.1192\",\n \"sessionAverageEntryPrice\": \"37784\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-30T08:00:00.026Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.42989935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.4507\",\n \"sessionAverageEntryPrice\": \"38039\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-30T04:00:00.029Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.18679935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.2076\",\n \"sessionAverageEntryPrice\": \"37852\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-30T00:00:00.031Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.22059935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.2414\",\n \"sessionAverageEntryPrice\": \"37878\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-29T20:00:00.026Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.15429935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.1751\",\n \"sessionAverageEntryPrice\": \"37827\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-29T16:00:00.034Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.51959935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.5404\",\n \"sessionAverageEntryPrice\": \"38108\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-29T12:00:00.031Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.50139935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.5222\",\n \"sessionAverageEntryPrice\": \"38094\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-29T08:00:00.029Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.29599935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.3168\",\n \"sessionAverageEntryPrice\": \"37936\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-29T04:00:00.036Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.14129935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.1621\",\n \"sessionAverageEntryPrice\": \"37817\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-29T00:00:00.034Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.59109935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.6119\",\n \"sessionAverageEntryPrice\": \"38163\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-28T20:00:00.028Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.75259935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.7734\",\n \"sessionAverageEntryPrice\": \"37518\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-28T16:00:00.031Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.40419935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.425\",\n \"sessionAverageEntryPrice\": \"37250\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-28T12:00:00.029Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.23129935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.2521\",\n \"sessionAverageEntryPrice\": \"37117\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-28T08:00:00.035Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.24689935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.2677\",\n \"sessionAverageEntryPrice\": \"37129\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-28T04:00:00.030Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.40549935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.4263\",\n \"sessionAverageEntryPrice\": \"37251\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-28T00:00:00.028Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.92579935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.9466\",\n \"sessionAverageEntryPrice\": \"36882\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-27T20:00:00.033Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.79579935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.8166\",\n \"sessionAverageEntryPrice\": \"36782\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-27T16:00:00.034Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.15589935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.1767\",\n \"sessionAverageEntryPrice\": \"37059\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-27T12:00:00.031Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.45879935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.4796\",\n \"sessionAverageEntryPrice\": \"37292\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-27T08:00:00.032Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.47439935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.4952\",\n \"sessionAverageEntryPrice\": \"37304\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-27T04:00:00.029Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.68629935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.7071\",\n \"sessionAverageEntryPrice\": \"37467\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-27T00:00:00.028Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.56799935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.5888\",\n \"sessionAverageEntryPrice\": \"37376\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-26T20:00:00.028Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.66809935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.6889\",\n \"sessionAverageEntryPrice\": \"37453\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-26T16:00:00.028Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.96449935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.9853\",\n \"sessionAverageEntryPrice\": \"37681\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-26T12:00:00.032Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.11009935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.1309\",\n \"sessionAverageEntryPrice\": \"37793\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-26T08:00:00.029Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.03339935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.0542\",\n \"sessionAverageEntryPrice\": \"37734\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-26T04:00:00.030Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.09449935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.1153\",\n \"sessionAverageEntryPrice\": \"37781\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-26T00:00:00.033Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.14519935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.166\",\n \"sessionAverageEntryPrice\": \"37820\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-25T20:00:00.030Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.99699935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.0178\",\n \"sessionAverageEntryPrice\": \"37706\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-25T16:00:00.029Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.91509935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.9359\",\n \"sessionAverageEntryPrice\": \"37643\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-25T12:00:00.032Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.12179935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.1426\",\n \"sessionAverageEntryPrice\": \"37802\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-25T08:00:00.030Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.10749935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.1283\",\n \"sessionAverageEntryPrice\": \"37791\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-25T04:00:00.031Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.99829935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.0191\",\n \"sessionAverageEntryPrice\": \"37707\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-25T00:00:00.039Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.07759935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.0984\",\n \"sessionAverageEntryPrice\": \"37768\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-24T20:00:00.030Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.65739935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.6782\",\n \"sessionAverageEntryPrice\": \"38214\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-24T16:00:00.031Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"10.05939935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"49.0802\",\n \"sessionAverageEntryPrice\": \"37754\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-24T12:00:00.215Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.54069935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.5615\",\n \"sessionAverageEntryPrice\": \"37355\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-23T08:00:00.022Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.47309935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.4939\",\n \"sessionAverageEntryPrice\": \"37303\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-23T04:00:00.025Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.62909935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.6499\",\n \"sessionAverageEntryPrice\": \"37423\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-23T00:00:00.025Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.44319935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.464\",\n \"sessionAverageEntryPrice\": \"37280\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-22T20:00:00.026Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.38759935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.4084\",\n \"sessionAverageEntryPrice\": \"36468\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-22T16:00:00.026Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.37589935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.3967\",\n \"sessionAverageEntryPrice\": \"36459\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-22T12:00:00.165Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.37069935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.3915\",\n \"sessionAverageEntryPrice\": \"36455\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-22T08:00:00.026Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.27709935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.2979\",\n \"sessionAverageEntryPrice\": \"36383\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-22T04:00:00.026Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"7.52569935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"46.5465\",\n \"sessionAverageEntryPrice\": \"35805\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-22T00:00:00.022Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.04669935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.0675\",\n \"sessionAverageEntryPrice\": \"36975\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-21T20:00:00.027Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.04279935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.0636\",\n \"sessionAverageEntryPrice\": \"36972\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-21T16:00:00.036Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.30279935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.3236\",\n \"sessionAverageEntryPrice\": \"37172\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-21T12:00:00.024Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.41719935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.438\",\n \"sessionAverageEntryPrice\": \"37260\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-21T08:00:00.034Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.68369935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.7045\",\n \"sessionAverageEntryPrice\": \"37465\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-21T04:00:00.022Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.66679935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.6876\",\n \"sessionAverageEntryPrice\": \"37452\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-21T00:00:00.021Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.83709935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.8579\",\n \"sessionAverageEntryPrice\": \"37583\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-20T20:00:00.020Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.67199935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.6928\",\n \"sessionAverageEntryPrice\": \"37456\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-20T16:00:00.025Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.27549935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.2963\",\n \"sessionAverageEntryPrice\": \"37151\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-20T12:00:00.034Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.39509935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.4159\",\n \"sessionAverageEntryPrice\": \"37243\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-20T08:00:00.026Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.21829935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.2391\",\n \"sessionAverageEntryPrice\": \"37107\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-20T04:00:00.020Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.55629935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.5771\",\n \"sessionAverageEntryPrice\": \"37367\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-20T00:00:00.022Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"9.02979935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"48.0506\",\n \"sessionAverageEntryPrice\": \"36962\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-19T20:00:00.022Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.49809935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.5189\",\n \"sessionAverageEntryPrice\": \"36553\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-19T16:00:00.025Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.36289935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.3837\",\n \"sessionAverageEntryPrice\": \"36449\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-19T12:00:00.024Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.56569935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.5865\",\n \"sessionAverageEntryPrice\": \"36605\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-19T08:00:00.022Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.45389935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.4747\",\n \"sessionAverageEntryPrice\": \"36519\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-19T04:00:00.021Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.51369935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.5345\",\n \"sessionAverageEntryPrice\": \"36565\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-19T00:00:00.022Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.66189935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.6827\",\n \"sessionAverageEntryPrice\": \"36679\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-18T20:00:00.025Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.65539935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.6762\",\n \"sessionAverageEntryPrice\": \"36674\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-18T16:00:00.024Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.30699935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.3278\",\n \"sessionAverageEntryPrice\": \"36406\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-18T12:00:00.025Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.30959935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.3304\",\n \"sessionAverageEntryPrice\": \"36408\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-18T08:00:00.029Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.25889935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.2797\",\n \"sessionAverageEntryPrice\": \"36369\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-18T04:00:00.024Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n },\n {\n \"updateType\": \"Pnl\",\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"quantity\": \"0.0013\",\n \"realisedPnl\": \"8.53709935\",\n \"totalSessionEntryQuantity\": \"0.0013\",\n \"totalSessionValue\": \"47.5579\",\n \"sessionAverageEntryPrice\": \"36583\",\n \"averageEntryPrice\": \"30001\",\n \"updatedAt\": \"2023-11-18T00:00:00.025Z\",\n \"positionId\": \"237a9503-b32b-5f40-28a9-03fe7ad510d4\"\n }\n]"}],"_postman_id":"a18a174d-4b3a-4734-9982-d5c5074978c5"},{"name":"Funding History","id":"9875c3b6-c97b-411b-9310-3fe551942255","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns a history of the funding details for an account's positions, which includes the following:
\nThe results of this request may be filtered by currencyPair and datetime. The skip and limit parameters may be applied to paginate the filtered results.
currencyPairThe currencyPair parameter may be used to filter the returned items by name of the perpetual futures contract expressed as base, quote, PERPe.g. BTCUSDTPERP|
startTime or endTimeThe startTime or endTime parameters may be used to filter the returned items by the transaction date. The parameters will be interpreted as being in the UTC time zone and must be supplied in the ISO 8601 format (2023-11-14T22:00:00.000Z). These two parameters may be used together or separately. When startTime is used, transactions that have occurred since startTime are returned. When endTime is used, transactions that have occurred up to and including endTime are returned.
When not specified, 30 days worth of transactions are returned by default.
The name of the perpetual futures contract expressed as base, quote, PERP e.g. BTCUSDTPERP|
Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"100"}],"variable":[]}},"response":[{"id":"f889def4-7b29-438e-9891-1ee6dfc87902","name":"Funding History (Long)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/positions/funding/history?currencyPair=BTCUSDTPERP&skip=0&limit=100","host":["https://api.valr.com"],"path":["v1","positions","funding","history"],"query":[{"key":"currencyPair","value":"BTCUSDTPERP","description":"The name of the perpetual futures contract expressed as base, quote, PERPe.g. `BTCUSDTPERP`|"},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"43"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Mon, 21 Jul 2025 07:35:13 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"createdAt\": \"2025-06-21T12:00:00.491Z\",\n \"fundingRate\": \"-0.001885\",\n \"fundingAmount\": \"0.2545\",\n \"positionTotal\": \"135.0414\",\n \"positionId\": \"237a89ed-b431-df40-28a9-031900d5c4d4\"\n },\n {\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"createdAt\": \"2025-06-21T11:00:00.290Z\",\n \"fundingRate\": \"-0.002006\",\n \"fundingAmount\": \"0.2707\",\n \"positionTotal\": \"134.9504\",\n \"positionId\": \"237a89ed-b431-df40-28a9-031900d5c4d4\"\n },\n {\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"createdAt\": \"2025-06-21T10:00:00.490Z\",\n \"fundingRate\": \"-0.00204\",\n \"fundingAmount\": \"0.2754\",\n \"positionTotal\": \"135.0024\",\n \"positionId\": \"237a89ed-b431-df40-28a9-031900d5c4d4\"\n },\n {\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"createdAt\": \"2025-06-21T09:00:00.445Z\",\n \"fundingRate\": \"-0.002075\",\n \"fundingAmount\": \"0.28\",\n \"positionTotal\": \"134.9452\",\n \"positionId\": \"237a89ed-b431-df40-28a9-031900d5c4d4\"\n },\n {\n \"currencyPair\": \"BTCUSDTPERP\",\n \"side\": \"buy\",\n \"createdAt\": \"2025-06-21T08:00:00.877Z\",\n \"fundingRate\": \"-0.002117\",\n \"fundingAmount\": \"0.2846\",\n \"positionTotal\": \"134.4733\",\n \"positionId\": \"237a89ed-b431-df40-28a9-031900d5c4d4\"\n }\n]"},{"id":"a7a0a4b7-0b07-42a5-84d8-2f38aee7b08f","name":"Funding History (Short)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/positions/funding/history?currencyPair=USDTZARPERP&skip=0&limit=100","host":["https://api.valr.com"],"path":["v1","positions","funding","history"],"query":[{"key":"currencyPair","value":"USDTZARPERP","description":"The name of the perpetual futures contract expressed as base, quote, PERPe.g. `BTCUSDTPERP`|"},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"100","description":"Limit the results to this number. (Default and Max 100)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 05 Dec 2023 14:29:19 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"9"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T19:00:02.274Z\",\n \"fundingRate\": \"0.000301\",\n \"fundingAmount\": \"2.2538\",\n \"positionTotal\": \"7488\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T18:00:02.327Z\",\n \"fundingRate\": \"0.000255\",\n \"fundingAmount\": \"1.9084\",\n \"positionTotal\": \"7484\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T17:00:02.311Z\",\n \"fundingRate\": \"0.000208\",\n \"fundingAmount\": \"1.5583\",\n \"positionTotal\": \"7492\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T16:00:02.233Z\",\n \"fundingRate\": \"0.00016\",\n \"fundingAmount\": \"1.1955\",\n \"positionTotal\": \"7472\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T15:00:02.305Z\",\n \"fundingRate\": \"0.000113\",\n \"fundingAmount\": \"0.8456\",\n \"positionTotal\": \"7484\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T14:00:02.274Z\",\n \"fundingRate\": \"0.000065\",\n \"fundingAmount\": \"0.4859\",\n \"positionTotal\": \"7476\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T13:00:02.321Z\",\n \"fundingRate\": \"0.000016\",\n \"fundingAmount\": \"0.1193\",\n \"positionTotal\": \"7460\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T12:00:02.319Z\",\n \"fundingRate\": \"-0.000037\",\n \"fundingAmount\": \"-0.2759\",\n \"positionTotal\": \"7456\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T11:00:02.303Z\",\n \"fundingRate\": \"-0.00009\",\n \"fundingAmount\": \"-0.6722\",\n \"positionTotal\": \"7468\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T10:00:02.315Z\",\n \"fundingRate\": \"-0.000139\",\n \"fundingAmount\": \"-1.0392\",\n \"positionTotal\": \"7476\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T09:00:02.356Z\",\n \"fundingRate\": \"-0.000147\",\n \"fundingAmount\": \"-1.1178\",\n \"positionTotal\": \"7604\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T08:00:02.362Z\",\n \"fundingRate\": \"-0.000152\",\n \"fundingAmount\": \"-1.1552\",\n \"positionTotal\": \"7600\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T07:00:02.332Z\",\n \"fundingRate\": \"-0.000168\",\n \"fundingAmount\": \"-1.2768\",\n \"positionTotal\": \"7600\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T06:00:02.354Z\",\n \"fundingRate\": \"-0.00018\",\n \"fundingAmount\": \"-1.368\",\n \"positionTotal\": \"7600\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T05:00:02.250Z\",\n \"fundingRate\": \"-0.000192\",\n \"fundingAmount\": \"-1.4592\",\n \"positionTotal\": \"7600\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T04:00:02.351Z\",\n \"fundingRate\": \"-0.000202\",\n \"fundingAmount\": \"-1.5352\",\n \"positionTotal\": \"7600\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T03:00:02.449Z\",\n \"fundingRate\": \"-0.000211\",\n \"fundingAmount\": \"-1.6036\",\n \"positionTotal\": \"7600\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T02:00:02.326Z\",\n \"fundingRate\": \"-0.000221\",\n \"fundingAmount\": \"-1.6796\",\n \"positionTotal\": \"7600\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T01:00:02.321Z\",\n \"fundingRate\": \"-0.000232\",\n \"fundingAmount\": \"-1.7632\",\n \"positionTotal\": \"7600\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-15T00:00:02.627Z\",\n \"fundingRate\": \"-0.000242\",\n \"fundingAmount\": \"-1.8392\",\n \"positionTotal\": \"7600\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-14T23:00:02.334Z\",\n \"fundingRate\": \"-0.000251\",\n \"fundingAmount\": \"-1.9076\",\n \"positionTotal\": \"7600\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-14T22:00:02.363Z\",\n \"fundingRate\": \"-0.000261\",\n \"fundingAmount\": \"-1.9836\",\n \"positionTotal\": \"7600\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-14T21:00:02.230Z\",\n \"fundingRate\": \"-0.000269\",\n \"fundingAmount\": \"-2.0444\",\n \"positionTotal\": \"7600\"\n },\n {\n \"currencyPair\": \"USDTZARPERP\",\n \"side\": \"sell\",\n \"createdAt\": \"2023-11-14T20:00:02.401Z\",\n \"fundingRate\": \"-0.000275\",\n \"fundingAmount\": \"-2.09\",\n \"positionTotal\": \"7600\"\n }\n]"}],"_postman_id":"9875c3b6-c97b-411b-9310-3fe551942255"},{"name":"Leverage Information","id":"51571013-1ea9-42cb-9573-b69c41f58a8e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Specify the currency pair for which you would like to query the leverage information for a subaccount.\nExample: ETHUSDTPERP
\n","type":"text/plain"},"type":"any","value":"","key":"currencypair"}]}},"response":[{"id":"0d90d27c-f94e-405a-a7fd-313cc02728a6","name":"Leverage Information (Valid Currency Pair)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/margin/leverage/:currencypair","host":["https://api.valr.com"],"path":["v1","margin","leverage",":currencypair"],"variable":[{"key":"currencypair","value":"ETHUSDTPERP","description":"Specify the currency pair for which you would like to query the leverage information.\nExample: ETHUSDTPERP"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 26 Mar 2025 13:49:01 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"2"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"pairSymbol\": \"ETHUSDTPERP\",\n \"leverageMultiple\": 10,\n \"initialMarginFraction\": 0.1,\n \"maintenanceMarginFraction\": 0.05,\n \"autoCloseMarginFraction\": 0.03,\n \"riskLimit\": 400000,\n \"riskLimitCurrency\": \"USDT\"\n}"},{"id":"32048041-58da-4433-9d31-bd4c90bc4352","name":"Leverage Information (Invalid Currency Pair)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/margin/leverage/:currencypair","host":["https://api.valr.com"],"path":["v1","margin","leverage",":currencypair"],"variable":[{"key":"currencypair","value":"BTCUSDT","description":"Specify the currency pair for which you would like to query the leverage information.\nExample: ETHUSDTPERP"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 26 Mar 2025 13:52:11 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"3"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -21,\n \"message\": \"Unsupported Currency Pair\"\n}"},{"id":"fb127729-78fd-44f4-9e89-8bc51f38126d","name":"Leverage Information (Leverage unset)","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/margin/leverage/:currencypair","host":["https://api.valr.com"],"path":["v1","margin","leverage",":currencypair"],"variable":[{"key":"currencypair","value":"","description":"Specify the currency pair for which you would like to query the leverage information.\nExample: ETHUSDTPERP"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 26 Mar 2025 13:52:11 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"3"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"51571013-1ea9-42cb-9573-b69c41f58a8e"},{"name":"Enable Futures Trading For Account","id":"4a61cb88-cd27-49cb-b293-f480ea96e86a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Enable a subaccount for Futures trading.
\nNote
\nTo trade futures on VALR, it is necessary to complete address verification as laid out in the guide How to enable Futures trading on VALR
\n","urlObject":{"path":["v1","margin","account","status"],"host":["https://api.valr.com"],"query":[],"variable":[]}},"response":[{"id":"48347036-e9f8-4330-8f8f-6b534d3c3172","name":"Enable Futures Trading For Account - Success","originalRequest":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n accountStatusFieldName: \"FUTURES_ENABLED\", \n enabled: true\n}"},"url":"https://api.valr.com/v1/margin/account/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 14 Nov 2023 19:09:59 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"17"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":null},{"id":"990743b2-a0a4-47e8-b91a-cac8e3c7aad4","name":"Enable Futures Trading For Account - Failed","originalRequest":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n accountStatusFieldName: \"FUTURES_ENABLED\", \n enabled: true\n}"},"url":"https://api.valr.com/v1/margin/account/status"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Tue, 14 Nov 2023 19:11:26 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"4"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"n/a"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -11418,\n \"message\": \"Proof of address is required to access this feature. Please log in and visit one of our futures pairs to complete registration.\"\n}"}],"_postman_id":"4a61cb88-cd27-49cb-b293-f480ea96e86a"},{"name":"Update Leverage","id":"d82d3b8e-fa6e-4043-8405-c04fac7e80e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Allows the user to update their Leverage for a specified currencyPair, to one of the available leverage options.
Specify the currency pair for which you would like to update maximum leverage for a subaccount.\nExample: ETHUSDTPERP
\n","type":"text/plain"},"type":"any","value":"","key":"currencypair"}]}},"response":[{"id":"a5e91916-77b2-4f25-ace8-6640da72c9d7","name":"Update Leverage (Valid Currency Pair)","originalRequest":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"leverageMultiple\": 10\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/margin/leverage/:currencypair","protocol":"https","host":["api","valr","com"],"path":["v1","margin","leverage",":currencypair"],"variable":[{"key":"currencypair","value":"BTCUSDTPERP","description":"Specify the currency pair for which you would like to update the leverage.\nExample: ETHUSDTPERP"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 26 Mar 2025 14:06:28 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"416"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":null},{"id":"a745ba78-20ea-4b9b-b216-12e9462ede5a","name":"Update Leverage (Invalid Currency Pair)","originalRequest":{"method":"PUT","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":"{\n \"leverageMultiple\": 10\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.valr.com/v1/margin/leverage/:currencypair","host":["https://api.valr.com"],"path":["v1","margin","leverage",":currencypair"],"variable":[{"key":"currencypair","value":"BTCUSDT","description":"Specify the currency pair for which you would like to update the leverage.\nExample: ETHUSDTPERP"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Wed, 26 Mar 2025 14:09:39 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"2"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -21,\n \"message\": \"Unsupported Currency Pair\"\n}"}],"_postman_id":"d82d3b8e-fa6e-4043-8405-c04fac7e80e7"}],"id":"805292c8-ed9f-455f-ac2f-0084f85e381c","description":"Make use of our Margin API to view in real time vital information for accounts with leverage positions.
\nThese APIs are protected and will require authentication. See the section on Authentication to learn how to authenticate your API calls.
Futures Overview
\nFutures trading is available to qualifying customers by jurisdiction.
\nA specific subaccount with futures trading enabled is cross-collateralised (cross margin), meaning that all assets within that subaccount that qualify as collateral (i.e. have a collateral weighting greater than zero) count towards account equity and can be used to collateralise futures positions. These assets will be called upon to settle position PnL in the event of liquidation.
\nFutures positions are currently one directional on VALR, meaning that a single account cannot hold both a long and short position for the same contract simultaneously. If you wish to hold positions in both directions, please split positions into different subaccounts.
\nAny number of subaccounts can be created and enabled for futures trading.\nAdditional Futures information: https://support.valr.com/hc/en-us/articles/11078306427420-Perpetual-Futures-Trading-Guide
\nAdditional Margin requirement information: https://support.valr.com/hc/en-us/articles/7531495382940-Margin-Trading-Guide
\nShould an account fall below maintenance margin, liquidation is triggered. VALR's liquidation engine is designed to bring an account below maintenance margin back to a healthy state, measured as recovering to above maintenance margin. The liquidation engine aims to carefully close down positions in the market, while minimising market impact and keeping markets orderly.
\nWhen an account's margin falls below maintenance margin, Stage 1 liquidation automatically triggers. Futures positions are closed piecemeal until the account is back above maintenance margin.
\nStage 2 liquidation is triggered if an account falls below auto-close margin. In stage 2, account positions are fully closed through auto-deleveraging (ADL). The consequence is that the trader loses their entire equity collateral for that account if that account falls below auto-close.
\nVALR holds an insurance fund as a final backstop for positions that are bankrupt.
\n","_postman_id":"805292c8-ed9f-455f-ac2f-0084f85e381c"},{"name":"Borrows","item":[{"name":"Borrows History","id":"3a2eb837-e3a2-4f69-8f8c-cdaacf70e50b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Returns a history of interest entries as calculated during the margin interest auction runs with the following detail:
\nInterest Auction
\nAt the beginning of every hour, our interest engine calculates the total borrow demand for each coin among all users.
\nAn auction is run by sorting the lending offers by minimum rate and taking the cheapest set that satisfies the borrowing demand.
The borrowing rate is set to the minimum of the required marginal (most expensive) loan.
Include only transactions in this currency
\n","type":"text/plain"},"type":"any","value":"BTC","key":"currencySymbol"}]}},"response":[{"id":"91e3ed50-32a4-449f-b0c6-9d413fc8634a","name":"Borrows History","originalRequest":{"method":"GET","header":[{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"url":{"raw":"https://api.valr.com/v1/borrows/:currencySymbol/history","host":["https://api.valr.com"],"path":["v1","borrows",":currencySymbol","history"],"variable":[{"key":"currencySymbol","value":"BTC"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Sun, 23 Apr 2023 10:38:50 GMT"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"content-type","value":"application/json"},{"key":"x-valr-upstream-service-time","value":"10"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"content-encoding","value":"gzip"},{"key":"vary","value":"Accept-Encoding"},{"key":"server","value":"envoy"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010096\",\n \"createdAt\": \"2023-04-23T10:00:00.098808Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100958\",\n \"createdAt\": \"2023-04-23T09:00:00.098889Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100956\",\n \"createdAt\": \"2023-04-23T08:00:00.098829Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100954\",\n \"createdAt\": \"2023-04-23T07:00:00.098894Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100952\",\n \"createdAt\": \"2023-04-23T06:00:00.098904Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010095\",\n \"createdAt\": \"2023-04-23T05:00:00.098927Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100948\",\n \"createdAt\": \"2023-04-23T04:00:00.098901Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100946\",\n \"createdAt\": \"2023-04-23T03:00:00.099385Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100944\",\n \"createdAt\": \"2023-04-23T02:00:00.099025Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100942\",\n \"createdAt\": \"2023-04-23T01:00:00.099076Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010094\",\n \"createdAt\": \"2023-04-23T00:00:00.098897Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100938\",\n \"createdAt\": \"2023-04-22T23:00:00.098988Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100936\",\n \"createdAt\": \"2023-04-22T22:00:00.098938Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100934\",\n \"createdAt\": \"2023-04-22T21:00:00.098905Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100932\",\n \"createdAt\": \"2023-04-22T20:00:00.098906Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010093\",\n \"createdAt\": \"2023-04-22T19:00:00.098987Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100928\",\n \"createdAt\": \"2023-04-22T18:00:00.098906Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100926\",\n \"createdAt\": \"2023-04-22T17:00:00.100467Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100924\",\n \"createdAt\": \"2023-04-22T16:00:00.099111Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100922\",\n \"createdAt\": \"2023-04-22T15:00:00.098939Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010092\",\n \"createdAt\": \"2023-04-22T14:00:00.098920Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100918\",\n \"createdAt\": \"2023-04-22T13:00:00.099039Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100916\",\n \"createdAt\": \"2023-04-22T12:00:00.098925Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100914\",\n \"createdAt\": \"2023-04-22T11:00:00.098903Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100912\",\n \"createdAt\": \"2023-04-22T10:00:00.098913Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010091\",\n \"createdAt\": \"2023-04-22T09:00:00.098897Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100908\",\n \"createdAt\": \"2023-04-22T08:00:00.098894Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100906\",\n \"createdAt\": \"2023-04-22T07:00:00.099143Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100904\",\n \"createdAt\": \"2023-04-22T06:00:00.098835Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100902\",\n \"createdAt\": \"2023-04-22T05:00:00.099033Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.001009\",\n \"createdAt\": \"2023-04-22T04:00:00.098982Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100898\",\n \"createdAt\": \"2023-04-22T03:00:00.099015Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100896\",\n \"createdAt\": \"2023-04-22T02:00:00.099020Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100894\",\n \"createdAt\": \"2023-04-22T01:00:00.098909Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100892\",\n \"createdAt\": \"2023-04-22T00:00:00.098995Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010089\",\n \"createdAt\": \"2023-04-21T23:00:00.099164Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100888\",\n \"createdAt\": \"2023-04-21T22:00:00.099061Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100886\",\n \"createdAt\": \"2023-04-21T21:00:00.099168Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100884\",\n \"createdAt\": \"2023-04-21T20:00:00.101106Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100882\",\n \"createdAt\": \"2023-04-21T19:00:00.099267Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010088\",\n \"createdAt\": \"2023-04-21T18:00:00.099007Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100878\",\n \"createdAt\": \"2023-04-21T17:00:00.099151Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100876\",\n \"createdAt\": \"2023-04-21T16:00:00.099246Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100874\",\n \"createdAt\": \"2023-04-21T15:00:00.099079Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100872\",\n \"createdAt\": \"2023-04-21T14:00:00.099059Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010087\",\n \"createdAt\": \"2023-04-21T13:00:00.098938Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100868\",\n \"createdAt\": \"2023-04-21T12:00:00.100289Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100866\",\n \"createdAt\": \"2023-04-21T11:00:00.099134Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100864\",\n \"createdAt\": \"2023-04-21T10:00:00.099143Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100862\",\n \"createdAt\": \"2023-04-21T09:00:00.100007Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010086\",\n \"createdAt\": \"2023-04-21T08:00:00.098912Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100858\",\n \"createdAt\": \"2023-04-21T07:00:00.099009Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100856\",\n \"createdAt\": \"2023-04-21T06:00:00.098955Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100854\",\n \"createdAt\": \"2023-04-21T05:00:00.099002Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100852\",\n \"createdAt\": \"2023-04-21T04:00:00.098928Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010085\",\n \"createdAt\": \"2023-04-21T03:00:00.098903Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100848\",\n \"createdAt\": \"2023-04-21T02:00:00.099133Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100846\",\n \"createdAt\": \"2023-04-21T01:00:00.099052Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100844\",\n \"createdAt\": \"2023-04-21T00:00:00.099115Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100842\",\n \"createdAt\": \"2023-04-20T23:00:00.099175Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010084\",\n \"createdAt\": \"2023-04-20T22:00:00.099113Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100838\",\n \"createdAt\": \"2023-04-20T21:00:00.099083Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100836\",\n \"createdAt\": \"2023-04-20T20:00:00.099231Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100834\",\n \"createdAt\": \"2023-04-20T19:00:00.099013Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100832\",\n \"createdAt\": \"2023-04-20T18:00:00.125740Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010083\",\n \"createdAt\": \"2023-04-20T17:00:00.699477Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100828\",\n \"createdAt\": \"2023-04-20T16:00:00.173860Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100826\",\n \"createdAt\": \"2023-04-20T15:00:00.174173Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100824\",\n \"createdAt\": \"2023-04-20T14:00:00.173732Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100822\",\n \"createdAt\": \"2023-04-20T13:00:00.173888Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010082\",\n \"createdAt\": \"2023-04-20T12:00:00.173709Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100818\",\n \"createdAt\": \"2023-04-20T11:00:00.173704Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100816\",\n \"createdAt\": \"2023-04-20T10:00:00.173800Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100814\",\n \"createdAt\": \"2023-04-20T09:00:00.173773Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100812\",\n \"createdAt\": \"2023-04-20T08:00:00.173785Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010081\",\n \"createdAt\": \"2023-04-20T07:00:00.173815Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100808\",\n \"createdAt\": \"2023-04-20T06:00:00.173966Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100806\",\n \"createdAt\": \"2023-04-20T05:00:00.173934Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100804\",\n \"createdAt\": \"2023-04-20T04:00:00.173909Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100802\",\n \"createdAt\": \"2023-04-20T03:00:00.173960Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.001008\",\n \"createdAt\": \"2023-04-20T02:00:00.173931Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100798\",\n \"createdAt\": \"2023-04-20T01:00:00.173906Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100796\",\n \"createdAt\": \"2023-04-20T00:00:00.173916Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100794\",\n \"createdAt\": \"2023-04-19T23:00:00.173826Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100792\",\n \"createdAt\": \"2023-04-19T22:00:00.177492Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010079\",\n \"createdAt\": \"2023-04-19T21:00:00.173907Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100788\",\n \"createdAt\": \"2023-04-19T20:00:00.285253Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100786\",\n \"createdAt\": \"2023-04-19T19:00:00.070541Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100784\",\n \"createdAt\": \"2023-04-19T18:00:00.266900Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100782\",\n \"createdAt\": \"2023-04-19T17:00:00.266986Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010078\",\n \"createdAt\": \"2023-04-19T16:00:00.068031Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100778\",\n \"createdAt\": \"2023-04-19T15:00:00.266802Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100776\",\n \"createdAt\": \"2023-04-19T14:00:00.266931Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100774\",\n \"createdAt\": \"2023-04-19T13:00:00.266983Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100772\",\n \"createdAt\": \"2023-04-19T12:00:00.266931Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.0010077\",\n \"createdAt\": \"2023-04-19T11:00:00.268639Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100768\",\n \"createdAt\": \"2023-04-19T10:00:00.068028Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100766\",\n \"createdAt\": \"2023-04-19T09:00:00.267201Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100764\",\n \"createdAt\": \"2023-04-19T08:00:00.287165Z\"\n },\n {\n \"currency\": \"BTC\",\n \"interestAmount\": \"0.00000002\",\n \"quantity\": \"0.00100762\",\n \"createdAt\": \"2023-04-19T07:00:00.140096Z\"\n }\n]"}],"_postman_id":"3a2eb837-e3a2-4f69-8f8c-cdaacf70e50b"}],"id":"f3e7aed4-972f-48c0-97ca-33e7235a3d92","description":"Make use of our Borrowings API to view your borrowing history
\nThese APIs are protected and will require authentication. See the section on Authentication above to learn how to authenticate your API calls.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
Your API Key
\n"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about Authentication above to learn how to generate this request signature.
\n"},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds).
\nExample: If the current date and time is December 28, 2019 00:00:00 UTC. then the Unix epoch time would be 1577491200000. Note that this timestamp is in milliseconds.
(required) Unique identifier for the bundle to retrieve.
\n","type":"text/plain"},"key":"bundleSymbol","value":"VALR3"},{"description":{"content":"Skip this number of results. (Default 0)
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Limit the results to this number. (Default and Max 100)
\n","type":"text/plain"},"key":"limit","value":"2"}],"variable":[]}},"response":[{"id":"3d06f7e7-c7a7-45ad-93bb-f02544b4a962","name":"Bundle Transaction History","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":""},"url":{"raw":"https://api.valr.com/v1/bundles/transactions?bundleSymbol=VALR3&skip=0&limit=2","host":["https://api.valr.com"],"path":["v1","bundles","transactions"],"query":[{"key":"bundleSymbol","value":"VALR3","description":"(required) Unique identifier for the bundle to retrieve."},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"2","description":"Limit the results to this number. (Default and Max 100)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"41"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Mon, 20 Oct 2025 04:39:12 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"019a4e2b-5dfa-799d-aa13-609d033693de\",\n \"symbol\": \"VALR10\",\n \"transactionType\": \"BUY\",\n \"payAmount\": 5.00000000,\n \"payCurrency\": \"USDT\",\n \"receiveAmount\": \"0.05431821\",\n \"receiveCurrency\": \"VALR10\",\n \"status\": \"complete\",\n \"createdAt\": 1762248056314,\n \"updatedAt\": 1762248057125\n },\n {\n \"id\": \"019a4e2a-c36a-76a4-85bc-8b536ab393ed\",\n \"symbol\": \"VALR10\",\n \"transactionType\": \"SELL\",\n \"payAmount\": 0.06000000,\n \"payCurrency\": \"VALR10\",\n \"receiveCurrency\": \"USDT\",\n \"status\": \"failed\",\n \"errorCode\": \"ORDER_PLACEMENT_FAILED\",\n \"createdAt\": 1762248016746,\n \"updatedAt\": 1762248026842\n }\n]"},{"id":"5a60282d-00b3-4b60-a23e-dd4f77a458ec","name":"Bundle Transaction History - Invalid fund","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-VALR-API-KEY","value":"b9fb68df5485639d03c3171cf6e49b89e52fd78d5c313819b9c592b59c689f33","description":"Your API Key"},{"key":"X-VALR-SIGNATURE","value":"{{requestSignature}}","description":"Request Signature generated for this request. See section about **Authentication** above to learn how to generate this request signature."},{"key":"X-VALR-TIMESTAMP","value":"{{requestTimestamp}}","description":"The same timestamp used to generate the request signature (in Unix epoch time format, in milliseconds). \n\nExample: If the current date and time is `December 28, 2019 00:00:00 UTC`. then the Unix epoch time would be `1577491200000`. Note that this timestamp is in milliseconds."}],"body":{"mode":"raw","raw":""},"url":{"raw":"https://api.valr.com/v1/bundles/transactions?bundleSymbol=VALR4&skip=0&limit=2","host":["https://api.valr.com"],"path":["v1","bundles","transactions"],"query":[{"key":"bundleSymbol","value":"VALR4","description":"(required) Unique identifier for the bundle to retrieve."},{"key":"skip","value":"0","description":"Skip this number of results. (Default 0)"},{"key":"limit","value":"2","description":"Limit the results to this number. (Default and Max 100)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"Deny"},{"key":"content-security-policy","value":"default-src 'none'"},{"key":"x-valr-upstream-service-time","value":"10"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains; preload"},{"key":"vary","value":"Origin, Accept-Encoding"},{"key":"content-encoding","value":"gzip"},{"key":"date","value":"Mon, 20 Oct 2025 04:39:31 GMT"},{"key":"server","value":"envoy"},{"key":"via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"[]"}],"_postman_id":"5225c39d-fcd9-4fcb-beae-ced499a6bf8d"}],"id":"74d82f5e-a7d6-4ff8-82cc-5fb3ecd225c3","description":"Make use of our Bundles API to buy, sell, and manage your asset bundles programmatically on the primary market.
\nThese APIs are protected and will require authentication. See the section on Authentication above to learn how to authenticate your API calls.
\nNote: All primary market bundles transactions are settled exclusively in the bundle's referenceCurrency.
\nNOTE: To get notified about updates to the changelog, please click on the \"Follow\" button on this Help Center section: API Changelog
04 May 2026
\nUpdated Current API Key Info description to include Link Bank Account permission
Removed Beta warning message for LIMIT Post Only Reprice
\nAdded ONE-TIME TOKEN (OTT) FOR THIRD-PARTY INTEGRATIONS to generate a One-Time Token (OTT) from your VALR account and provide it to a third-party service. The third party uses this token to request an API key by calling POST /v1/partner/exchange with the body { \"ottToken\": \"your-token-here\" }. In response, they receive an API key and secret. The OTT is single-use and becomes invalid immediately after it is exchanged.
/v1/partner/exchangeAddition of TWAP Feature
TWAP order — splits a large order into smaller sub-orders executed at regular intervals over a set duration.
New TWAP feature API Endpoints
\nPOST /v1/twap – Place a TWAP order.
GET /v1/twap/active – This API returns all active and pending trigger TWAP orders.
\nGET /v1/twap/historic – This API returns all completed and cancelled TWAP orders.
GET /v1/twap/suborder/:currencyPair/:orderId/history – Returns the execution history of individual sub-orders for a specific TWAP order. Supports pagination and time filtering.
GET /v1/twap/:currencyPair/:orderId – Cancels the remaining suborders of an active/untriggered TWAP order.
19 Mar 2026
\n06 Mar 2026
\n19 Feb 2026
\nUpdate support for withdrawal decimal places to reflect the actual decimal places that will be used for the on-chain transaction. Updates the following routes:
\n/v1/public/currencies
\n/v1/wallet/crypto/:currencyCode/withdraw
\nPrevious behaviour: Withdrawals with arbitrarily scaled values were always truncated to 2 decimal places for stablecoins.
\nNew behaviour: values that are specified during withdrawals will be used for the on-chain transaction. Values with a larger scale than withdrawDecimalPlaces will be rounded down to withdrawDecimalPlaces for the appropriate network configuration.
12 Feb 2026
\nRelease Type: Feature Enhancement
\nSpot trading now supports conditional orders using the following endpoints:
\n/v1/orders/conditionals
/v1/orders/conditionals/conditional/:currencyPair/orderid/:orderId
/v1/orders/conditionals/:currencyPair/history
/v1/orders/conditionals/modify
/v1/orders/conditionals/:currencyPair
/v1/orders/conditionals/conditional
These endpoints support OCO (One-Cancels-the-Other) and OTOCO (One-Triggers-One-Cancels-the-Other) order types. Users can submit take profit or stop loss conditions independently, with no requirement to include both in a single conditional order.
The existing Stop Limit routes will be deprecated in a future release in favour of these Conditional Order routes.
Required Fields:
\"allowMargin\"
\"side\"
\"quantity\"
\"triggerType\"
\"pair\"
\"stopLossTriggerPrice\"
\"stopLossOrderPrice\"
\"takeProfitTriggerPrice\"
\"takeProfitOrderPrice\"
\"customerOrderId\"
Features:
Create, modify, query, and retrieve the history of Spot conditional orders.
Fully backward-compatible with existing Spot trading operations.
17 Nov 2025
\nAddition of Bundles Feature
\nBundles is a cryptocurrency investment feature that allows users to invest in pre-configured portfolios of multiple cryptocurrencies, providing a passive, index-style investment approach with diversified exposure. Bundles are pre-configured and rebalanced automatically based on parameters set by the fund manager (e.g., monthly).
\nNew API Endpoints
\nPOST /v1/bundles/buy – Purchase a bundle on the primary market
POST /v1/bundles/sell – Sell a bundle on the primary market
GET /v1/bundles/transactions?bundleSymbol= – List primary market transactions for a specific bundle
GET /v1/bundles/all – Retrieve all bundles and their current market details
30 October 2025
\nUsers are now able to unsubscribe from these Account WebSocket events:
\nBALANCE_UPDATE
OPEN_ORDERS_UPDATE
MARGIN_INFO
12 August 2025
\n24 July 2025
\nREST API Changes
\nGET /v1/positions/open, will now contain a new field leverageTier which indicates the leverage tier for each open position.WebSocket Messages
\nUpdate to the existing WS OPEN_POSITION_UPDATE, will now contain a new field leverageTier which indicates the leverage tier for each open position.
New WS PNL_RUN_COMPLETED, sent when a PNL (Profit and Loss) run is completed for subscribed currency pairs.
New WS FUNDING_RUN_COMPLETED, sent when a funding run is completed for subscribed currency pairs.
New WS LEVERAGE_UPDATED, while subscribed to this, the user will receive real time updates when the leverage is changed for a currency pair.
8 July 2025
\nAdded a new GET Price Buckets for a currency pair endpoint (https://api.valr.com/v1/public/:currencyPair/buckets). This API provides historical market data aggregated into time-based \"buckets\" (candles) for a specified currency pair and bucket period.
Each bucket returned includes open, high, low, close, volume, and quoteVolume for the defined time interval.
The periodSeconds query parameter supports values of 60 (default), 300, 900, 1800, 3600, 21600, and 86400 (maximum).
Introduced an optional includeEmpty query parameter (defaulting to false) to include buckets where no trading activity occurred. For such buckets, open, high, low, and close prices will be identical (reflecting the last traded price), and volume and quoteVolume will be zero.
3 July 2025
\n29 May 2025
\nUpdated the documentation for the GET route /v1/account/transactionhistory?skip=0&limit=100&transactionTypes=SIMPLE_BUY,LIMIT_BUY,MARKET_BUY¤cy=ZAR&startTime=2020-02-29T22:00:00.000Z&endTime=2021-04-30T21:59:59.999Z to include the following transaction types:
FUND
FIAT_WITHDRAWAL_FEE_REVERSAL
CREDIT_CARD_DEPOSIT
SPOT_BORROW_INTEREST_CHARGE
SPOT_LEND_INTEREST_PAYMENT
LIQUIDATION_LIMIT_BUY
LIQUIDATION_LIMIT_SELL
LIQUIDATION_TAKEOVER_ASSET_TRANSFER
LIQUIDATION_TAKEOVER_DEBT_TRANSFER
FUTURES_FUNDING_EARNED
FUTURES_FUNDING_PAID
FUTURES_PNL_PROFIT
FUTURES_PNL_LOSS
FUTURES_TRADE_FEE
COLLATERAL_CONVERSION_LIMIT_BUY
COLLATERAL_CONVERSION_LIMIT_SELL
Added a GET and PUT route /v1/margin/leverage/:currencypair to the Futures folder. This route already exist in Margin folder and has been duplicated to the Futures folder for convenience.
28 May 2025
\nearnType documentation to expose DeFi lending functionality.20 May 2025
\nallowBorrow:/v1/account/subaccounts/transfer/v1/wallet/crypto/:currencyCode/withdraw/v1/wallet/fiat/:currencyCode/withdraw09 May 2025
\n/v1/loans/rates/history?currencySymbol= which returns the rate history and loan book utilisation from previous auctions.10 April 2025
\n/v1/pay/transactionid/:transactionId/partial-reverse which allows a payment recipient to partially reverse a VALR Pay transaction.31 March 2025
\nAdded a new route GET /v1/wallet/crypto/service-providers which returns a list of all the supported service providers for use when performing a crypto withdrawal.
Updated New Withdrawal documentation describing how to use Beneficiary information when performing a new crypto withdrawal. Beneficiary information will be mandatory after 30 April 2025.
27 March 2025
\nAdded a GET public route /v1/public/risklimit/:currencypair which provides the available leverage options for a requested currency pair.
Added a GET to Margin route /v1/margin/leverage/:currencypair which returns the leverage information for a requested subaccount.
Added a PUT to the route /v1/margin/leverage/:currencypair which allows the user to update the maximum leverage for a subaccount.
05 March 2025
\nAdded a new public route /v1/public/loans/info returning loan info per currency supporting lending
Added support for clientMsgId parameter to Account Web Sockets to correlate requests and responses
13 February 2025
\nAdded the V2 API / Brokerage Instructions API
Added a new MARGIN_INFO event (beta) on the ACCOUNT websocket
5 February 2025
\nAdded a new route /v1/wallet/crypto/withdraw/history to retrieve an account's withdrawal history with currency as an optional query parameter. startTime and endTime (ISO 8601) can be used for additional time-based filtering. The existing route /v1/wallet/crypto/:currencyCode/withdraw/history remains functional but is now deprecated.
Added a new route /v1/wallet/crypto/deposit/history to retrieve an account's deposit history with currency as an optional query parameter. startTime and endTime (ISO 8601) can be used for additional time-based filtering. The existing route /v1/wallet/crypto/:currencyCode/deposit/history remains functional but is now deprecated.
27 January 2025
\n/v1/orders/modify Modify REPRICE has been added.21 January 2025
\nGET /v1/orders/history now returns totalExecutedQuantity
GET /v1/orders/history/summary/orderid/:orderId now returns totalExecutedQuantity
GET /v1/orders/history/summary/customerorderid/:customerOrderId now returns totalExecutedQuantity
6 January 2025
\n/v1/account/tradehistory to get an account's trading history without specifying a currency pair.9 December 2024
\nPOST /v1/account/subaccounts/transfer now returns the transfer ID
Transaction history items of type INTERNAL_TRANSFER now includes a transferId field
25 October 2024
\nAdd a new route /v1/loans to create a new loan.
Add a new route /v1/loans/open to view your open loans.
Add a new route /v1/loans/credit-history?currencySymbol=symbol to view previous loans.
Add a new route /v1/loans/increase to increase loan amount.
Add a new route /v1/loans/rate to update your loan's rate.
Add a new route /v1/loans/update-history?currencySymbol=symbol to view the history of your loan updates.
Add a new route /v1/loans/unlock to request an unlock and to cancel a request to unlock a loaned amount.
Futures limit and market orders now support conditionalOrderData which can be used to add Stop Loss and/or Take Profit orders.
Add a new route /v1/orders/conditionals/:currencyPair/history to fetch conditional orders by pair.
Add a new route /v1/orders/conditionals/conditional/:currencyPair/orderid/:orderId to fetch conditional orders by pair and an order ID.
Add a new route /v1/orders/conditionals/modify to modify conditional orders.
Add deposit and withdraw fields in supported networks to /v1/public/currencies
23 October 2024
\n18 September 2024
\nreduceOnly flag information to limit and market orders.30 August 2024
\nOrder Types route /v1/public/ordertypes now supports the includeInactivePairs query parameter to allow excluding inactive pairs from the result
Add rate-limited sample messages to websockets
\n16 August 2024
\nOrder history route /v1/orders/history now includes statuses filter.
Trade history route /v1/account/:currencyPair/tradehistory now includes skip param.
Increased rate limits for websocket write requests to match current http rate limits.
\n07 August 2024
\nBATCH_ORDERS22 July 2024
\nRead and Write.18 July 2024
\n/v1/account/subaccount to rename subaccount labels.15 July 2024
\n02 July 2024
\nAdded a new route /v1/account/transactionhistory/subaccounts to expose subaccount transaction history.
Add a new route /v1/account/subaccount to DELETE subaccounts
26 June 2024
\n14 June 2024
\nAdded the following new events (alpha) on the TRADE websocket:
OB_L1_DIFF
OB_L1_D1_SNAPSHOT
OB_L1_D5_SNAPSHOT
OB_L1_D10_SNAPSHOT
OB_L1_D20_SNAPSHOT
OB_L1_D40_SNAPSHOT
OB_L1_D80_SNAPSHOT
Added UNSUBSCRIBE event on the ACCOUNT websocket.
Split Websocket section into Trade and Account
04 June 2024
\nAdded the /v1/conditionals route to enable GET , POST and DELETE take profit and stop loss (conditional) orders for futures positions.
Added the following new events on the ACCOUNT websocket for futures trades: ADD_CONDITIONAL_ORDER, REMOVE_CONDITIONAL_ORDER, OPEN_POSITION_UPDATE, REDUCE_POSITION and POSITION_CLOSED
Added the ability to place, modify and cancel orders on the ACCOUNT websocket.
Added the CANCEL_ON_DISCONNECT event on the ACCOUNTS websocket.
Open Orders call now includes allowMargin flag to easily identify open margin orders.
Added the currency pair by type public endpoint /v1/public/pairs/:type - to list currency pairs by either Futures or Spot.
Exposed the wallet send costs and minimum withdraw amounts for currencies on the public route /v1/public/currencies
Refined the descriptions and examples for Limit Only Reprice, Margin Information.
\nRefined the authentication Requirements in Getting Started section.
\n12 February 2024
\nside and TimeInForce for Limit Orders and Stop Limit Orders.06 December 2023
\n/v1/public/futures/funding/history to expose the Futures funding rate history.05 December 2023
\nUpdated per second rate limits to reflect new limits.
\nAdded the positionId field for Futures positions
Added V2 API requests
\nModify Limit Order (Beta) - /v2/orders/modify
Account Margin Information - /v2/margin/status
Updated V1 Order History API - v1/orders/history
startTime and endTime date filters can now be used.27 November 2023
\n/v1/public/currencies responses now include the supported and default blockchain network types for deposits and withdrawals, per currency. The network type can also be supplied when creating an address book address.
NOTE: Due to the sensitive nature of withdrawals and deposits, providing the network type will become mandatory for all currencies that support more than one network for withdrawals and deposits from 1 April 2024.
\nUpdated API's
\n/v1/public/currencies
/v1/wallet/crypto/:currencyCode/deposit/address
/v1/wallet/crypto/:currencyCode/deposit/history
/v1/wallet/crypto/address-book
/v1/wallet/crypto/address-book/:currencyCode
/v1/wallet/crypto/:currencyCode/withdraw
/v1/wallet/crypto/:currencyCode/withdraw/:withdrawId
/v1/wallet/crypto/:currencyCode/withdraw/history
15 November 2023
\nAdded the following updates to enable Futures Trading via the API :
\n/v1/public/futures/info - which returns contract details of perpetual Futures contracts
/v1/positions/open - which returns open Futures contracts for an account
/v1/positions/closed/summary - which returns a summary of closed Futures contracts
/v1/positions/closed?currencyPair - which returns a detailed view of closed Futures contracts per Futures pair
/v1/positions/history?currencyPair - which returns a history of Futures contracts held by an account
/v1/positions/funding/history?currencyPair - a history of funding
/v1/margin/account/status - to enable an account for Futures trading using the endpoint
Added an example of the MARK_PRICE_UPDATE event on the TRADE websocket
09 November 2023
\nAdded the /v1/orders/modify to modify open and partially filled Limit Orders
Added MODIFY_ORDER_OUTCOME event to the Account Websocket
Updated the OPEN_ORDERS_UPDATE Websocket event to include the Order Modified status
Added Margin trading to the /v1/orders/limit and /v1/orders/market
Added /v1/public/:currencyPair/markprice/buckets which returns Mark Price buckets for a given currency pair
Added Limit Order Reprice to /v1/orders/limit
Updated Trade History /v1/account/:currencyPair/tradehistory?limit=10 to include fees and rewards
30 October 2023
\n/v1/account/fees/trade request to list all trade fees per currency pair10 October 2023
\n/v1/account/subaccounts/transfer18 September 2023
\nFULL_ORDERBOOK_UPDATE web socket documentation.18 August 2023
\n28 July 2023
\n14 July 2023
\n15 May 2023
\nDocumented new websocket connections rate limit
\nUpdated the /v1/balances request with query parameterexcludeZeroBalances to return non zero balances only
Updated theBALANCE_UPDATE Websocket event to include the following fields: totalInReference , totalInReferenceWeighted andreferenceCurrency
Updated pre-request script and documentation to support the yourSubAccountId environment variable. This allows impersonating an account with every request.
06 March 2023
\nAdded a request to link a new fiat bank account
\nAdded a request for linked fiat bank account details
\nAdded a request to delete a linked fiat bank account
\nAdded a request to list all banks supported for fiat withdrawals per currency
\nAdded a request to get an auto-buy reference for buying a currency with a fiat deposit
\nAdded a request to list all currencies supported for auto-buy per fiat currency
\n03 March 2023
\n25 November 2022
\n/v1/batch/orders and /v1/orders.17 November 2022
\nAdded the Caching section.
\nAdded the collateral and collateralWeight fields to - v1/public/currencies which are reserved for future use.
Added marginTradingAllowed to the /v1/public/pairs endpoint, reserved for future use.
Added the MARK_PRICE_UPDATE event to the Trade Websocket
Updated the BALANCE_UPDATE Websocket event to include the following fields that are reserved for future use: collateral, collateralWeight, lendReserved, borrowCollateralReserved, borrowedAmount
Updated the NEW_ACCOUNT_HISTORY_RECORD Websocket event to include the following fields that are reserved for future use: collateral, collateralWeight
19 August 2022
\nClarify that per minute and per second rate limits do not interact.
\nAdd examples for stop orders to the Exchange Buy/Sell API.
\nIncrease subaccount limit to 2000 per main account.
\n18 August 2022
\nAdded /v1/orders request to cancel all open orders.
Added /v1/orders/:currencyPair to cancel all open orders for the given currency pair.
04 August 2022
\n/v1/batch/orders and /v1/orders20 July 2022
\n11 July 2022
\n27 June 2022
\n/v1/batch/orders and /v1/orders.12 June 2022
\nThe Market Summary APIs /v1/public/marketsummary and /v1/public/:currencyPair/marketsummary now return a markPrice field, which is reserved for future use.
The Balances API /v1/account/balances now returns the following additional fields, which are reserved for future use.
lendReserved
borrowReserved
borrowedAmount
The Simple Buy/Sell Quote API v1/simple/:currencyPair/quote now returns an array of ordersToMatch, which includes price and quantity; if they exist.
9 May 2022
\nChecksum field.8 February 2022
\nAdded the FULL_ORDERBOOK_UPDATE Trade WebSocket stream. Please note that this is an alpha feature and may change in ways that are not backwards-compatible. We value any feedback! Please send your feedback to support@valr.com
\nThe following APIs now include a \"SequenceNumber\" field on the returned order book:
/public/:currencyPair/orderbook
/public/:currencyPair/orderbook/full
/marketdata/:currencyPair/orderbook
/marketdata/:currencyPair/orderbook/full
14 December 2021
\nAdded the Wire Transfers API to facilitate USD wire bank accounts deposits and withdrawals. (/v1/wire)
Added the VALR Pay API (/v1/pay) for initiating payments, getting payment details and history.
Added the Deposit Reference API to enable retrieval of Deposit reference by subaccounts.(/v1/fiat/:currencyCode/deposit/reference)
31 October 2021
\nAdded the following APIs for interaction with subaccounts:
\n(account/balances/all) - returns all non zero balances for the portfolio.
(account/subaccounts) - returns all subaccounts that belong to a primary account.
(account/subaccount) - register a new subaccount.
(account/subaccounts/transfer) - transfer between subaccounts.
Updated the Authentication section to include the X-VALR-SUB-ACCOUNT-ID header for subaccount impersonation.
Updated the rate limit for authenticated API calls.
\n15 September 2021
\n/account/api-keys/current) which returns the currently authorised API key's information and permissions.23 August 2021
\n20 June 2021
\n08 February 2021
\nA Stop Limits API (/orders/stop/limit) is now available to place STOP_LOSS_LIMIT and TAKE_PROFIT_LIMIT orders.
Limit Orders (/orders/limit) POST request now accepts timeInForce as an optional parameter. (GTC, FOK, IOC)
Time in Force (GTC, FOK, IOC) field is now included in GET responses of the following APIs:
Open Order (/orders/open)
Order History (/orders/history)
Order Status (/orders/history/detail/)
New order types of: STOP_LOSS_LIMIT and TAKE_PROFIT_LIMIT added to applicable Currency Pairs for the following Public APIs:
Public Order Types (/public/ordertypes)
Public Currency Pairs (/public/:currencyPair/ordertypes)
Updated example for Public Currency pairs (/publiirs) API with fields tickSize and baseDecimalPlaces for each traded currency pair.
Updated example for for all TransactionId API requests (/account/transactionhistory) with the id field in the response.
Updated documentation for Trade History API. (`/account/:currencyPair
\n02 February 2021
\nThe Order API (/orders/open) now includes the following fields in GET responses:
updatedAt, status, type
Updated the Order History APIs (/orders/history) to include the feeCurrency field.
Examples for Order History Detail APIs (/orders/history/detail/) updated to include the fields:
executedFee
executedQuantity
executedPrice
29 November 2020
\nCrypto withdrawals created (/wallet/crypto/:currencyCode/withdraw) with more decimals than the number of decimals supported by the currency will be truncated.
The Currencies list (/public/currencies) now includes the following new fields:
decimalPlaces
withdrawalDecimalPlaces
Withdrawal Info (/wallet/crypto/:currencyCode/withdraw) now includes the following new field:
withdrawalDecimalPlacesA Public Trade History for a currency pair API (/public/:currencyPair/trades) is now available and can be filtered by the skip, limit, startTime, endTime and beforeId parameters. This is similar to Transaction History filtering.
A Public Non-aggregated Order Book API (public/:currencyPair/orderbook/full) is now available.
A Whitelisted Withdrawal Address Book API (/wallet/crypto/address-book and /wallet/crypto/address-book/:currencyCode) returning whitelisted addresses is now available.
06 September 2020
\nAsks and Bids on exchange order books: The number of Asks and Bids sent via our Order Book APIs has been increased from 20 each to 40 each.
\nOrder History Detail APIs (/orders/history/detail/) now include the following new fields:
executedFee
executedQuantity
executedPrice
12 July 2020
\nx-valr-ratelimited: true will be returned.31 May 2020
\nSeparated the API and Website web socket sessions. WebSockets which were connected via the API will no longer be closed when the user logs out of the VALR website.
\nWhen a PING message is received on the Trade WebSocket, a response with NO_SUBSCRIPTIONS in the PONG will be sent, if the user has not subscribed to any message types.
When a user connects and authenticates to the Account WebSocket, all account balances and open orders associated with the user account will be sent in the response. One BALANCE_UPDATE message for each asset held and one OPEN_ORDERS_UPDATE message containing all open orders on the account, across all order books will be sent.
The BALANCE_UPDATE web socket message now includes an updatedAt field.
The REST GET Balances response (https://api.valr.com/v1/account/balances) now includes an updatedAt field for each asset held.
Added the REST GET VALR Status (https://api.valr.com/v1/public/status) request which will indicate whether the API is \"online\" or in \"read-only\" mode. In \"read-only\" mode, only GET and OPTIONS requests are accepted. The \"read-only\" mode is sometimes necessary during maintenance.
The filledPercentage field on open orders is now accurate to two decimal places.
The REST GET Order Book. (https://api.valr.com/v1/marketdata/:currencyPair/orderbook) response and the REST GET Order Book. (Non aggregated) (https://api.valr.com/v1/marketdata/:currencyPair/orderbook/full) response now include a LastChange field, indicating the timestamp of the last update to the order book.
The AGGREGATED_ORDERBOOK_UPDATE message on the Trade web socket now includes a LastChange field, indicating the timestamp of the last update to the order book.
Get the current status of V2 API.
\nA 200 response indicates that the V2 API is available.
\nWhen VALR status is \"read-only\" all POST and DELETE requests on the V2 API will return a 503 response. Please see Public/VALR Status for more information.