Skip to main content
The Chains API lets you query the blockchain networks that ProofBridge supports. Each chain record includes the network’s chain ID, its chain family (EVM or STELLAR), and the addresses of the deployed AdManager and OrderPortal smart contracts. Use these contract addresses when constructing transactions from the data returned by the Ads and Trades endpoints. These endpoints are public — no authentication required.
Chain and token registration is handled through an internal admin API and is not documented here. Contact the ProofBridge team to request support for a new network.

​
GET /v1/chains

List all supported chains. Supports optional filtering by name or chain ID, and cursor-based pagination.

​
Query parameters

​
name
string
Filter by chain name. Partial matches are not guaranteed — use the exact name (e.g., "Ethereum Mainnet").
​
chainId
string
Filter by the numeric chain ID as a string (e.g., "11155111" for Ethereum Sepolia, "1000001" for Stellar Testnet).
​
cursor
string
Pagination cursor from a previous response’s nextCursor field.
​
limit
number
default:"25"
Number of results per page. Between 1 and 100.

​
Response fields

​
data
Chain[]
required
Array of chain objects. See Chain object fields below.
​
nextCursor
string | null
required
Cursor for the next page. null when you have reached the last page.
{
  "data": [
    {
      "name": "Ethereum Sepolia",
      "chainId": "11155111",
      "kind": "EVM",
      "adManagerAddress": "0xC3D4E5F60718293A4B5C6D7E8F9012345678ABC3",
      "orderPortalAddress": "0xD4E5F60718293A4B5C6D7E8F9012345678ABCD4E",
      "createdAt": "2026-01-10T00:00:00.000Z",
      "updatedAt": "2026-01-10T00:00:00.000Z"
    },
    {
      "name": "Stellar Testnet",
      "chainId": "1000001",
      "kind": "STELLAR",
      "adManagerAddress": "CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "orderPortalAddress": "CAYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY",
      "createdAt": "2026-01-10T00:00:00.000Z",
      "updatedAt": "2026-01-10T00:00:00.000Z"
    }
  ],
  "nextCursor": null
}

​
GET /v1/chains/:chainId

Retrieve details for a single chain by its numeric chain ID.

​
Path parameters

​
chainId
string
required
The numeric chain ID of the network to retrieve (e.g., "11155111" for Ethereum Sepolia). Do not use the internal UUID — use the public chain ID.
Returns a single Chain object. 
{
  "name": "Ethereum Sepolia",
  "chainId": "11155111",
  "kind": "EVM",
  "adManagerAddress": "0xC3D4E5F60718293A4B5C6D7E8F9012345678ABC3",
  "orderPortalAddress": "0xD4E5F60718293A4B5C6D7E8F9012345678ABCD4E",
  "createdAt": "2026-01-10T00:00:00.000Z",
  "updatedAt": "2026-01-10T00:00:00.000Z"
}

​
Chain object fields

​
name
string
required
Human-readable name of the network (e.g., "Ethereum Sepolia", "Stellar Testnet").
​
chainId
string
required
Numeric chain ID as a string. Use this value in the adChainId and orderChainId query parameters of other endpoints.
​
kind
string
required
Chain family: "EVM" for Ethereum-compatible chains, or "STELLAR" for Stellar-based networks.
​
adManagerAddress
string
required
Address of the AdManager smart contract deployed on this chain. Makers submit ad creation, funding, and closure transactions to this contract.
​
orderPortalAddress
string
required
Address of the OrderPortal smart contract deployed on this chain. Bridgers submit deposit transactions to this contract.
​
createdAt
string
required
ISO 8601 timestamp of when this chain was registered.
​
updatedAt
string
required
ISO 8601 timestamp of the last update to this chain record.