Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

River Markets generic-assets API

The generic-assets API from River Markets — 3 operation(s) for generic-assets.

River Markets generic-assets API is one of 13 APIs that River Markets publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include generic-assets. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

This API exposes 7 operations across 3 paths, and defines 11 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://api.rivermarkets.com.

7 operations 3 paths 11 schemas 2 DELETE2 GET1 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.rivermarkets.com
Authentication
API Key, API Key, API Key, HTTP Bearer
License
Proprietary
Resource Areas
1

Authentication & Security 4

River Markets generic-assets API declares 4 security schemes for authenticating requests. An API key is passed in the header as X-River-Key-Id (SignedRequestKeyId). An API key is passed in the header as X-River-Timestamp (SignedRequestTimestamp). An API key is passed in the header as X-River-Signature (SignedRequestSignature). It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

  • SignedRequestKeyId — UUID of your API key (from Settings → API Keys).
  • SignedRequestTimestamp — Current unix seconds. Must be within 30s of server time.
  • SignedRequestSignature — Base64 Ed25519 signature over the canonical request: METHOD\nPATH\nSORTEDQUERY\nTIMESTAMP\nSHA256(body) hex. See /api-reference/authentication for the full rec…
  • BearerAuth — JWT bearer token for web client authentication.

Paths & Operations 7

Across 3 paths, the API surfaces 7 operations — 2 DELETE, 2 GET, 1 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

generic-assets 7
GET
/v1/generic-assets
List Generic Assets
list_generic_assets_v1_generic_assets_get 3 params → 200422
POST
/v1/generic-assets
Create Generic Asset
create_generic_asset_v1_generic_assets_post body → 201422
GET
/v1/generic-assets/{generic_asset_id}
Get Generic Asset
get_generic_asset_v1_generic_assets__generic_asset_id__get 1 param → 200422
PATCH
/v1/generic-assets/{generic_asset_id}
Update Generic Asset
update_generic_asset_v1_generic_assets__generic_asset_id__patch 1 param body → 200422
DELETE
/v1/generic-assets/{generic_asset_id}
Delete Generic Asset
delete_generic_asset_v1_generic_assets__generic_asset_id__delete 1 param → 204422
POST
/v1/generic-assets/{generic_asset_id}/members
Add Generic Asset Members
add_generic_asset_members_v1_generic_assets__generic_asset_id__members_post 1 param body → 204422
DELETE
/v1/generic-assets/{generic_asset_id}/members
Remove Generic Asset Members
remove_generic_asset_members_v1_generic_assets__generic_asset_id__members_delete 1 param body → 204422

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are MarketSearchResult (31 properties), GenericAssetDetailResponse (10 properties), GenericAssetResponse (10 properties), ValidationError (5 properties). Each schema is shown below with its type and property counts.

GenericAssetUpdate
object
Request schema for updating a user-owned generic asset.
2 properties
GenericAssetMemberAdd
object
Request schema for adding members to a user-owned generic asset.
1 property 1 required
GenericAssetMemberRemove
object
Request schema for removing members from a user-owned generic asset.
1 property 1 required
GenericAssetCreate
object
Request schema for creating a new user-owned generic asset (basket).
4 properties 2 required
GenericAssetDetailResponse
object
Response schema for a generic asset with its resolved members (detail view).
10 properties 4 required
GenericAssetListResponse
object
1 property 1 required
GenericAssetResponse
object
A tradeable generic asset (platform-curated or user-owned) with its member riverids.
10 properties 4 required
ValidationError
object
5 properties 3 required
InstrumentStatus
string
Instrument status derived in instruments table from exchange-specific fields. Kalshi: maps from kalshimarkets.status - 'active' - ACTIVE - everything else (clo…
MarketSearchResult
object
Schema for a single market search result.
31 properties 9 required
HTTPValidationError
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

river-markets-generic-assets-api-openapi.yml Raw ↑

Other APIs River Markets publishes across the network.

River Markets balance API
River Markets complex-orders API
River Markets fair-values API
River Markets fills API
River Markets markets API
River Markets orderbooks API
River Markets orders API
River Markets positions API
River Markets prices API
River Markets subaccounts API
River Markets tradeprints API
River Markets watchlists API