Polymarket API

https://docs.polymarket.com/api-reference
Admin
Polymarket API provides programmatic access to the world's largest prediction market through three...
Tokens:640,382
Snippets:2,897
Trust Score:9.9
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Go net/http example for GET /data/trades

Source: https://docs.polymarket.com/api-reference/trade/get-trades

Go example using net/http to GET /data/trades with required POLY_* headers. Prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://clob.polymarket.com/data/trades"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("POLY_API_KEY", "<api-key>")
	req.Header.Add("POLY_ADDRESS", "<api-key>")
	req.Header.Add("POLY_SIGNATURE", "<api-key>")
	req.Header.Add("POLY_PASSPHRASE", "<api-key>")
	req.Header.Add("POLY_TIMESTAMP", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Example response for GET /nonce

Source: https://docs.polymarket.com/api-reference/relayer/get-current-nonce-for-a-user

Example response for a successful GET /nonce request. Returns the current nonce value as a string.

```json
{
  "nonce": "31"
}
```

--------------------------------

### GET /v2/biggest-winners client examples

Source: https://docs.polymarket.com/api-reference/boards/list-the-biggest-wins

Client examples for the GET /v2/biggest-winners endpoint. Each snippet performs a GET request to the same URL and prints or returns the response body. The cURL example uses the --request GET flag; the Python example uses the requests library; the JavaScript example uses fetch; the PHP example uses cURL with CURLOPT_CUSTOMREQUEST "GET"; the Go example uses net/http; the Java example uses Unirest; the Ruby example uses net/http with SSL enabled.

```bash
curl --request GET \
  --url https://data-api.polymarket.com/v2/biggest-winners
```

```python
import requests

url = "https://data-api.polymarket.com/v2/biggest-winners"

response = requests.get(url)

print(response.text)
```

```javascript
const options = {method: 'GET'};

fetch('https://data-api.polymarket.com/v2/biggest-winners', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://data-api.polymarket.com/v2/biggest-winners",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://data-api.polymarket.com/v2/biggest-winners"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://data-api.polymarket.com/v2/biggest-winners")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://data-api.polymarket.com/v2/biggest-winners")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

--------------------------------

### Go example for GET /events/slug/{slug}

Source: https://docs.polymarket.com/api-reference/events/get-event-by-slug

Go example using net/http to GET an event by slug. Prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://gamma-api.polymarket.com/events/slug/{slug}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Java Unirest example for GET /data/trades

Source: https://docs.polymarket.com/api-reference/trade/get-trades

Java example using Unirest to GET /data/trades with required POLY_* headers.

```java
HttpResponse<String> response = Unirest.get("https://clob.polymarket.com/data/trades")
  .header("POLY_API_KEY", "<api-key>")
  .header("POLY_ADDRESS", "<api-key>")
  .header("POLY_SIGNATURE", "<api-key>")
  .header("POLY_PASSPHRASE", "<api-key>")
  .header("POLY_TIMESTAMP", "<api-key>")
  .asString();
```

--------------------------------

### GET /v2/trades in cURL, Python, JavaScript, PHP, Go, Java, Ruby

Source: https://docs.polymarket.com/api-reference/feeds/list-trades

These examples show how to make a GET request to the Polymarket data API endpoint /v2/trades using various languages. Each snippet performs the same request and prints or returns the response. The cURL example uses the --request GET flag and the URL directly. The Python example uses the requests library. The JavaScript example uses fetch. The PHP example uses cURL with CURLOPT_URL and CURLOPT_RETURNTRANSFER. The Go example uses net/http and io.ReadAll. The Java example uses Unirest. The Ruby example uses net/http with SSL enabled.

```bash
curl --request GET \
  --url https://data-api.polymarket.com/v2/trades
```

```python
import requests

url = "https://data-api.polymarket.com/v2/trades"

response = requests.get(url)

print(response.text)
```

```javascript
const options = {method: 'GET'};

fetch('https://data-api.polymarket.com/v2/trades', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://data-api.polymarket.com/v2/trades",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://data-api.polymarket.com/v2/trades"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://data-api.polymarket.com/v2/trades")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://data-api.polymarket.com/v2/trades")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

--------------------------------

### GET /v1/info/leaderboard request examples

Source: https://docs.polymarket.com/api-reference/get-leaderboard

Example requests to the GET /v1/info/leaderboard endpoint with query parameters window=day and sort_by=pnl, shown in cURL, Python, JavaScript, PHP, Go, Java (Unirest), and Ruby. Each snippet performs a GET request and prints or returns the response body.

```bash
curl --request GET \
  --url 'https://api.perpetuals.polymarket.com/v1/info/leaderboard?window=day&sort_by=pnl'
```

```python
import requests

url = "https://api.perpetuals.polymarket.com/v1/info/leaderboard?window=day&sort_by=pnl"

response = requests.get(url)

print(response.text)
```

```javascript
const options = {method: 'GET'};

fetch('https://api.perpetuals.polymarket.com/v1/info/leaderboard?window=day&sort_by=pnl', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.perpetuals.polymarket.com/v1/info/leaderboard?window=day&sort_by=pnl",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.perpetuals.polymarket.com/v1/info/leaderboard?window=day&sort_by=pnl"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.perpetuals.polymarket.com/v1/info/leaderboard?window=day&sort_by=pnl")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.perpetuals.polymarket.com/v1/info/leaderboard?window=day&sort_by=pnl")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

--------------------------------

### JavaScript fetch example for GET /data/trades

Source: https://docs.polymarket.com/api-reference/trade/get-trades

JavaScript example using fetch to GET /data/trades with required POLY_* headers. Replace <api-key> placeholders with actual values.

```javascript
const options = {
  method: 'GET',
  headers: {
    POLY_API_KEY: '<api-key>',
    POLY_ADDRESS: '<api-key>',
    POLY_SIGNATURE: '<api-key>',
    POLY_PASSPHRASE: '<api-key>',
    POLY_TIMESTAMP: '<api-key>'
  }
};

fetch('https://clob.polymarket.com/data/trades', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

--------------------------------

### Get Index - Request Examples in Multiple Languages

Source: https://docs.polymarket.com/api-reference/get-index

Example requests for the GET /v1/info/index endpoint in multiple languages: cURL, Python (requests), JavaScript (fetch), PHP (cURL), Go (net/http), Java (Unirest), and Ruby (net/http). All target the same URL and use the GET method.

```bash
curl --request GET \
  --url https://api.perpetuals.polymarket.com/v1/info/index
```

```python
import requests

url = "https://api.perpetuals.polymarket.com/v1/info/index"

response = requests.get(url)

print(response.text)
```

```javascript
const options = {method: 'GET'};

fetch('https://api.perpetuals.polymarket.com/v1/info/index', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.perpetuals.polymarket.com/v1/info/index",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.perpetuals.polymarket.com/v1/info/index"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.perpetuals.polymarket.com/v1/info/index")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.perpetuals.polymarket.com/v1/info/index")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

--------------------------------

### Go example for rewards/user

Source: https://docs.polymarket.com/api-reference/rewards/get-earnings-for-user-by-date

Uses the net/http package to send a GET request with the required POLY_* headers. Prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://clob.polymarket.com/rewards/user"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("POLY_API_KEY", "<api-key>")
	req.Header.Add("POLY_ADDRESS", "<api-key>")
	req.Header.Add("POLY_SIGNATURE", "<api-key>")
	req.Header.Add("POLY_PASSPHRASE", "<api-key>")
	req.Header.Add("POLY_TIMESTAMP", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go example for GET /v1/account/backstops

Source: https://docs.polymarket.com/api-reference/get-account-backstop-transfers

Uses net/http to send a GET request with the required headers and prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.perpetuals.polymarket.com/v1/account/backstops"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("POLYMARKET-PROXY", "<api-key>")
	req.Header.Add("POLYMARKET-SECRET", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### 500 error response example for GET /midpoints

Source: https://docs.polymarket.com/api-reference/market-data/get-midpoint-prices-query-parameters

Example 500 error response body for the GET /midpoints endpoint. It contains an error message indicating a failure to get the mid price.

```json
{
  "error": "error getting the mid price"
}
```

--------------------------------

### Go example for listing events

Source: https://docs.polymarket.com/api-reference/events/list-events-keyset-pagination

Uses Go's net/http package to send a GET request to the keyset pagination endpoint and prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://gamma-api.polymarket.com/events/keyset?limit=20&ascending=true"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### GET /midpoints request examples in multiple languages

Source: https://docs.polymarket.com/api-reference/market-data/get-midpoint-prices-query-parameters

Example requests to the GET /midpoints endpoint in various languages. The endpoint returns a map of token ID to midpoint price. The cURL example uses the --request GET flag and the URL https://clob.polymarket.com/midpoints.

```bash
curl --request GET \
  --url https://clob.polymarket.com/midpoints
```

```python
import requests

url = "https://clob.polymarket.com/midpoints"

response = requests.get(url)

print(response.text)
```

```javascript
const options = {method: 'GET'};

fetch('https://clob.polymarket.com/midpoints', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://clob.polymarket.com/midpoints",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://clob.polymarket.com/midpoints"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://clob.polymarket.com/midpoints")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://clob.polymarket.com/midpoints")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

--------------------------------

### Create Account Invite with Go net/http

Source: https://docs.polymarket.com/api-reference/create-account-invite

Go example using net/http to POST an empty JSON body to the account invite endpoint. Requires POLYMARKET-PROXY and POLYMARKET-SECRET headers. Prints the response body.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.perpetuals.polymarket.com/v1/account/invite"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("POLYMARKET-PROXY", "<api-key>")
	req.Header.Add("POLYMARKET-SECRET", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

```

--------------------------------

### Create Account Invite with Go net/http

Source: https://docs.polymarket.com/api-reference/create-account-invite

Go example using the standard net/http library to call the Create Account Invite endpoint. Sends an empty JSON body and prints the response.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.perpetuals.polymarket.com/v1/account/invite"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("POLYMARKET-PROXY", "<api-key>")
	req.Header.Add("POLYMARKET-SECRET", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go net/http example

Source: https://docs.polymarket.com/api-reference/core/get-closed-positions-for-a-user

Go example using net/http to GET closed positions and print the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://data-api.polymarket.com/closed-positions?limit=10&sortBy=REALIZEDPNL&sortDirection=DESC"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Check Invite Code - GET /v1/info/invite

Source: https://docs.polymarket.com/api-reference/check-invite-code

Send a GET request to the /v1/info/invite endpoint to check an invite code. The endpoint returns a JSON response indicating whether the code is valid. The cURL example uses the --request GET flag; the Python example uses the requests library; the JavaScript example uses fetch; the PHP example uses cURL; the Go example uses net/http; the Java example uses Unirest; the Ruby example uses net/http.

```bash
curl --request GET \
  --url https://api.perpetuals.polymarket.com/v1/info/invite
```

```python
import requests

url = "https://api.perpetuals.polymarket.com/v1/info/invite"

response = requests.get(url)

print(response.text)
```

```javascript
const options = {method: 'GET'};

fetch('https://api.perpetuals.polymarket.com/v1/info/invite', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.perpetuals.polymarket.com/v1/info/invite",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.perpetuals.polymarket.com/v1/info/invite"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.perpetuals.polymarket.com/v1/info/invite")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.perpetuals.polymarket.com/v1/info/invite")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

--------------------------------

### Go net/http GET for user combo positions

Source: https://docs.polymarket.com/api-reference/core/get-user-combo-positions

Go example using the standard net/http package to make a GET request. It reads the response body and prints it.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://data-api.polymarket.com/v1/positions/combos?sort=current_value_desc&limit=20"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Java Unirest example for GET /events/slug/{slug}

Source: https://docs.polymarket.com/api-reference/events/get-event-by-slug

Java example using Unirest to GET an event by slug. Returns an HttpResponse<String>.

```java
HttpResponse<String> response = Unirest.get("https://gamma-api.polymarket.com/events/slug/{slug}")
  .asString();
```

--------------------------------

### JavaScript fetch example for GET /events/slug/{slug}

Source: https://docs.polymarket.com/api-reference/events/get-event-by-slug

JavaScript example using fetch to GET an event by slug. Logs the JSON response.

```javascript
const options = {method: 'GET'};

fetch('https://gamma-api.polymarket.com/events/slug/{slug}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

--------------------------------

### Go example for mark history

Source: https://docs.polymarket.com/api-reference/get-mark-price-history

Uses the net/http package to send a GET request and prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.perpetuals.polymarket.com/v1/info/mark-history"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go GET /price with net/http

Source: https://docs.polymarket.com/api-reference/market-data/get-market-price

Go example using net/http to GET the market price and print the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://clob.polymarket.com/price"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Ruby net/http example for GET /data/trades

Source: https://docs.polymarket.com/api-reference/trade/get-trades

Ruby example using net/http to GET /data/trades with required POLY_* headers. Prints the response body.

```ruby
require 'uri'
require 'net/http'

url = URI("https://clob.polymarket.com/data/trades")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["POLY_API_KEY"] = '<api-key>'
request["POLY_ADDRESS"] = '<api-key>'
request["POLY_SIGNATURE"] = '<api-key>'
request["POLY_PASSPHRASE"] = '<api-key>'
request["POLY_TIMESTAMP"] = '<api-key>'

response = http.request(request)
puts response.read_body
```

--------------------------------

### Go request for combo markets

Source: https://docs.polymarket.com/api-reference/combo-markets/get-combo-markets

Go example using net/http to GET combo markets. Prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://combos-rfq-api.polymarket.com/v1/rfq/combo-markets?limit=50"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go example

Source: https://docs.polymarket.com/api-reference/core/get-current-positions-for-a-user

Use this Go program to GET the positions endpoint. It prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://data-api.polymarket.com/positions?sizeThreshold=1&limit=100&sortBy=TOKENS&sortDirection=DESC"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### PHP cURL example for GET /events/slug/{slug}

Source: https://docs.polymarket.com/api-reference/events/get-event-by-slug

PHP example using cURL to GET an event by slug. Handles errors and prints the response.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gamma-api.polymarket.com/events/slug/{slug}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

--------------------------------

### Go net/http GET /rewards/user/percentages

Source: https://docs.polymarket.com/api-reference/rewards/get-reward-percentages-for-user

Go example using net/http to GET reward percentages. Adds the required POLY_* headers and prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://clob.polymarket.com/rewards/user/percentages"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("POLY_API_KEY", "<api-key>")
	req.Header.Add("POLY_ADDRESS", "<api-key>")
	req.Header.Add("POLY_SIGNATURE", "<api-key>")
	req.Header.Add("POLY_PASSPHRASE", "<api-key>")
	req.Header.Add("POLY_TIMESTAMP", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Python requests example for GET /events/slug/{slug}

Source: https://docs.polymarket.com/api-reference/events/get-event-by-slug

Python example using the requests library to GET an event by slug. Prints the response text.

```python
import requests

url = "https://gamma-api.polymarket.com/events/slug/{slug}"

response = requests.get(url)

print(response.text)
```

--------------------------------

### Go GET /v2/user-pnl (try it)

Source: https://docs.polymarket.com/api-reference/wallet/get-a-users-pnl-series

Go program using the standard library to send a GET request and print the response body. Similar to the earlier Go example but uses http.DefaultClient.Do instead of http.Client.Do.

```Go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://data-api.polymarket.com/v2/user-pnl"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### PHP cURL example for GET /data/trades

Source: https://docs.polymarket.com/api-reference/trade/get-trades

PHP cURL example for GET /data/trades. Sets required POLY_* headers and prints the response or a cURL error.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://clob.polymarket.com/data/trades",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "POLY_ADDRESS: <api-key>",
    "POLY_API_KEY: <api-key>",
    "POLY_PASSPHRASE: <api-key>",
    "POLY_SIGNATURE: <api-key>",
    "POLY_TIMESTAMP: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

--------------------------------

### Go example

Source: https://docs.polymarket.com/api-reference/markets/list-a-markets-top-holders

Uses Go's net/http to GET the top holders endpoint and prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://data-api.polymarket.com/v2/holders"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Get Balances - 200 Response Example

Source: https://docs.polymarket.com/api-reference/get-balances

Example successful response for the Get Balances endpoint. Shows a single asset entry with its balance and value in USDC.

```json
[
  {
    "asset": "USDC",
    "balance": "10000.00",
    "value": "10000.00"
  }
]
```

--------------------------------

### List markets with GET /markets request examples

Source: https://docs.polymarket.com/api-reference/markets/list-markets

Example requests for the GET /markets endpoint, shown in multiple languages. Each snippet sends a GET request to the markets endpoint and prints or logs the response body. The cURL variant uses the --request GET flag with the URL.

```shell
curl --request GET \
  --url https://gamma-api.polymarket.com/markets
```

```python
import requests

url = "https://gamma-api.polymarket.com/markets"

response = requests.get(url)

print(response.text)
```

```javascript
const options = {method: 'GET'};

fetch('https://gamma-api.polymarket.com/markets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gamma-api.polymarket.com/markets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://gamma-api.polymarket.com/markets"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://gamma-api.polymarket.com/markets")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://gamma-api.polymarket.com/markets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

--------------------------------

### GET /v1/account/portfolio request examples (Go, Java, Ruby)

Source: https://docs.polymarket.com/api-reference/get-portfolio

Example requests for the GET /v1/account/portfolio endpoint in Go, Java (Unirest), and Ruby. All require the POLYMARKET-PROXY and POLYMARKET-SECRET headers with your API key and corresponding proxy secret. The request weight is 2.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.perpetuals.polymarket.com/v1/account/portfolio"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("POLYMARKET-PROXY", "<api-key>")
	req.Header.Add("POLYMARKET-SECRET", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.perpetuals.polymarket.com/v1/account/portfolio")
  .header("POLYMARKET-PROXY", "<api-key>")
  .header("POLYMARKET-SECRET", "<api-key>")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.perpetuals.polymarket.com/v1/account/portfolio")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["POLYMARKET-PROXY"] = '<api-key>'
request["POLYMARKET-SECRET"] = '<api-key>'

response = http.request(request)
puts response.read_body
```

--------------------------------

### Example response for listing markets with keyset pagination

Source: https://docs.polymarket.com/api-reference/markets/list-markets-keyset-pagination

Example JSON response for a successful request, showing the markets array and pagination fields next_cursor and limit.

```json
{
  "markets": [
    {
      "id": "<string>",
      "question": "<string>",
      "conditionId": "<string>",
      "slug": "<string>",
      "twitterCardImage": "<string>",
      "resolutionSource": "<string>",
      "endDate": "2023-11-07T05:31:56Z",
      "category": "<string>",
      "liquidity": "<string>",
      "sponsorName": "<string>",
      "sponsorImage": "<string>",
      "startDate": "2023-11-07T05:31:56Z",
      "xAxisValue": "<string>",
      "yAxisValue": "<string>",
      "denominationToken": "<string>",
      "fee": "<string>",
      "image": "<string>",
      "icon": "<string>",
      "lowerBound": "<string>",
      "upperBound": "<string>",
      "description": "<string>",
      "outcomes": "<string>",
      "outcomePrices": "<string>",
      "volume": "<string>",
      "active": true,
      "marketType": "<string>",
      "formatType": "<string>",
      "lowerBoundDate": "<string>",
      "upperBoundDate": "<string>",
      "closed": true,
      "createdBy": 123,
      "updatedBy": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "closedTime": "<string>",
      "wideFormat": true,
      "new": true,
      "mailchimpTag": "<string>",
      "featured": true,
      "archived": true,
      "resolvedBy": "<string>",
      "restricted": true,
      "marketGroup": 123,
      "groupItemTitle": "<string>",
      "groupItemThreshold": "<string>",
      "questionID": "<string>",
      "umaEndDate": "<string>",
      "enableOrderBook": true,
      "orderPriceMinTickSize": 123,
      "orderMinSize": 123,
      "umaResolutionStatus": "<string>",
      "curationOrder": 123,
      "volumeNum": 123,
      "liquidityNum": 123,
      "endDateIso": "<string>",
      "startDateIso": "<string>",
      "umaEndDateIso": "<string>",
      "hasReviewedDates": true,
      "readyForCron": true,
      "commentsEnabled": true,
      "volume24hr": 123,
      "volume1wk": 123,
      "volume1mo": 123,
      "volume1yr": 123,
      "gameStartTime": "<string>",
      "secondsDelay": 123,
      "clobTokenIds": "<string>",
      "disqusThread": "<string>",
      "shortOutcomes": "<string>",
      "teamAID": "<string>",
      "teamBID": "<string>",
      "umaBond": "<string>",
      "umaReward": "<string>",
      "volume24hrClob": 123,
      "volume1wkClob": 123,
      "volume1moClob": 123,
      "volume1yrClob": 123,
      "volumeClob": 123,
      "liquidityClob": 123,
      "makerBaseFee": 123,
      "takerBaseFee": 123,
      "customLiveness": 123,
      "acceptingOrders": true,
      "notificationsEnabled": true,
      "score": 123,
      "imageOptimized": {
        "id": "<string>",
        "imageUrlSource": "<string>",
        "imageUrlOptimized": "<string>",
        "imageSizeKbSource": 123,
        "imageSizeKbOptimized": 123
      }
    }
  ],
  "next_cursor": "<string>",
  "limit": 123
}
```

--------------------------------

### 400 error response example for GET /midpoints

Source: https://docs.polymarket.com/api-reference/market-data/get-midpoint-prices-query-parameters

Example 400 error response body for the GET /midpoints endpoint. It contains an error message indicating an invalid payload.

```json
{
  "error": "Invalid payload"
}
```

--------------------------------

### Go example for combo activity

Source: https://docs.polymarket.com/api-reference/core/get-user-combo-activity

Go program using net/http to send a GET request to the combo activity endpoint and print the response body. It ignores errors for simplicity.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://data-api.polymarket.com/v1/activity/combos?limit=50"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### 200 response example for GET /midpoints

Source: https://docs.polymarket.com/api-reference/market-data/get-midpoint-prices-query-parameters

Example 200 response body for the GET /midpoints endpoint. It is a JSON object mapping token IDs (as strings) to their midpoint prices (as strings).

```json
{
  "0xabc123def456...": "0.45",
  "0xdef456abc123...": "0.52"
}
```

--------------------------------

### Get user combo activity - request examples

Source: https://docs.polymarket.com/api-reference/core/get-user-combo-activity

Example requests for the GET /v1/activity/combos endpoint, shown in cURL, Python, JavaScript, PHP, Go, Java, and Ruby. Each performs a GET request to the same URL with the limit query parameter set to 50.

```cURL
curl --request GET \
  --url 'https://data-api.polymarket.com/v1/activity/combos?limit=50'
```

```Python
import requests

url = "https://data-api.polymarket.com/v1/activity/combos?limit=50"

response = requests.get(url)

print(response.text)
```

```JavaScript
const options = {method: 'GET'};

fetch('https://data-api.polymarket.com/v1/activity/combos?limit=50', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```PHP
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://data-api.polymarket.com/v1/activity/combos?limit=50",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```Go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://data-api.polymarket.com/v1/activity/combos?limit=50"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```Java
HttpResponse<String> response = Unirest.get("https://data-api.polymarket.com/v1/activity/combos?limit=50")
  .asString();
```

```Ruby
require 'uri'
require 'net/http'

url = URI("https://data-api.polymarket.com/v1/activity/combos?limit=50")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

--------------------------------

### Get Account Limits with Go

Source: https://docs.polymarket.com/api-reference/get-account-limits

Go example using the net/http package to fetch account limits. Requires the POLYMARKET-PROXY and POLYMARKET-SECRET headers with your API key.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.perpetuals.polymarket.com/v1/account/limits"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("POLYMARKET-PROXY", "<api-key>")
	req.Header.Add("POLYMARKET-SECRET", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```
Tokens:
Raw