Your contracts

curl --request GET \
  --url https://calibri.io/api/v2/atlas/account/contracts \
  --header 'X-Auth-Apikey: <api-key>'

const options = {method: 'GET', headers: {'X-Auth-Apikey': '<api-key>'}};

fetch('https://calibri.io/api/v2/atlas/account/contracts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://calibri.io/api/v2/atlas/account/contracts",
  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-Auth-Apikey: <api-key>"
  ],
]);

$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://calibri.io/api/v2/atlas/account/contracts"

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

	req.Header.Add("X-Auth-Apikey", "<api-key>")

	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://calibri.io/api/v2/atlas/account/contracts")

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

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

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

[
  {
    "avg_price": 0.6,
    "created_at": "2026-08-07T10:00:00Z",
    "direction": "buy",
    "event_slug": "btc-updown-5m-1730",
    "event_title": "Bitcoin Up or Down 5m",
    "funds_spent": 60,
    "id": "usdc",
    "market_id": "12",
    "market_title": "Will BTC close above its open?",
    "match_type": "mint",
    "price": 0.6,
    "proceeds": 0,
    "quote_currency": "usdc",
    "side": "yes",
    "state": "active",
    "taker_fee_amount": "0.17",
    "taker_fee_refunded": false,
    "volume": 100,
    "outcome_labels": [
      "Above $77,500",
      "Below $77,500"
    ],
    "settled_at": "2026-08-08T00:00:00Z",
    "settlement_status": "confirmed",
    "settlement_status_raw": "matched"
  }
]

GET

api

atlas

account

contracts

Your contracts

curl --request GET \
  --url https://calibri.io/api/v2/atlas/account/contracts \
  --header 'X-Auth-Apikey: <api-key>'

const options = {method: 'GET', headers: {'X-Auth-Apikey': '<api-key>'}};

fetch('https://calibri.io/api/v2/atlas/account/contracts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://calibri.io/api/v2/atlas/account/contracts",
  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-Auth-Apikey: <api-key>"
  ],
]);

$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://calibri.io/api/v2/atlas/account/contracts"

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

	req.Header.Add("X-Auth-Apikey", "<api-key>")

	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://calibri.io/api/v2/atlas/account/contracts")

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

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

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

[
  {
    "avg_price": 0.6,
    "created_at": "2026-08-07T10:00:00Z",
    "direction": "buy",
    "event_slug": "btc-updown-5m-1730",
    "event_title": "Bitcoin Up or Down 5m",
    "funds_spent": 60,
    "id": "usdc",
    "market_id": "12",
    "market_title": "Will BTC close above its open?",
    "match_type": "mint",
    "price": 0.6,
    "proceeds": 0,
    "quote_currency": "usdc",
    "side": "yes",
    "state": "active",
    "taker_fee_amount": "0.17",
    "taker_fee_refunded": false,
    "volume": 100,
    "outcome_labels": [
      "Above $77,500",
      "Below $77,500"
    ],
    "settled_at": "2026-08-08T00:00:00Z",
    "settlement_status": "confirmed",
    "settlement_status_raw": "matched"
  }
]

Authorizations

X-Auth-Apikey

string

header

required

HMAC-signed API key. Send X-Auth-Apikey, X-Auth-Nonce and X-Auth-Signature.

Query Parameters

limit

integer

default:50

Contracts per page. Defaults to 50.

Required range: x >= 1

page

integer

default:1

Page number, from 1. Newest contract first.

Required range: x >= 1

order_id

number

Contracts either leg of which came from this order — useful for following one fill. Matches the yes side or the no side.

market_id

string

Filter to one market, by the engine's market id.

state

string

Filter by verdict — the same vocabulary the state field returns: active, settled_yes, settled_no, voided. Two conveniences on top: settled is shorthand for both settled values, and a comma-separated list is an OR (settled_yes,voided). pending is accepted as an alias of active. Not an enum in this schema precisely because a list is a legal value.

Response

200 - application/json

avg_price

number

required

Volume-weighted average across fills.

Example:

0.6

created_at

string

required

ISO-8601.

Example:

"2026-08-07T10:00:00Z"

direction

enum<string>

required

Whether you bought or sold side on this contract. Always buy on a mint.

Available options:

buy,

sell

Example:

"buy"

event_slug

string | null

required

The parent event's slug — what a portfolio row links to.

Example:

"btc-updown-5m-1730"

event_title

string | null

required

Example:

"Bitcoin Up or Down 5m"

funds_spent

number

required

Cash paid, on a buy. 0 on a sell.

Example:

60

number

required

Example:

"usdc"

market_id

string

required

The market this position is in.

Example:

"12"

market_title

string

required

Example:

"Will BTC close above its open?"

match_type

enum<string>

required

mint creates a YES/NO pair from two buys; transfer moves an existing token from a seller to a buyer; merge redeems a YES and a NO from two sellers.

Available options:

mint,

transfer,

merge

Example:

"mint"

price

number

required

Fill price, a probability in (0,1).

Example:

0.6

proceeds

number

required

Cash received before fees, on a sell. 0 on a buy.

Example:

0

quote_currency

string

required

Example:

"usdc"

side

enum<string>

required

The outcome you traded on this contract. On an exit this is the outcome you sold or bought, not the book side.

Available options:

yes,

no

Example:

"yes"

state

enum<string>

required

Lifecycle. A settled contract names the winning side.

Available options:

active,

settled_yes,

settled_no,

voided

Example:

"active"

taker_fee_amount

string

required

The taker fee charged at trade time. Nothing further is taken at settlement — a winning share pays the full 1.00.

Example:

"0.17"

taker_fee_refunded

boolean

required

True when the market voided and the fee was returned.

Example:

false

volume

number

required

Shares held.

Example:

100

outcome_labels

string[]

The market’s YES and NO leg names, in that order. Absent on a market using the Yes/No default.

Example:

["Above $77,500", "Below $77,500"]

settled_at

string | null

When the market resolved. Null while the contract is open.

Example:

"2026-08-08T00:00:00Z"

settlement_status

enum<string> | null

The on-chain mint badge: pending until confirmed, reversed if the market voided.

Available options:

pending,

confirmed,

reversed

Example:

"confirmed"

settlement_status_raw

string

The internal state-machine value behind the badge.

Example:

"matched"

Getting Started

Streaming

Endpoints

Models

Your contracts

Authorizations

Query Parameters

Response