Send Outcome Action REST API Endpoint

info

Exchange API calls do not consume Quicknode API credits. Transactions through this endpoint are appended with a builder fee. See hyperliquidapi.com for a full breakdown. To white-label with your own builder code, contact us.

This endpoint is not a drop-in replacement for Hyperliquid's native /exchange endpoint. See the Exchange API Overview for key differences.

Body Parameters

action

object

REQUIRED

Loading...

type

string

Loading...

splitOutcome

object

Loading...

mergeOutcome

object

Loading...

mergeQuestion

object

Loading...

negateOutcome

object

Loading...

nonce

integer

REQUIRED

Loading...

signature

object

REQUIRED

Loading...

r

string

Loading...

s

string

Loading...

v

integer

Loading...

Returns

success

boolean

Loading...

user

string

Loading...

exchangeResponse

object

Loading...

Request

1
curl -s -X POST https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "action": {
5
    "type": "userOutcome",
6
    "splitOutcome": {
7
      "outcome": 1,
8
      "amount": "10"
9
    }
10
  },
11
  "nonce": 1234567890,
12
  "signature": {
13
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
14
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
15
    "v": 28
16
  }
17
}'
18

1
curl -s -X POST https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "action": {
5
    "type": "userOutcome",
6
    "splitOutcome": {
7
      "outcome": 1,
8
      "amount": "10"
9
    }
10
  },
11
  "nonce": 1234567890,
12
  "signature": {
13
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
14
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
15
    "v": 28
16
  }
17
}'
18

1
const axios = require('axios');
2

3
const data = {
4
  action: {
5
    type: "userOutcome",
6
    splitOutcome: {
7
      outcome: 1,
8
      amount: "10"
9
    }
10
  },
11
  nonce: 1234567890,
12
  signature: {
13
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
14
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
15
    v: 28
16
  }
17
};
18

19
axios.post('https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange', data, {
20
  headers: { 'Content-Type': 'application/json' }
21
})
22
.then(response => console.log(response.data))
23
.catch(error => console.error(error));
24

1
const axios = require('axios');
2

3
const data = {
4
  action: {
5
    type: "userOutcome",
6
    splitOutcome: {
7
      outcome: 1,
8
      amount: "10"
9
    }
10
  },
11
  nonce: 1234567890,
12
  signature: {
13
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
14
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
15
    v: 28
16
  }
17
};
18

19
axios.post('https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange', data, {
20
  headers: { 'Content-Type': 'application/json' }
21
})
22
.then(response => console.log(response.data))
23
.catch(error => console.error(error));
24

1
import requests
2
import json
3

4
url = "https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange"
5
payload = json.dumps({
6
  "action": {
7
    "type": "userOutcome",
8
    "splitOutcome": {
9
      "outcome": 1,
10
      "amount": "10"
11
    }
12
  },
13
  "nonce": 1234567890,
14
  "signature": {
15
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
16
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
17
    "v": 28
18
  }
19
})
20
headers = { 'Content-Type': 'application/json' }
21
response = requests.request("POST", url, headers=headers, data=payload)
22
print(response.text)
23

1
import requests
2
import json
3

4
url = "https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange"
5
payload = json.dumps({
6
  "action": {
7
    "type": "userOutcome",
8
    "splitOutcome": {
9
      "outcome": 1,
10
      "amount": "10"
11
    }
12
  },
13
  "nonce": 1234567890,
14
  "signature": {
15
    "r": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
16
    "s": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
17
    "v": 28
18
  }
19
})
20
headers = { 'Content-Type': 'application/json' }
21
response = requests.request("POST", url, headers=headers, data=payload)
22
print(response.text)
23

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange")
6
https = Net::HTTP.new(url.host, url.port)
7
https.use_ssl = true
8
request = Net::HTTP::Post.new(url)
9
request["Content-Type"] = "application/json"
10
request.body = JSON.dump({
11
  action: {
12
    type: "userOutcome",
13
    splitOutcome: {
14
      outcome: 1,
15
      amount: "10"
16
    }
17
  },
18
  nonce: 1234567890,
19
  signature: {
20
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
21
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
22
    v: 28
23
  }
24
})
25
response = https.request(request)
26
puts response.read_body
27

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/hypercore/exchange")
6
https = Net::HTTP.new(url.host, url.port)
7
https.use_ssl = true
8
request = Net::HTTP::Post.new(url)
9
request["Content-Type"] = "application/json"
10
request.body = JSON.dump({
11
  action: {
12
    type: "userOutcome",
13
    splitOutcome: {
14
      outcome: 1,
15
      amount: "10"
16
    }
17
  },
18
  nonce: 1234567890,
19
  signature: {
20
    r: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
21
    s: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
22
    v: 28
23
  }
24
})
25
response = https.request(request)
26
puts response.read_body
27

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free