SDK Introduction

The Orica SDKs provide complete interfaces for interacting with the Orica prediction market protocol on Solana. Available in both TypeScript and Python.

Choose Your SDK

TypeScript SDK

@neko/orica-sdk for Node.js and browser applications.

Python SDK

orica-sdk for Python 3.12+ applications.

Features

Transaction Builders

Build instructions for all on-chain operations: trading, redemption, disputes.

Account Fetching

Fetch and decode market, position, and dispute accounts.

PDA Derivation

Utilities for deriving Program Derived Addresses.

Typed

Full TypeScript types and Python dataclasses for all accounts.

Quick Example

TypeScript
Python

import { OricaSDK } from "@neko/orica-sdk";
import { Connection } from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const sdk = await OricaSDK.createFromChain(connection);

// Fetch all markets
const markets = await sdk.orica.fetchAllMarkets();
for (const { publicKey, account } of markets) {
  console.log(`${account.question} - ${account.status}`);
}

// Fetch user position
const position = await sdk.orica.fetchPosition(marketAddress, userPubkey);
if (position) {
  console.log(`holdings: ${position.outcomeAmounts}`);
}

from orica_sdk import OricaSDK
from solana.rpc.async_api import AsyncClient

async def main():
    connection = AsyncClient("https://api.mainnet-beta.solana.com")
    sdk = await OricaSDK.create(connection)

    # Fetch all markets
    markets = await sdk.orica.fetch_all_markets()
    for address, market in markets:
        print(f"{market.question} - {market.status.value}")

    # Fetch user position
    position = await sdk.orica.fetch_position(market_address, user_pubkey)
    if position:
        print(f"holdings: {position.outcome_amounts}")

SDK Architecture

Both SDKs expose two main clients:

TypeScript
Python

const sdk = await OricaSDK.createFromChain(connection);

sdk.orica     // OricaClient - markets and trading
sdk.disputes  // DisputesClient - dispute resolution

sdk = await OricaSDK.create(connection)

sdk.orica     # OricaClient - markets and trading
sdk.disputes  # DisputesClient - dispute resolution

OricaClient Methods

Category	TypeScript	Python
Protocol	`fetchGlobalState()`	`fetch_global_state()`
Markets	`fetchMarket()`, `fetchAllMarkets()`	`fetch_market()`, `fetch_all_markets()`
Trading	`buildBuy()`, `buildSell()`, `buildRedeem()`	`build_buy()`, `build_sell()`, `build_redeem()`
Positions	`fetchPosition()`, `fetchUserPositions()`	`fetch_position()`
Utilities	`calculatePrices()`	`calculate_prices()`

DisputesClient Methods

Category	TypeScript	Python
Voting	`buildVoteForDispute()`, `fetchDisputeVote()`	`build_vote_for_dispute()`, `fetch_dispute_vote()`
Messages	`buildPostMessage()`, `buildBoostMessage()`	`build_post_message()`, `build_boost_message()`
Disputes	`fetchDispute()`, `fetchAllDisputes()`	`fetch_dispute()`, `fetch_all_disputes()`

Program IDs

Network	Orica Program	Disputes Program
Mainnet	`oEarJ8xDDssLcWwgkSpRVVbmiUyeDnoHFNAHPp6eetw`	`oVEzkDiY2FZP4ADfCeUfrg8jgCoMnPcVQao99indSqN`

Links

Resource	TypeScript	Python
GitHub	orica-ts-sdk	orica-py-sdk
Documentation	neko.github.io/orica-ts-sdk	neko.github.io/orica-py-sdk
Package	NPM	GitHub

Next Steps

Installation

Install the SDK and dependencies.

Configuration

Configure the SDK for your use case.

Markets

Fetch and query market data.

Trading

Execute buy, sell, and redeem operations.

Getting Started

Reading Data

Trading

Disputes

Advanced

SDK Introduction

Choose Your SDK

TypeScript SDK

Python SDK

Features

Transaction Builders

Account Fetching

PDA Derivation

Typed

Quick Example

SDK Architecture

OricaClient Methods

DisputesClient Methods

Program IDs

Links

Next Steps

Installation

Configuration

Markets

Trading

​Choose Your SDK

TypeScript SDK

Python SDK

​Features

Transaction Builders

Account Fetching

PDA Derivation

Typed

​Quick Example

​SDK Architecture

​OricaClient Methods

​DisputesClient Methods

​Program IDs

​Links

​Next Steps

Installation

Configuration

Markets

Trading

Choose Your SDK

Features

Quick Example

SDK Architecture

OricaClient Methods

DisputesClient Methods

Program IDs

Links

Next Steps