Docs

Technical documentation, guidelines, and protocol specifications for Medialane.

API Reference

Full REST API reference for the Medialane backend. For SDK usage and integration guides, see the Developers section.

Base URL & Versioning

https://medialane-backend-production.up.railway.app/v1

All endpoints are prefixed with /v1. Breaking changes will be introduced under a new version prefix.

Collections

GET/collectionsList all collections (paginated, sortable)
GET/collections/:contractGet a single collection by contract address
GET/collections/:contract/tokensTokens in a collection (paginated)

Query params for /collections:page,limit,sort (createdAt|totalSupply|floorPrice|totalVolume),owner,isKnown.

Tokens

GET/tokens/:contract/:tokenIdGet a single token with metadata
GET/tokens/owned/:addressAll tokens owned by a wallet address
GET/tokens/:contract/:tokenId/historyTransfer and order history for a token

Orders

GET/ordersList orders (filter by status, sort, currency, collection)
GET/orders/:orderHashGet a single order
GET/orders/user/:addressAll orders for a wallet (buy + sell)
GET/orders/token/:contract/:tokenIdActive orders for a specific token
POST/orders/intent/listingCreate a listing intent (returns typed data to sign)
POST/orders/intent/offerCreate an offer intent (returns typed data to sign)
POST/orders/intent/fulfillCreate a fulfill intent
POST/orders/intent/cancelCreate a cancel intent
POST/orders/signatureSubmit signed intent

Activities

GET/activitiesGlobal activity feed (all event types)
GET/activities/:addressActivity for a specific wallet address

Event types: listing, sale, offer, transfer, cancelled.

Response Format

// List response
{
  "data": [...],
  "meta": { "page": 1, "limit": 20, "total": 142 }
}

// Single item response
{ "id": "...", "chain": "STARKNET", ... }

// Error response
{ "error": "Not found" }

Address Format

All Starknet addresses in requests and responses are normalised to 64-character zero-padded hex with 0x prefix. The SDK handles normalisation automatically; if calling the API directly, ensure addresses are padded correctly.