Get bonds - Struct Docs

Get bonds

curl --request GET \
  --url https://api.struct.to/v1/polymarket/market/bonds

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.struct.to/v1/polymarket/market/bonds",
  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;
}

package main

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

func main() {

	url := "https://api.struct.to/v1/polymarket/market/bonds"

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

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.struct.to/v1/polymarket/market/bonds")

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

[
  {
    "condition_id": "<string>",
    "question": "<string>",
    "market_slug": "<string>",
    "end_time": 123,
    "best_outcome_index": 1,
    "best_price": 123,
    "return_pct": 123,
    "apy": 123,
    "outcomes": [
      {
        "name": "<string>",
        "index": 123,
        "position_id": "<string>",
        "price": 123
      }
    ],
    "title": "<string>",
    "event_slug": "<string>",
    "image_url": "<string>",
    "volume_24h": 123,
    "shares_volume_24h": 123,
    "liquidity": 123
  }
]

GET

/

polymarket

/

market

/

bonds

Get bonds

curl --request GET \
  --url https://api.struct.to/v1/polymarket/market/bonds

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.struct.to/v1/polymarket/market/bonds",
  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;
}

package main

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

func main() {

	url := "https://api.struct.to/v1/polymarket/market/bonds"

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

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.struct.to/v1/polymarket/market/bonds")

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

[
  {
    "condition_id": "<string>",
    "question": "<string>",
    "market_slug": "<string>",
    "end_time": 123,
    "best_outcome_index": 1,
    "best_price": 123,
    "return_pct": 123,
    "apy": 123,
    "outcomes": [
      {
        "name": "<string>",
        "index": 123,
        "position_id": "<string>",
        "price": 123
      }
    ],
    "title": "<string>",
    "event_slug": "<string>",
    "image_url": "<string>",
    "volume_24h": 123,
    "shares_volume_24h": 123,
    "liquidity": 123
  }
]

Query Parameters

min_price

number<double>

Minimum best-outcome price (default: 0.85). min_probability is accepted as a backwards-compatible alias.

max_price

number<double>

Maximum best-outcome price. max_probability is accepted as a backwards-compatible alias.

max_hours

number<double>

Maximum hours until market end, capped at 168

sort_by

enum<string>

Sort by: apy, liquidity, volume, end_date (default: end_date)

Available options:

end_date,

apy,

liquidity,

volume

sort_desc

boolean

Sort descending (default: true)

limit

integer<int32>

Number of results (default: 10, max: 250)

offset

integer<int32>

Initial skip (default: 0). Can also be supplied through pagination_key.

pagination_key

string

Offset cursor from previous response. Opaque token — pass verbatim to fetch the next page.

Response

200 - application/json

List of bond markets

condition_id

string

required

question

string

required

market_slug

string

required

end_time

integer<int64>

required

best_outcome_index

integer<int32>

required

Required range: x >= 0

best_price

number<double>

required

Highest outcome price (the bond's "buy the favourite" entry price).

return_pct

number<double>

required

apy

number<double>

required

outcomes

object[]

required

Show child attributes

title

string | null

event_slug

string | null

image_url

string | null

volume_24h

number<double> | null

shares_volume_24h

number<double> | null

liquidity

number<double> | null

Last modified on August 7, 2026