Predexon

https://docs.predexon.com/
Admin
A unified prediction market data API providing real-time and historical data across 6 platforms...
Tokens:294,864
Snippets:1,987
Trust Score:7.5
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Go example for Get Smart Activity Markets

Source: https://docs.predexon.com/api-reference/smart-money/smart-activity

Go example using net/http to make a GET request to the smart-activity endpoint. Prints the response body.

```go
package main

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

func main() {

	url := "https://api.predexon.com/v2/polymarket/markets/smart-activity?window=all_time&sort_by=smart_volume&order=desc&limit=100"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
```

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

### Go example for Get Wallet Pnl

Source: https://docs.predexon.com/api-reference/wallet/pnl

Go example using the standard library to call the Get Wallet Pnl endpoint. Replace {wallet} and <api-key> with your values.

```go
package main

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

func main() {

	url := "https://api.predexon.com/v2/polymarket/wallet/pnl/{wallet}"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
```

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

### Go example for Get Activity

Source: https://docs.predexon.com/api-reference/trading/activity

Uses net/http to send a GET request with an API key header and prints the response body.

```go
package main

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

func main() {

	url := "https://api.predexon.com/v2/polymarket/activity?sort_by=timestamp&limit=100&order=desc"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
```

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

### Go example for GET /v2/opinion/orderbooks

Source: https://docs.predexon.com/api-reference/opinion/orderbooks

Uses net/http to create a GET request with the x-api-key header, performs it, and prints the response body.

```go
package main

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

func main() {

	url := "https://api.predexon.com/v2/opinion/orderbooks?limit=100"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
```

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

### JavaScript fetch example for Get Wallet Pnl

Source: https://docs.predexon.com/api-reference/wallet/pnl

JavaScript example using fetch to call the Get Wallet Pnl endpoint. Replace {wallet} and <api-key> with your values.

```javascript
const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.predexon.com/v2/polymarket/wallet/pnl/{wallet}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

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

### Ruby example for Get Smart Activity Markets

Source: https://docs.predexon.com/api-reference/smart-money/smart-activity

Ruby example using Net::HTTP to fetch smart activity markets. Prints the response body.

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

url = URI("https://api.predexon.com/v2/polymarket/markets/smart-activity?window=all_time&sort_by=smart_volume&order=desc&limit=100")

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

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

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

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

### Ruby example for Get Activity

Source: https://docs.predexon.com/api-reference/trading/activity

Uses Net::HTTP to send a GET request with an API key header and prints the response body.

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

url = URI("https://api.predexon.com/v2/polymarket/activity?sort_by=timestamp&limit=100&order=desc")

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

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

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

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

### Ruby example for GET /v2/opinion/orderbooks

Source: https://docs.predexon.com/api-reference/opinion/orderbooks

Uses net/http to send a GET request with the x-api-key header and prints the response body.

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

url = URI("https://api.predexon.com/v2/opinion/orderbooks?limit=100")

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

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

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

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

### Go example for GET /v2/predictfun/orderbooks

Source: https://docs.predexon.com/api-reference/predictfun/orderbooks

Uses net/http to send a GET request with an x-api-key header. Reads and prints the response body.

```go
package main

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

func main() {

	url := "https://api.predexon.com/v2/predictfun/orderbooks?limit=100"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
```

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

### Ruby example for GET /v2/predictfun/orderbooks

Source: https://docs.predexon.com/api-reference/predictfun/orderbooks

Uses net/http with SSL to send a GET request with an x-api-key header. Prints the response body.

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

url = URI("https://api.predexon.com/v2/predictfun/orderbooks?limit=100")

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

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

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

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

### JavaScript fetch example for Get Smart Activity Markets

Source: https://docs.predexon.com/api-reference/smart-money/smart-activity

JavaScript example using fetch to retrieve smart activity markets. The response is logged to the console.

```javascript
const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.predexon.com/v2/polymarket/markets/smart-activity?window=all_time&sort_by=smart_volume&order=desc&limit=100', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

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

### Go example

Source: https://docs.predexon.com/api-reference/canonical/markets

Uses net/http to GET markets. Prints the response body.

```go
package main

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

func main() {

	url := "https://api.predexon.com/v2/polymarket/markets/keyset?sort=volume&limit=20"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
```

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

### Get Wallet Identity - Request Examples

Source: https://docs.predexon.com/api-reference/wallet/identity

Example requests for the Get Wallet Identity endpoint. All use the GET method with the x-api-key header and the {wallet} path parameter. The cURL example is the canonical request; the others show equivalent calls in Python, JavaScript, PHP, Go, Java (Unirest), and Ruby.

```bash
curl --request GET \
  --url https://api.predexon.com/v2/polymarket/wallet/identity/{wallet} \
  --header 'x-api-key: <api-key>'
```

```python
import requests

url = "https://api.predexon.com/v2/polymarket/wallet/identity/{wallet}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
```

```javascript
const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.predexon.com/v2/polymarket/wallet/identity/{wallet}', 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.predexon.com/v2/polymarket/wallet/identity/{wallet}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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.predexon.com/v2/polymarket/wallet/identity/{wallet}"

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

	req.Header.Add("x-api-key", "<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.predexon.com/v2/polymarket/wallet/identity/{wallet}")
  .header("x-api-key", "<api-key>")
  .asString();
```

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

url = URI("https://api.predexon.com/v2/polymarket/wallet/identity/{wallet}")

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

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

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

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

### Go example

Source: https://docs.predexon.com/api-reference/analytics/position-top-holders

Go example using net/http to call the top-holders endpoint. Replace {token_id} and <api-key> with your values.

```go
package main

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

func main() {

	url := "https://api.predexon.com/v2/polymarket/position/{token_id}/top-holders?limit=100"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
```

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

### Java Unirest example for Get Wallet Pnl

Source: https://docs.predexon.com/api-reference/wallet/pnl

Java example using Unirest to call the Get Wallet Pnl endpoint. Replace {wallet} and <api-key> with your values.

```java
HttpResponse<String> response = Unirest.get("https://api.predexon.com/v2/polymarket/wallet/pnl/{wallet}")
  .header("x-api-key", "<api-key>")
  .asString();
```

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

### Go example for top holders

Source: https://docs.predexon.com/api-reference/analytics/top-holders

Go example using net/http to fetch top holders. Creates a GET request with the API key header and prints the response body.

```go
package main

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

func main() {

	url := "https://api.predexon.com/v2/polymarket/market/{condition_id}/top-holders?limit=100"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
```

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

### PHP cURL example for Get Wallet Pnl

Source: https://docs.predexon.com/api-reference/wallet/pnl

PHP example using cURL to call the Get Wallet Pnl endpoint. Replace {wallet} and <api-key> with your values.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.predexon.com/v2/polymarket/wallet/pnl/{wallet}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

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

### Go example for filtering wallets

Source: https://docs.predexon.com/api-reference/analytics/filter-wallets

Go example using net/http to call the Filter Wallets By Markets endpoint. It adds the x-api-key header and prints the response body.

```go
package main

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

func main() {

	url := "https://api.predexon.com/v2/polymarket/wallets/filter?market_logic=and&window=all_time&sort_by=total_pnl&order=desc&limit=100"

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

	req.Header.Add("x-api-key", "<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 Wallet Pnl

Source: https://docs.predexon.com/api-reference/wallet/pnl

Python example using the requests library to call the Get Wallet Pnl endpoint. Replace {wallet} and <api-key> with your values.

```python
import requests

url = "https://api.predexon.com/v2/polymarket/wallet/pnl/{wallet}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
```

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

### Ruby Net::HTTP example for Get Wallet Pnl

Source: https://docs.predexon.com/api-reference/wallet/pnl

Ruby example using Net::HTTP to call the Get Wallet Pnl endpoint. Replace {wallet} and <api-key> with your values.

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

url = URI("https://api.predexon.com/v2/polymarket/wallet/pnl/{wallet}")

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

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

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

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

### Ruby example

Source: https://docs.predexon.com/api-reference/canonical/markets

Uses net/http to GET markets. Prints the response body.

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

url = URI("https://api.predexon.com/v2/polymarket/markets/keyset?sort=volume&limit=20")

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

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

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

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

### Get Crypto Updown - Request Examples

Source: https://docs.predexon.com/api-reference/markets/crypto-updown

Example requests for the GET /v2/polymarket/crypto-updown endpoint. Each request uses the x-api-key header and the query parameters sort=desc and limit=50. The endpoint returns a list of crypto up/down markets.

```bash
curl --request GET \
  --url 'https://api.predexon.com/v2/polymarket/crypto-updown?sort=desc&limit=50' \
  --header 'x-api-key: <api-key>'
```

```python
import requests

url = "https://api.predexon.com/v2/polymarket/crypto-updown?sort=desc&limit=50"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
```

```javascript
const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.predexon.com/v2/polymarket/crypto-updown?sort=desc&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://api.predexon.com/v2/polymarket/crypto-updown?sort=desc&limit=50",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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.predexon.com/v2/polymarket/crypto-updown?sort=desc&limit=50"

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

	req.Header.Add("x-api-key", "<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.predexon.com/v2/polymarket/crypto-updown?sort=desc&limit=50")
  .header("x-api-key", "<api-key>")
  .asString();
```

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

url = URI("https://api.predexon.com/v2/polymarket/crypto-updown?sort=desc&limit=50")

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

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

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

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

### Get Markets 200 Response Example

Source: https://docs.predexon.com/api-reference/canonical/listings

Example 200 response body for the Get Markets endpoint. Contains a markets array with market details and a pagination object with limit, count, has_more, and pagination_key fields.

```json
{
  "markets": [
    {
      "condition_id": "<string>",
      "market_id": "<string>",
      "market_slug": "<string>",
      "title": "<string>",
      "status": "<string>",
      "outcomes": [
        {
          "label": "<string>",
          "token_id": "<string>",
          "predexon_id": "<string>",
          "price": 123
        }
      ],
      "question_id": "<string>",
      "description": "",
      "winning_side": "<string>",
      "start_time": "<string>",
      "end_time": "<string>",
      "close_time": "<string>",
      "created_time": "<string>",
      "image_url": "",
      "event_id": "<string>",
      "event_slug": "<string>",
      "event_title": "<string>",
      "total_volume_usd": 0,
      "liquidity_usd": 0,
      "tags": [
        "<string>"
      ],
      "is_neg_risk": false,
      "rolling_metrics": {
        "volume_1d": 0,
        "volume_7d": 0,
        "volume_30d": 0,
        "buy_volume_1d": 0,
        "buy_volume_7d": 0,
        "buy_volume_30d": 0,
        "sell_volume_1d": 0,
        "sell_volume_7d": 0,
        "sell_volume_30d": 0,
        "trades_1d": 0,
        "trades_7d": 0,
        "trades_30d": 0,
        "buys_1d": 0,
        "buys_7d": 0,
        "buys_30d": 0,
        "sells_1d": 0,
        "sells_7d": 0,
        "sells_30d": 0,
        "oi_change_1d": 0,
        "oi_change_7d": 0,
        "oi_change_30d": 0,
        "computed_at": "<string>"
      }
    }
  ],
  "pagination": {
    "limit": 123,
    "count": 123,
    "has_more": true,
    "pagination_key": "<string>"
  }
}
```

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

### GET /v2/kalshi/trades

Source: https://docs.predexon.com/api-reference/kalshi/trades

API documentation for the GET /v2/kalshi/trades endpoint, including parameters, request examples, and response schemas.

```APIDOC
## GET /v2/kalshi/trades

### Description
Retrieves a list of Kalshi trades from the Predexon API. This endpoint returns trade details including trade ID, ticker, count, prices, taker side, and creation time, along with pagination information.

### Method
GET

### Endpoint
https://api.predexon.com/v2/kalshi/trades

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - The maximum number of trades to return. Example: 100.
- **order** (string) - Optional - The sort order for the results. Example: 'desc'.

#### Headers
- **x-api-key** (string) - Required - API key for authentication.

### Request Example
```
curl --request GET \
  --url 'https://api.predexon.com/v2/kalshi/trades?limit=100&order=desc' \
  --header 'x-api-key: <api-key>'
```

### Response
#### Success Response (200)
- **trades** (array) - List of trade objects.
  - **trade_id** (string) - Unique identifier for the trade.
  - **ticker** (string) - Ticker symbol of the market.
  - **count** (integer) - Number of contracts traded.
  - **yes_price** (integer) - Price of the 'yes' side.
  - **no_price** (integer) - Price of the 'no' side.
  - **taker_side** (string) - Side of the taker, either 'yes' or 'no'.
  - **created_time** (integer) - Timestamp of trade creation.
- **pagination** (object) - Pagination metadata.
  - **limit** (integer) - The limit used for the request.
  - **count** (integer) - Number of items returned.
  - **has_more** (boolean) - Indicates if more results are available.
  - **pagination_key** (string) - Key for the next page.

#### Response Example
```
{
  "trades": [
    {
      "trade_id": "<string>",
      "ticker": "<string>",
      "count": 123,
      "yes_price": 123,
      "no_price": 123,
      "taker_side": "yes",
      "created_time": 123
    }
  ],
  "pagination": {
    "limit": 123,
    "count": 123,
    "has_more": true,
    "pagination_key": "<string>"
  }
}
```

#### Error Responses
- **400** - Bad Request. Response body:
```
{
  "error": "<string>",
  "message": "<string>"
}
```
- **422** - Unprocessable Entity. Response body:
```
{
  "detail": [
    {
      "loc": ["<string>"],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}
```
- **500** - Internal Server Error. Response body:
```
{
  "error": "<string>",
  "message": "<string>"
}
```
```

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

### Go example for list tags

Source: https://docs.predexon.com/api-reference/discovery/tags

Use this Go program to fetch tags from the API. It creates an HTTP GET request with the x-api-key header, reads the response body, and prints it.

```go
package main

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

func main() {

	url := "https://api.predexon.com/v2/polymarket/tags?sort=volume_7d&limit=50"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
```

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

### Go example for cohort stats

Source: https://docs.predexon.com/api-reference/analytics/cohort-stats

Uses net/http to GET cohort stats. Prints the response body.

```go
package main

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

func main() {

	url := "https://api.predexon.com/v2/polymarket/cohorts/stats?window=all_time"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
```

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

### GET /v2/polymarket/markets/keyset

Source: https://docs.predexon.com/api-reference/canonical/listings

This snippet documents the GET /v2/polymarket/markets/keyset endpoint, including its parameters, request example, and response schemas.

```APIDOC
## GET /v2/polymarket/markets/keyset

### Description
Fetches a list of Polymarket markets using keyset pagination. This endpoint allows you to retrieve markets sorted by volume or other criteria, with configurable limits.

### Method
GET

### Endpoint
https://api.predexon.com/v2/polymarket/markets/keyset

### Parameters
#### Query Parameters
- **sort** (string) - Optional - The field to sort markets by. Example: `volume`.
- **limit** (integer) - Optional - The maximum number of markets to return. Example: `20`.

#### Headers
- **x-api-key** (string) - Required - Your API key for authentication.

### Request Example
```
curl --request GET \
  --url 'https://api.predexon.com/v2/polymarket/markets/keyset?sort=volume&limit=20' \
  --header 'x-api-key: <api-key>'
```

### Response
#### Success Response (200)
- **markets** (array) - List of market objects.
  - **condition_id** (string) - Unique identifier for the market condition.
  - **market_id** (string) - Unique identifier for the market.
  - **market_slug** (string) - URL-friendly slug for the market.
  - **title** (string) - Title of the market.
  - **status** (string) - Current status of the market.
  - **outcomes** (array) - List of outcome objects.
    - **label** (string) - Label of the outcome.
    - **token_id** (string) - Token identifier for the outcome.
    - **predexon_id** (string) - Predexon identifier for the outcome.
    - **price** (number) - Current price of the outcome.
  - **question_id** (string) - Identifier for the market question.
  - **description** (string) - Description of the market.
  - **winning_side** (string) - The winning side if resolved.
  - **start_time** (string) - Start time of the market.
  - **end_time** (string) - End time of the market.
  - **close_time** (string) - Close time of the market.
  - **created_time** (string) - Creation time of the market.
  - **image_url** (string) - URL of the market image.
  - **event_id** (string) - Identifier for the associated event.
  - **event_slug** (string) - URL-friendly slug for the event.
  - **event_title** (string) - Title of the event.
  - **total_volume_usd** (number) - Total trading volume in USD.
  - **liquidity_usd** (number) - Liquidity in USD.
  - **tags** (array of strings) - Tags associated with the market.
  - **is_neg_risk** (boolean) - Indicates if the market is negative risk.
  - **rolling_metrics** (object) - Rolling metrics for the market.
    - **volume_1d** (number) - Volume over 1 day.
    - **volume_7d** (number) - Volume over 7 days.
    - **volume_30d** (number) - Volume over 30 days.
    - **buy_volume_1d** (number) - Buy volume over 1 day.
    - **buy_volume_7d** (number) - Buy volume over 7 days.
    - **buy_volume_30d** (number) - Buy volume over 30 days.
    - **sell_volume_1d** (number) - Sell volume over 1 day.
    - **sell_volume_7d** (number) - Sell volume over 7 days.
    - **sell_volume_30d** (number) - Sell volume over 30 days.
    - **trades_1d** (number) - Number of trades over 1 day.
    - **trades_7d** (number) - Number of trades over 7 days.
    - **trades_30d** (number) - Number of trades over 30 days.
    - **buys_1d** (number) - Number of buys over 1 day.
    - **buys_7d** (number) - Number of buys over 7 days.
    - **buys_30d** (number) - Number of buys over 30 days.
    - **sells_1d** (number) - Number of sells over 1 day.
    - **sells_7d** (number) - Number of sells over 7 days.
    - **sells_30d** (number) - Number of sells over 30 days.
    - **oi_change_1d** (number) - Open interest change over 1 day.
    - **oi_change_7d** (number) - Open interest change over 7 days.
    - **oi_change_30d** (number) - Open interest change over 30 days.
    - **computed_at** (string) - Timestamp when metrics were computed.
- **pagination** (object) - Pagination information.
  - **limit** (integer) - The limit used for the request.
  - **count** (integer) - Number of items returned.
  - **has_more** (boolean) - Indicates if there are more results.
  - **pagination_key** (string) - Key for the next page.

#### Response Example
```
{
  "markets": [
    {
      "condition_id": "<string>",
      "market_id": "<string>",
      "market_slug": "<string>",
      "title": "<string>",
      "status": "<string>",
      "outcomes": [
        {
          "label": "<string>",
          "token_id": "<string>",
          "predexon_id": "<string>",
          "price": 123
        }
      ],
      "question_id": "<string>",
      "description": "",
      "winning_side": "<string>",
      "start_time": "<string>",
      "end_time": "<string>",
      "close_time": "<string>",
      "created_time": "<string>",
      "image_url": "",
      "event_id": "<string>",
      "event_slug": "<string>",
      "event_title": "<string>",
      "total_volume_usd": 0,
      "liquidity_usd": 0,
      "tags": [
        "<string>"
      ],
      "is_neg_risk": false,
      "rolling_metrics": {
        "volume_1d": 0,
        "volume_7d": 0,
        "volume_30d": 0,
        "buy_volume_1d": 0,
        "buy_volume_7d": 0,
        "buy_volume_30d": 0,
        "sell_volume_1d": 0,
        "sell_volume_7d": 0,
        "sell_volume_30d": 0,
        "trades_1d": 0,
        "trades_7d": 0,
        "trades_30d": 0,
        "buys_1d": 0,
        "buys_7d": 0,
        "buys_30d": 0,
        "sells_1d": 0,
        "sells_7d": 0,
        "sells_30d": 0,
        "oi_change_1d": 0,
        "oi_change_7d": 0,
        "oi_change_30d": 0,
        "computed_at": "<string>"
      }
    }
  ],
  "pagination": {
    "limit": 123,
    "count": 123,
    "has_more": true,
    "pagination_key": "<string>"
  }
}
```

#### Error Response (422)
- **detail** (array) - List of validation error objects.
  - **loc** (array of strings) - Location of the error.
  - **msg** (string) - Error message.
  - **type** (string) - Error type.

#### Error Response Example
```
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}
```
```

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

### Go example for builder leaderboard

Source: https://docs.predexon.com/api-reference/builders/leaderboard

Uses net/http to GET the leaderboard endpoint with an API key header and prints the response body.

```go
package main

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

func main() {

	url := "https://api.predexon.com/v2/polymarket/builders/leaderboard?window=7d&sort_by=volume&limit=50"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
```

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

### GET /v2/predictfun/orderbooks

Source: https://docs.predexon.com/api-reference/predictfun/orderbooks

Documentation for the GET /v2/predictfun/orderbooks endpoint, including parameters, request examples, response schema, and error responses.

```APIDOC
## GET /v2/predictfun/orderbooks

### Description
Retrieves order book snapshots for PredictFun markets, including bid and ask levels, best prices, and depth. This endpoint provides market depth data for prediction markets.

### Method
GET

### Endpoint
https://api.predexon.com/v2/predictfun/orderbooks

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - Maximum number of snapshots to return. Default is 100.

#### Headers
- **x-api-key** (string) - Required - API key for authentication.

### Request Example
```
curl --request GET \
  --url 'https://api.predexon.com/v2/predictfun/orderbooks?limit=100' \
  --header 'x-api-key: <api-key>'
```

### Response
#### Success Response (200)
- **snapshots** (array) - List of order book snapshots.
  - **market_id** (integer) - Identifier of the market.
  - **timestamp** (integer) - Timestamp of the snapshot.
  - **bids** (array) - List of bid orders.
    - **price** (number) - Bid price.
    - **size** (number) - Bid size.
  - **asks** (array) - List of ask orders.
    - **price** (number) - Ask price.
    - **size** (number) - Ask size.
  - **best_bid** (number) - Best bid price.
  - **best_ask** (number) - Best ask price.
  - **bid_depth** (number) - Total bid depth.
  - **ask_depth** (number) - Total ask depth.
- **pagination** (object) - Pagination information.
  - **limit** (integer) - Limit used for the request.
  - **count** (integer) - Number of items returned.
  - **has_more** (boolean) - Indicates if more results are available.
  - **pagination_key** (string) - Key for the next page.

#### Response Example
```json
{
  "snapshots": [
    {
      "market_id": 123,
      "timestamp": 123,
      "bids": [
        {
          "price": 123,
          "size": 123
        }
      ],
      "asks": [
        {
          "price": 123,
          "size": 123
        }
      ],
      "best_bid": 123,
      "best_ask": 123,
      "bid_depth": 123,
      "ask_depth": 123
    }
  ],
  "pagination": {
    "limit": 123,
    "count": 123,
    "has_more": true,
    "pagination_key": "<string>"
  }
}
```

### Error Responses
#### 400 Bad Request
- **error** (string) - Error code.
- **message** (string) - Error message.

#### 422 Unprocessable Entity
- **detail** (array) - Validation error details.
  - **loc** (array) - Location of the error.
  - **msg** (string) - Error message.
  - **type** (string) - Error type.

#### 500 Internal Server Error
- **error** (string) - Error code.
- **message** (string) - Error message.
```

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

### Python requests example for Get Smart Activity Markets

Source: https://docs.predexon.com/api-reference/smart-money/smart-activity

Python example using the requests library to call the smart-activity endpoint. Replace <api-key> with your actual API key.

```python
import requests

url = "https://api.predexon.com/v2/polymarket/markets/smart-activity?window=all_time&sort_by=smart_volume&order=desc&limit=100"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
```

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

### Similar Wallets API Request Examples (Go, Java, Ruby)

Source: https://docs.predexon.com/api-reference/wallet/similar-wallets

Example requests for the similar wallets endpoint in Go, Java (Unirest), and Ruby. All use the GET method with the x-api-key header and the same URL with query parameters window=all_time and limit=50.

```go
package main

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

func main() {

	url := "https://api.predexon.com/v2/polymarket/wallet/{wallet}/similar?window=all_time&limit=50"

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

	req.Header.Add("x-api-key", "<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.predexon.com/v2/polymarket/wallet/{wallet}/similar?window=all_time&limit=50")
  .header("x-api-key", "<api-key>")
  .asString();
```

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

url = URI("https://api.predexon.com/v2/polymarket/wallet/{wallet}/similar?window=all_time&limit=50")

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

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

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

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

### GET /v2/limitless/orderbooks

Source: https://docs.predexon.com/api-reference/limitless/orderbooks

Documentation for the GET /v2/limitless/orderbooks endpoint, including parameters, request examples, response schema, and error responses.

```APIDOC
## GET /v2/limitless/orderbooks

### Description
Retrieves the current order books for Limitless markets. Returns bid and ask snapshots for each market along with pagination information.

### Method
GET

### Endpoint
https://api.predexon.com/v2/limitless/orderbooks

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - Maximum number of order book snapshots to return. Default is 100.

#### Headers
- **x-api-key** (string) - Required - API key for authentication.

### Request Example
```
curl --request GET \
  --url 'https://api.predexon.com/v2/limitless/orderbooks?limit=100' \
  --header 'x-api-key: <api-key>'
```

### Response
#### Success Response (200)
- **snapshots** (array) - List of order book snapshots.
  - **market_slug** (string) - Market identifier.
  - **token_id** (string) - Token identifier.
  - **timestamp** (integer) - Timestamp of the snapshot.
  - **bids** (array) - List of bid orders.
    - **price** (number) - Bid price.
    - **size** (number) - Bid size.
  - **asks** (array) - List of ask orders.
    - **price** (number) - Ask price.
    - **size** (number) - Ask size.
  - **midpoint** (number) - Midpoint price.
  - **adjusted_midpoint** (number) - Adjusted midpoint price.
- **pagination** (object) - Pagination details.
  - **limit** (integer) - Number of items per page.
  - **count** (integer) - Number of items returned.
  - **has_more** (boolean) - Whether more items are available.
  - **pagination_key** (string) - Key for the next page.

#### Response Example
```
{
  "snapshots": [
    {
      "market_slug": "<string>",
      "token_id": "<string>",
      "timestamp": 123,
      "bids": [
        {
          "price": 123,
          "size": 123
        }
      ],
      "asks": [
        {
          "price": 123,
          "size": 123
        }
      ],
      "midpoint": 123,
      "adjusted_midpoint": 123
    }
  ],
  "pagination": {
    "limit": 123,
    "count": 123,
    "has_more": true,
    "pagination_key": "<string>"
  }
}
```

### Error Responses
#### 400 Bad Request
- **error** (string) - Error code.
- **message** (string) - Error message.

#### 422 Unprocessable Entity
- **detail** (array) - Validation error details.
  - **loc** (array) - Location of the error.
  - **msg** (string) - Error message.
  - **type** (string) - Error type.

#### 500 Internal Server Error
- **error** (string) - Error code.
- **message** (string) - Error message.
```

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

### Ruby example

Source: https://docs.predexon.com/api-reference/analytics/position-top-holders

Ruby example using net/http to call the top-holders endpoint. Replace {token_id} and <api-key> with your values.

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

url = URI("https://api.predexon.com/v2/polymarket/position/{token_id}/top-holders?limit=100")

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

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

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

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

### Go example for candlesticks by token

Source: https://docs.predexon.com/api-reference/markets/candlesticks-by-token

Uses net/http to send a GET request with the x-api-key header and prints the response body.

```go
package main

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

func main() {

	url := "https://api.predexon.com/v2/polymarket/candlesticks/token/{token_id}"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
```

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

### Multi-wallet filtering example

Source: https://docs.predexon.com/api-reference/trading/trades

Example GET request using the wallet parameter with a comma-separated list of up to 50 addresses. Returns a merged feed of all listed wallets' trades.

```http
GET /v2/polymarket/trades?wallet=0xabc...,0xdef...,0x123...&limit=100
```

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

### Go Request

Source: https://docs.predexon.com/api-reference/wallet/positions

Example using Go's net/http to fetch wallet positions. Requires an API key in the 'x-api-key' header.

```go
package main

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

func main() {

	url := "https://api.predexon.com/v2/polymarket/wallet/positions/{wallet}?sort_by=value&order=desc&limit=100"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

```
Tokens:
Raw