Get All Tokens by Market ID

Get all tokens associated with a market with pagination support.

Endpoint: GET /api/v1/integration/tokens/markets/{market_id}/all

Authentication: Required (Bearer token)

Required Headers:

Authorization: Bearer <access_token>
X-Target-Server: integration

Path Parameters

Parameter	Type	Required	Description
market_id	string (UUID)	Yes	Market ID

Query Parameters

Parameter	Type	Required	Description
page	integer	No	Page number (default: 1)
per_page	integer	No	Number of items per page (default: 20)

Response

Status: 200 OK

Returns a paginated list of tokens.

{
    "tokens": [
        {
            "id": "26512436-045c-4c32-bd78-13b7dd9c24f3",
            "node_id": "e40efce4-38a3-46c4-a202-e8db95d0409c",
            "distributor_id": "084a5159-1546-4ade-a7ba-956e0234a417",
            "currency_token_id": "c94c94fc-479d-4d08-bba0-123a210c174c",
            "currency_token": {
                "id": "c94c94fc-479d-4d08-bba0-123a210c174c",
                "name": "Tether USD",
                "symbol": "USDT",
                "decimals": 18,
                "address": "0x1111111111111111111111111111111111111111",
                "chain_id": 1
            },
            "chain_id": 1,
            "name": "My Token",
            "description": "This is a sample token description",
            "symbol": "MTK",
            "value": 100.5,
            "supply": 1000000,
            "external_id": "ext_token_12345",
            "contract": {
                "address": "0x1234567890123456789012345678901234567890",
                "hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
            },
            "rules": {
                "max_purchase_limit": 10000,
                "min_purchase_limit": 100
            },
            "status": 3,
            "integration": {
                "chain_id": 1,
                "abi": "[{\"inputs\":[],\"name\":\"transfer\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}]",
                "contract_address": "0x9876543210987654321098765432109876543210",
                "function_name": "transfer",
                "currency_token_address": "0x1111111111111111111111111111111111111111",
                "is_approved": true,
                "args": [
                    {
                        "type": "address",
                        "value": "0x2222222222222222222222222222222222222222",
                        "description": "Recipient address"
                    },
                    {
                        "type": "uint256",
                        "value": "1000000000000000000",
                        "description": "Amount to transfer"
                    }
                ]
            },
            "meta": {
                "images": [
                    {
                        "id": "656bc0d5-5788-4ee7-a305-57810b175747",
                        "url": "https://fra1.digitaloceanspaces.com/apex/test/token/690f1f5325f3e7e1753791e7/images/7516cfa0-d7f9-47aa-85aa-55aaf20ed934.jpeg",
                        "is_default": true,
                        "hash": "abc123def456",
                        "created_at": "2025-12-24T19:49:21.705259Z"
                    },
                    {
                        "id": "0c78949d-40d8-444a-afe0-4cf030b17555",
                        "url": "https://fra1.digitaloceanspaces.com/apex/test/token/690f1f5325f3e7e1753791e7/images/7516cfa0-d7f9-47aa-85aa-55aaf20ed934.jpeg",
                        "is_default": false,
                        "hash": "def456ghi789",
                        "created_at": "2025-12-24T19:49:21.706884Z"
                    }
                ],
                "documents": [
                    {
                        "id": "e61fd7cf-e030-4279-b4f1-f40bd15deb1e",
                        "name": "Whitepaper",
                        "url": "https://example.com/documents/whitepaper.pdf",
                        "type": 2,
                        "hash": "whitepaper_hash_123",
                        "created_at": "2025-12-24T19:49:21.708384Z"
                    },
                    {
                        "id": "841fd362-df66-4a70-893b-5696aa8f97f7",
                        "name": "Terms of Service",
                        "url": "https://example.com/documents/terms.pdf",
                        "type": 3,
                        "hash": "terms_hash_456",
                        "created_at": "2025-12-24T19:49:21.709724Z"
                    }
                ]
            },
            "seller_address": "0x1234567890123456789012345678901234567890",
            "created_at": "2025-12-24T19:49:21.698837Z",
            "updated_at": "2025-12-24T20:01:46.09493Z"
        }
    ],
    "total": 1,
    "page": 1,
    "per_page": 20
}

Example cURL Request

curl -X GET 'https://<base-url>/api/v1/integration/tokens/markets/262bed05-5a0e-4fff-8171-39fafab66b0c/all?page=1&per_page=20' \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Target-Server: integration"