Installation

TypeScript SDK

Install the SDK and required peer dependencies:

bun add @neko/orica-sdk @solana/web3.js @coral-xyz/anchor

npm install @neko/orica-sdk @solana/web3.js @coral-xyz/anchor

yarn add @neko/orica-sdk @solana/web3.js @coral-xyz/anchor

pnpm add @neko/orica-sdk @solana/web3.js @coral-xyz/anchor

TypeScript Dependencies

Package	Purpose
`@neko/orica-sdk`	Orica SDK
`@solana/web3.js`	Solana JavaScript API
`@coral-xyz/anchor`	Anchor framework for Solana

For trading operations, you may also need:

bun add @solana/spl-token

Node Version

Requires Node.js 18 or higher.

Python SDK

Install directly from GitHub:

uv add git+https://github.com/neko/orica-py-sdk

pip install git+https://github.com/neko/orica-py-sdk

Or clone and install locally:

git clone https://github.com/neko/orica-py-sdk
cd orica-py-sdk
uv pip install -e .

Python Requirements

Python 3.12+
uv for package management (recommended)

Install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

Python Dependencies

Package	Purpose
`anchorpy`	Anchor framework for Python
`solders`	Solana data structures
`solana`	Solana Python SDK
`httpx`	HTTP client

TypeScript Configuration

Recommended tsconfig.json settings:

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "esModuleInterop": true,
    "strict": true
  }
}

Verifying Installation

TypeScript
Python

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

async function test() {
  const connection = new Connection("https://api.mainnet-beta.solana.com");
  const sdk = await OricaSDK.createFromChain(connection);
  
  console.log("SDK initialized successfully");
  
  const globalState = await sdk.orica.fetchGlobalState();
  console.log("Market count:", globalState.marketCount.toString());
}

test().catch(console.error);

Run with:

bun run test.ts

npx ts-node test.ts

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

async def test():
    connection = AsyncClient("https://api.mainnet-beta.solana.com")
    sdk = await OricaSDK.create(connection)
    
    print("SDK initialized successfully")
    
    global_state = await sdk.orica.fetch_global_state()
    print(f"Market count: {global_state.market_count}")

asyncio.run(test())

Run with:

uv run test.py

Getting Started

Reading Data

Trading

Disputes

Advanced

Installation

TypeScript SDK

TypeScript Dependencies

Node Version

Python SDK

Python Requirements

Python Dependencies

TypeScript Configuration

Verifying Installation

Links

Next Steps

Configuration

Markets

​TypeScript SDK

​TypeScript Dependencies

​Node Version

​Python SDK

​Python Requirements

​Python Dependencies

​TypeScript Configuration

​Verifying Installation

​Links

​Next Steps

Configuration

Markets

TypeScript SDK

TypeScript Dependencies

Node Version

Python SDK

Python Requirements

Python Dependencies

TypeScript Configuration

Verifying Installation

Links

Next Steps