Partners
API reference
REST endpoints for assets, contracts, partners, KYC, and trading data.
API reference
Base URL (testnet/prod): https://app.uruk.finance/api
SDK surface
| Method | Path | Description |
|---|---|---|
| GET | /sdk/assets?partnerId= | List markets with token address + swap pool |
| GET | /sdk/contracts | Network + contract addresses |
| GET | /sdk/kyc/status/:address | Compliance boolean |
| POST | /sdk/kyc/session | Create KYC session + URLs |
Partners
| Method | Path | Description |
|---|---|---|
| GET | /partners | Active partners |
| GET | /partners/by-owner/:address | Resolve partner for wallet |
| GET | /partners/:id | Partner detail + catalog |
| GET | /partners/:id/catalog | Display catalog + markets |
| PUT | /partners/:id/catalog | { owner, symbols[] }: owner must match |
| GET | /partners/:id/earnings | Pending/total + recent tagged swaps |
Trading data
| Method | Path | Description |
|---|---|---|
| GET | /markets | Synthetic markets |
| GET | /markets/with-prices | Markets with live prices |
| GET | /markets/:symbol | One market |
| GET | /prices/:symbol | Oracle price |
| GET | /pools | All pools (?type=liquidity) |
| GET | /pools/:poolId | Pool + deposits |
| GET | /pools/:poolId/deposits/:depositor | One LP position |
| GET | /swaps | Indexed swaps |
| GET | /swaps/volume/:poolId | Cumulative volume |
| GET | /cdps?owner=&symbol=&open= | Indexed vaults |
| GET | /cdps/:owner/:symbol | One vault |
Governance
| Method | Path | Description |
|---|---|---|
| GET | /proposals | List proposals (?status=&type=) |
| GET | /proposals/:id | Single proposal |
| POST | /proposals | Record an on-chain proposal |
| PATCH | /proposals/:id | Sync status/votes |
| GET | /proposals/:id/votes | Per-voter audit trail |
| POST | /proposals/:id/votes | Record a vote |
| GET | /multisig/wallets | Multi-sig wallets |
| GET | /multisig/transactions/pending | Txs awaiting approval |
| GET | /multisig/transactions/ready | Txs that reached threshold |
Contracts payload example
GET /sdk/contracts returns the live deployment per network (see Contract addresses):
{
"network": "testnet",
"contracts": {
"liquidityPool": "C...",
"syntheticEngine": "C...",
"stabilityPool": "C...",
"compliance": "C...",
"partnerRegistry": "C...",
"earnings": "C...",
"dao": "C...",
"oracle": "C...",
"usdc": "G..."
},
"appUrl": "https://app-testnet.uruk.finance",
"docsUrl": "https://docs.uruk.finance"
}