Get the zero-fee subsidy status

curl --request GET \
  --url https://api.paxoslabs.com/v1/transit/subsidy \
  --header 'x-api-key: <api-key>'

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

fetch('https://api.paxoslabs.com/v1/transit/subsidy', 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://api.paxoslabs.com/v1/transit/subsidy",
  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;
}

package main

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

func main() {

	url := "https://api.paxoslabs.com/v1/transit/subsidy"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.paxoslabs.com/v1/transit/subsidy")

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

{
  "sourceChainId": 42161,
  "destinationChainId": 42161,
  "offerAsset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
  "wantAsset": "0x004b506865409877c9fa29bfb1eba929984b9bbc",
  "state": "unavailable",
  "observedAt": "2026-10-24T16:00:00Z",
  "reason": "scheduled-closure",
  "closesAt": "2026-10-23T19:00:00Z",
  "allowance": {
    "remainingAmount": "500000000",
    "dailyCapAmount": "1000000000",
    "resetsAt": "2026-10-22T04:00:00Z"
  },
  "expectedReopenAt": "2026-10-26T04:00:00Z"
}

{
  "error": {
    "code": 400,
    "message": "Invalid filter syntax.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.paxoslabs.dev/errors/BadRequest",
        "fieldViolations": [
          {
            "field": "filter",
            "description": "vaultAddress 0x0x is an invalid hex address."
          }
        ]
      }
    ]
  }
}

{
  "error": {
    "code": 400,
    "message": "Invalid filter syntax.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.paxoslabs.dev/errors/BadRequest",
        "fieldViolations": [
          {
            "field": "filter",
            "description": "vaultAddress 0x0x is an invalid hex address."
          }
        ]
      }
    ]
  }
}

{
  "error": {
    "code": 400,
    "message": "Invalid filter syntax.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.paxoslabs.dev/errors/BadRequest",
        "fieldViolations": [
          {
            "field": "filter",
            "description": "vaultAddress 0x0x is an invalid hex address."
          }
        ]
      }
    ]
  }
}

{
  "error": {
    "code": 400,
    "message": "Invalid filter syntax.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.paxoslabs.dev/errors/BadRequest",
        "fieldViolations": [
          {
            "field": "filter",
            "description": "vaultAddress 0x0x is an invalid hex address."
          }
        ]
      }
    ]
  }
}

GET

transit

subsidy

Get the zero-fee subsidy status

curl --request GET \
  --url https://api.paxoslabs.com/v1/transit/subsidy \
  --header 'x-api-key: <api-key>'

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

fetch('https://api.paxoslabs.com/v1/transit/subsidy', 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://api.paxoslabs.com/v1/transit/subsidy",
  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;
}

package main

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

func main() {

	url := "https://api.paxoslabs.com/v1/transit/subsidy"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.paxoslabs.com/v1/transit/subsidy")

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

{
  "sourceChainId": 42161,
  "destinationChainId": 42161,
  "offerAsset": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
  "wantAsset": "0x004b506865409877c9fa29bfb1eba929984b9bbc",
  "state": "unavailable",
  "observedAt": "2026-10-24T16:00:00Z",
  "reason": "scheduled-closure",
  "closesAt": "2026-10-23T19:00:00Z",
  "allowance": {
    "remainingAmount": "500000000",
    "dailyCapAmount": "1000000000",
    "resetsAt": "2026-10-22T04:00:00Z"
  },
  "expectedReopenAt": "2026-10-26T04:00:00Z"
}

{
  "error": {
    "code": 400,
    "message": "Invalid filter syntax.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.paxoslabs.dev/errors/BadRequest",
        "fieldViolations": [
          {
            "field": "filter",
            "description": "vaultAddress 0x0x is an invalid hex address."
          }
        ]
      }
    ]
  }
}

{
  "error": {
    "code": 400,
    "message": "Invalid filter syntax.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.paxoslabs.dev/errors/BadRequest",
        "fieldViolations": [
          {
            "field": "filter",
            "description": "vaultAddress 0x0x is an invalid hex address."
          }
        ]
      }
    ]
  }
}

{
  "error": {
    "code": 400,
    "message": "Invalid filter syntax.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.paxoslabs.dev/errors/BadRequest",
        "fieldViolations": [
          {
            "field": "filter",
            "description": "vaultAddress 0x0x is an invalid hex address."
          }
        ]
      }
    ]
  }
}

{
  "error": {
    "code": 400,
    "message": "Invalid filter syntax.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.paxoslabs.dev/errors/BadRequest",
        "fieldViolations": [
          {
            "field": "filter",
            "description": "vaultAddress 0x0x is an invalid hex address."
          }
        ]
      }
    ]
  }
}

Authorizations

x-api-key

string

header

required

API key in format: pxl_<public_id>_

Query Parameters

distributorCode

string

Optional 32-byte hex code (0x + 64 hex chars) to check the subsidy for. When omitted, uses the organization's default distributor code if one is configured, otherwise the zero hash — the same code an order quote would use. Only your organization's distributor code or the zero hash may be set: any other code is refused with 403, and setting a non-zero code without an API key is refused with 401.

Response

sourceChainId

number

required

EVM chain ID of the source chain of the subsidized route.

Example:

42161

destinationChainId

number

required

EVM chain ID of the destination chain of the subsidized route.

Example:

42161

offerAsset

string

required

Offer asset address on the source chain.

Example:

"0xaf88d065e77c8cc2239327c5edb3a432268e5831"

wantAsset

string

required

Want asset address on the destination chain.

Example:

"0x004b506865409877c9fa29bfb1eba929984b9bbc"

state

enum<string>

required

"available": zero-fee orders can fill now. This does not guarantee capacity for a given order size. "unavailable": zero-fee orders cannot fill; reason says why. "unknown": the status could not be determined right now; treat the subsidy as not guaranteed.

Available options:

available,

unavailable,

unknown

Example:

"unavailable"

observedAt

string

required

When this status was observed (RFC 3339 UTC).

Example:

"2026-10-24T16:00:00Z"

reason

enum<string>

Present when state is "unavailable". "scheduled-closure": closed outside the subsidy schedule (weekends and US market holidays). "not-eligible": the distributor code is not enabled for the subsidy. "temporarily-unavailable": paused. "capacity-exhausted": today's zero-fee limit for this distributor code is used up, including orders that are already waiting to fill.

Available options:

scheduled-closure,

capacity-exhausted,

not-eligible,

temporarily-unavailable

Example:

"scheduled-closure"

closesAt

string | null

Present when state is "available". When the subsidy next closes on its schedule (RFC 3339 UTC); null when no closure is scheduled within the next 14 days.

Example:

"2026-10-23T19:00:00Z"

allowance

object | null

Present when state is "available". The daily zero-fee allowance of the distributor code checked; null when no daily limit applies to it.

Show child attributes

expectedReopenAt

string | null

Present when state is "unavailable". When zero-fee orders are expected to fill again (RFC 3339 UTC); null when no reopening is scheduled. For "capacity-exhausted" this is when the next day's limit starts; if the orders already waiting are larger than a full day's limit, check again then.

Example:

"2026-10-26T04:00:00Z"

⌘I